doc/lfun/obsolete/AddInsertHook

********************* 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