HookCallback()¶
FUNKTION¶
mixed HookCallback(object hooksource, int hookid, mixed hookdata)
DEFINIERT IN¶
Eigenen Objekten
ARGUMENTE¶
- hooksource: Das Objekt, in dem das Ereignis ausgeloest wurde
- hookid: Hooktyp des ausgeloesten Hooks
- hookdata: Daten des ausgeloesten Hooks (S. Doku des jeweiligen Hooks.)
BESCHREIBUNG¶
Standard-Callback-Methode fuer Hooks. Wird beim Registrieren ein Objekt uebergeben, wird versucht, eine Closure auf HookCallback() an diesem Objekt zu erstellen. Man kann die Funktion auch anders benennen und direkt als Closure uebergeben. Dies ist insb. bei mehreren Hooks im gleichen Objekt hilfreich, weil es den Code uebersichtlicher macht. Die Argumente muessen jedoch immer die gleichen wie bei HookCallback() sein.
Die Reihenfolge des Aufrufs der Konsumenten ist Surveyor, Hook-Modifikator, Data-Modifikator, Listener. Innerhalb der Gruppen wird nach Prioritaet abgearbeitet. Ein Surveyor-Hook kann verhindern, dass Hooks bestimmte Aenderungen durchfuehren.
RUECKGABEWERTE¶
({<status>, <hookdata>})
Status: Eine der folgenden Konstanten: - H_NO_MOD: keine Veraenderung - H_ALTERED: Daten des Hooks geaendert - H_CANCELLED: Die Ausfuehrung der Hook-Kette und das ausloesende
Ereignis werden abgebrochen
Nicht alle Hooks unterstuetzen jeden Status.
hookdata: Die ggf. modifizierten Hookdaten. (S. Doku des jeweiligen Hooks.)
BEMERKUNGEN¶
Bitte nutzt in neuem code nicht mixed, sondern unions entsprechend der Dokumentation der verwendeten Hooks.
Auch reine Listener-Objekte muesse nein Array zurueckgeben, dessen erstes Element H_NO_MOD sein muss.