4D v16.3

OBJECT SET EVENTS

Home

 
4D v16.3
OBJECT SET EVENTS

OBJECT SET EVENTS 


 

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

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 Kommentar
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) Der Benutzer hat die Breite einer Spalte der Listbox mit der Maus 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 Kommentar
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.

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

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

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

Alle Ereignisse des Formulars deaktivieren:

 ARRAY LONGINT($MyFormEvents;0)
 OBJECT SET EVENTS(*;"";$MyFormEvents;Enable events disable others)
  // deaktiviert alle Ereignisse

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



Siehe auch 

Formularereignisse
OBJECT GET EVENTS

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Objekte (Formulare)
Nummer: 1239

 
GESCHICHTE 

Erstellt: 4D v14

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)