4D Doc Center : OBJECT SET EVENTS

Home

4D v14.3

OBJECT SET EVENTS


OBJECT SET EVENTS ( {* ;} Objekt ; arrEreignisse ; Modus )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Feld oder Variable
Objekt	Formularobjekt	Objektname oder "" für Formular (mit ) oder Feld bzw. Variable (ohne )
arrEreignisse	Array Lange Ganzzahl	Array der Ereignisse zum Setzen
Modus	Lange Ganzzahl	Aktivierungsmodus für Ereignisse, definiert in arrEreignisse

Beschreibung

Der Befehl OBJECT SET EVENTS ändert für den aktuellen Prozess die Konfiguration von Formularereignissen des Formulars oder Objekts, definiert über die Parameter Objekt und *.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt ein Feld oder eine Variable. In diesem Fall übergeben Sie eine Feld- oder Variablenreferenz anstelle eines String (nur Feld oder Variablenobjekt).
Um die Einstellung der Ereignisse für das Formular selbst zu definieren, übergeben Sie in Objekt den optionalen Parameter * und einen leeren String "": So bestimmen Sie das aktuelle Formular.

Hinweis: Wollen Sie die Ereignisse eines Unterformulars zu einer Tabelle ändern, können Sie die Syntax verwenden, die auf dem Objektnamen basiert.

Im Parameter arrEreignisse übergeben Sie ein Array Lange Ganzzahl mit der Liste der vordefinierten oder eigenen Formularereignisse, die Sie ändern wollen. Mit dem Parameter Modus können Sie Aktivieren oder Deaktivieren der Ereignisse angeben.
Um ein vordefiniertes Ereignis zum Ändern zu bestimmen, können Sie in jedem Element des Array arrEreignisse eine der folgenden Konstanten unter dem Thema Formularereignisse:

