
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