| ********************* OBSOLETE LFUN *********************************** |
| * Diese Efun bitte nicht mehr benutzen, sondern stattdessen die * |
| * Hooks (s. /doc/std/hooks). * |
| *********************************************************************** |
| AddInsertHook() |
| |
| FUNKTION: |
| void AddInsertHook(object ob); |
| |
| DEFINIERT IN: |
| /std/player/restrictions.c |
| |
| ARGUMENTE: |
| ob - Das Objekt, das informiert werden soll, wenn ein Objekt dem |
| Spielerinventar hinzugefuegt wurde. |
| |
| BESCHREIBUNG: |
| (Diese Funktionalitaet wurde ersetzt durch den allgemeinen Hook |
| H_HOOK_INSERT und ist nur noch aus Gruenden der Kompatibilitaet |
| vorhanden.) |
| |
| Diese Funktion wird im Spielerobjekt aufgerufen, um das Objekt ob als |
| Hook-Listener anzumelden. Auf diese Weise eingetragene Listener |
| werden informiert, wenn ein Objekt ins Spielerinventar bewegt wurde. |
| Technisch wird die Bewegung ueber NotifyInsert() im Spielerobjekt |
| detektiert, und im Listener-Objekt wird die Funktion InsertNotify() |
| gerufen, die als Parameter das neu ins Spielerinventar bewegte Objekt |
| uebergeben bekommt. |
| |
| RUeCKGABEWERT: |
| keiner |
| |
| BEMERKUNGEN: |
| Das Listener-Objekt muss sich ebenfalls im Spielerinventar befinden, |
| ansonsten wird der eingetragene Hook wieder geloescht. |
| |
| BEISPIEL: |
| |
| a) Objekt "ob" wird im Spieler als Listener angemeldet: |
| this_player()->AddInsertHook(ob); |
| |
| b) Objekt "new" wird ins Spielerinventar bewegt, das Spielerobjekt |
| informiert "ob" darueber: |
| ob->InsertNotify(new); |
| |
| c) Das Listener-Objekt "ob" reagiert darauf, z.B. indem es die Fackel |
| loescht, sofern sie vorher brannte: |
| void InsertNotify(object new) { |
| if ( objectp(new) && new->id("\nfackel") && |
| new->QueryProp(P_LIGHTED) ) |
| new->unlight(); |
| return; |
| } |
| |
| SIEHE AUCH: |
| NotifyInsert(), RemoveInsertHook(), QueryInsertHooks() |
| |
| ---------------------------------------------------------------------------- |
| Last modified: 14.04.2010, Arathorn |