Konstante	Typ	Wert	Meldung
On Activate	Lange Ganzzahl	11	Das Formularfenster wird zum vordersten Fenster.
On After Edit	Lange Ganzzahl	45	Der Inhalt des eingebbaren Objekts mit Fokus wurde gerade geändert.
On After Keystroke	Lange Ganzzahl	28	Ein Zeichen wird gerade in das Objekt mit Fokus eingegeben. Get edited text gibt den Text im Objekt inkl. diesem Zeichen zurück
On After Sort	Lange Ganzzahl	30	(nur Listbox) In einer Spalte der Listbox wurde gerade eine Standard-Sortierung ausgeführt.
On Arrow Click	Lange Ganzzahl	38	(nur 3D buttons) Der Pfeilbereich einer 3D Schaltfläche ist angeklickt
On Before Data Entry	Lange Ganzzahl	41	(nur Listbox) Eine Zelle der Listbox wechselt gerade in den Editiermodus
On Before Keystroke	Lange Ganzzahl	17	Ein Zeichen wird gerade in das Objekt mit Fokus eingegeben. Get edited text gibt den Text im Objekt ohne dieses Zeichen zurück.
On Begin Drag Over	Lange Ganzzahl	46	Ein Objekt wird gerade bewegt (Drag)
On Begin URL Loading	Lange Ganzzahl	47	(nur Web Areas) Eine neue URL wird in den Webbereich geladen.
On bound variable change	Lange Ganzzahl	54	Die dem Unterformular zugewiesene Variable wird geändert.
On Clicked	Lange Ganzzahl	4	Das Objekt wurde angeklickt.
On Close Box	Lange Ganzzahl	22	Die Schließbox des Fensters wurde angeklickt.
On Close Detail	Lange Ganzzahl	26	Sie haben das Eingabeformular verlassen und gehen zurück zum Ausgabeformular.
On Collapse	Lange Ganzzahl	44	(hierarchische Listen und hierarchische Listboxen) Ein Element der hierarchischen Liste bzw. Listbox wurde über Mausklick oder Tastenanschlag zugeklappt.
On Column Moved	Lange Ganzzahl	32	(nur Listbox) Der Benutzer hat eine Spalte der Listbox per Drag and Drop bewegt.
On Column Resize	Lange Ganzzahl	33	(nur Listbox) Die Breite einer Spalte der Listbox wurde geändert.
On Data Change	Lange Ganzzahl	20	Daten im Objekt wurden geändert.
On Deactivate	Lange Ganzzahl	12	Das Formularfenster ist nicht mehr das vorderste Fenster.
On Delete Action	Lange Ganzzahl	58	(nur hierarchische Listen und Listboxen) Ein Benutzer möchte ein Element löschen
On Display Detail	Lange Ganzzahl	8	Ein Datensatz wird gleich in einer Liste bzw. eine Zeile in einer Listbox angezeigt.
On Double Clicked	Lange Ganzzahl	13	Auf ein Objekt wurde ein Doppelklick ausgeführt.
On Drag Over	Lange Ganzzahl	21	Daten werden in ein Objekt gezogen.
On Drop	Lange Ganzzahl	16	Daten werden in ein Objekt gezogen.
On End URL Loading	Lange Ganzzahl	49	(nur Web Areas) Alle Ressourcen des URL wurden geladen.
On Expand	Lange Ganzzahl	43	(hierarchische Listen und hierarchische Listboxen) Ein Element der hierarchischen Liste bzw. Listbox wurde per Mausklick oder Tastenanschlag aufgeklappt.
On Footer Click	Lange Ganzzahl	57	(nur Listboxen) Der Fußteil einer Listbox oder einer Spalte der Listbox ist angeklickt
On Getting Focus	Lange Ganzzahl	15	Ein Formularobjekt erhält den Fokus.
On Header	Lange Ganzzahl	5	Der Kopfteil des Formulars wird gleich gedruckt oder angezeigt.
On Header Click	Lange Ganzzahl	42	(nur Listbox) Ein Spaltentitel der Listbox wird angeklickt.
On Load Record	Lange Ganzzahl	40	Bei der Eingabe in die Liste, wird ein Datensatz während der Änderung geladen (Der Benutzer klickt auf eine Zeile im Datensatz und ein Feld wechselt in den Editiermodus).
On Long Click	Lange Ganzzahl	39	(nur 3D buttons) Eine 3D Schaltfläche wird angeklickt und die Maustaste bleibt für eine gewisse Zeit gedrückt.
On Losing Focus	Lange Ganzzahl	14	Ein Formularobjekt verliert den Fokus.
On Mac toolbar button	Lange Ganzzahl	55	Der Benutzer klickt auf die Schaltfläche Toolbar Management unter Mac OS.
On Menu Selected	Lange Ganzzahl	18	Ein Menüeintrag wurde ausgewählt.
On Mouse Enter	Lange Ganzzahl	35	Der Mauszeiger geht in den grafischen Bereich eines Objekts.
On Mouse Leave	Lange Ganzzahl	36	Der Mauszeiger verlässt den grafischen Bereich eines Objekts.
On Mouse Move	Lange Ganzzahl	37	Der Mauszeiger bewegt sich (mindestens 1 Pixel) ODER eine Modifier-Taste (Shift, Alt, Shift Lock) wurde gedrückt. Wurde das Ereignis nur für ein Objekt markiert, wird es nur generiert, wenn der Cursor im grafischen Bereich eines Objekts liegt.
On Open Detail	Lange Ganzzahl	25	Ein dem Ausgabeformular oder der Listbox zugeordnetes Eingabeformular wird gerade geöffnet.
On Open External Link	Lange Ganzzahl	52	(nur Web Areas) Im Browser wurde eine externe URL geöffnet.
On Outside Call	Lange Ganzzahl	10	Das Formular hat einen Aufruf CALL PROCESS erhalten.
On Picture Scroll	Lange Ganzzahl	59	Der Benutzer scrollt den Inhalt eines Feldes vom Typ Bild oder Variable mit der Maus oder Tastatur.
On Plug in Area	Lange Ganzzahl	19	Ein externes Objekt hat angefragt, seine Objektmethode auszuführen.
On Printing Break	Lange Ganzzahl	6	Ein Umbruchbereich im Formular wird gleich gedruckt.
On Printing Detail	Lange Ganzzahl	23	Der Detailbereich des Formulars wird gleich gedruckt.
On Printing Footer	Lange Ganzzahl	7	Der Fußteil des Formulars wird gleich gedruckt.
On Resize	Lange Ganzzahl	29	Das Formularfenster wird angepasst.
On Row Moved	Lange Ganzzahl	34	(nur Listbox) Der Benutzer hat eine Zeile der Listbox per Drag-and-Drop bewegt.
On Selection Change	Lange Ganzzahl	31	Listbox: Die aktuelle Auswahl der Zeilen oder Spalten wurde geändert. Datensätze in Liste: Der aktuelle Datensatz oder die aktuelle Auswahl der Zeilen in einem Listen- bzw. Unterformular wurde geändert. Hierarchische Liste: Die Auswahl in der Liste wurde nach einem Mausklick oder Tastenanschlag geändert. Eingebbares Feld oder Variable: Die Textauswahl oder Position des Cursors im Bereich wurde nach einem Mausklick oder Tastenanschlag geändert.
On Timer	Lange Ganzzahl	27	Die Anzahl der durch SET TIMER definierten Ticks wurde überschritten.
On Unload	Lange Ganzzahl	24	Das Formular wird gerade verlassen oder erneuert.
On URL Filtering	Lange Ganzzahl	51	(nur Web Areas) Der Web Bereich hat eine URL geblockt.
On URL Loading Error	Lange Ganzzahl	50	(nur Web Areas) Beim Laden der URL ist ein Fehler aufgetreten.
On URL Resource Loading	Lange Ganzzahl	48	(nur Web Areas) Eine neue Ressource wird in den Web Bereich geladen.
On Validate	Lange Ganzzahl	3	Die Eingabe in den Datensatz wurde bestätigt.
On Window Opening Denied	Lange Ganzzahl	53	(nur Web Areas) Ein PopUp-Fenster wurde blockiert.

Bitte beachten Sie, dass das Ereignis On Load in dieser Liste nicht enthalten ist: Dieses Ereignis lässt sich nicht definieren, da es bereits während der Ausführung des Befehls generiert wurde.

In arrEreignisse können Sie auch einen Wert für ein eigenes Ereignis übergeben. Wir empfehlen dafür, negative Werte zu verwenden. Weitere Informationen dazu finden Sie unter dem Befehl CALL SUBFORM CONTAINER.

Im Parameter Modus setzen Sie die generelle Handhabung für Array Elemente. Dazu können Sie eine der folgenden Konstanten unter dem Thema Formularobjekte (Eigenschaften) verwenden:

Konstante	Typ	Wert	Meldung
Disable events others unchanged	Lange Ganzzahl	2	Alle im arrEreignisse aufgeführten Ereignisse werden deaktiviert; der Status anderer Ereignisse bleibt unverändert
Enable events disable others	Lange Ganzzahl	0	Alle im arrEreignisse aufgeführten Ereignisse werden aktiviert; alle anderen werden deaktiviert
Enable events others unchanged	Lange Ganzzahl	1	Alle im arrEreignisse aufgeführten Ereignisse werden aktiviert; der Status anderer Ereignisse bleibt unverändert

Der Befehl OBJECT SET EVENTS kann u.U. Ereignisse aktivieren, die Objekt (abhängig vom Typ) nicht unterstützt. In diesem Fall werden die Ereignisse einfach ignoriert.

Wird ein Objekt nach Aufrufen von OBJECT SET EVENTS dupliziert, wird auch die daraus resultierende Konfiguration aktiviert/deaktiviert dupliziert.

Beispiel 1

Für einen Satz Listboxobjekte drei Formularereignisse aktivieren und die anderen deaktivieren:

 ARRAY LONGINT($MyEventsOnLB;3)

 $MyEventsOnLB {1}:=On After Sort

 $MyEventsOnLB {2}:=On Column Moved

 $MyEventsOnLB {3}:=On Column Resize

 OBJECT SET EVENTS(*;"MyLB@";$MyEventsOnLB;Enable events disable others)

  // aktiviert 3 Ereignisse und deaktiviert alle anderen

Beispiel 2

Für einen Satz Listboxobjekte drei Formularereignisse deaktivieren, ohne die anderen zu verändern:

 ARRAY LONGINT($MyEventsOnLB;3)

 $MyEventsOnLB {1}:=On After Sort

 $MyEventsOnLB {2}:=On Column Moved

 $MyEventsOnLB {3}:=On Column Resize

 OBJECT SET EVENTS(*;"MyLB@";$MyEventsOnLB;Disable events others unchanged)

  // deaktiviert nur diese 3 Ereignisse

Beispiel 3

Ein Formularereignis für ein Objekt aktivieren, ohne die anderen zu verändern:

 ARRAY LONGINT($MyEventsOnLB;1)

 $MyEventsOnLB {1}:=On Column Moved

 OBJECT SET EVENTS(*;"Col1";$MyEventsOnLB;Enable events others unchanged)

  // aktiviert nur dieses Ereignis

Beispiel 4

Alle Ereignisse des Formulars deaktivieren:

 ARRAY LONGINT($MyFormEvents;0)

 OBJECT SET EVENTS(*;"";$MyFormEvents;Enable events disable others)

  // deaktiviert alle Ereignisse

Beispiel 5

Deaktiviert ein einzelnes Ereignis des Formulars, ohne die anderen zu verändern:

 ARRAY LONGINT($MyFormEvents;1)

 $MyFormEvents{1}:=On Timer

 OBJECT SET EVENTS(*;"";$MyFormEvents;Disable events others unchanged)

  // deaktiviert nur dieses Ereignis