4D v16

4D Widget Komponenten

Home

 
4D v16
4D Widget Komponenten

4D Widget Komponenten  


 

 

4D Widgets sind Funktionalitäten in Form von Komponenten, die über den Formulareditor bzw. die vorkonfigurierte Objektbibliothek zugänglich sind. Diese Widgets sind komplexe Objekte mit vordefinierten Merkmalen, die Zugriff auf Standardfunktionalitäten bieten und sich leicht integrieren lassen.

Drei Widgets sind verfügbar:

  • SearchPicker: Suchbereich mit Standarddarststellung
  • DatePicker: Selector für Datum
  • TimePicker: Selector für Zeit

Sie sind mit oder ohne Programmierung verwendbar. Sie können sie mühelos in Ihre Formulare integrieren und mit ihren Standardeigenschaften verwenden. Wollen Sie die Widgets nach eigenen Vorstellungen steuern und konfigurieren, können Sie spezifische Projektmethoden, genannt "Komponent-Methoden"  verwenden. Sie erscheinen im Explorer auf der Seite Methoden und sind nach Komponente sortiert:

Diese Dokumentation beschreibt die Widgets und die Syntax der dazugehörigen Komponent-Methoden.

 Es gibt zwei Möglichkeiten, ein Widget Bereich in ein Formular einzufügen:

  • Über die Objektbibliothek
  • Über ein Unterformular

Um ein Widget über die Objektbibliothek einzufügen:

  1. Wählen Sie im Menü Design den Befehl Objektbibliothek.
    Auf dem Bildschirm erscheint das Dialogfenster Objektbibliothek.
  2. Wählen Sie im DropDown-Menü Kategorie den Eintrag Widgets.
    Alle verfügbaren Widgets werden aufgelistet:


  3. Fügen Sie das gewünschte Widget per Drag-and-Drop in Ihr Formular ein.
    Sie können es dann über die Eigenschaften des eingefügten Objekts bzw. über seine Objektmethode konfigurieren.

Um ein Widget über ein Objekt vom Typ Unterformular einzufügen:

  1. Fügen Sie im Formulareditor ein Objekt Unterformular hinzu.
    Weitere Informationen dazu finden Sie im Handbuch 4D Designmodus.
  2. Klicken Sie in der Eigenschaftenliste auf das Menü "Detail Formular", um durch die Liste der verwendbaren Formulare zu scrollen. Diese Liste enthält auch die Widgets.


  3. Wählen Sie das gewünschte Widget.
    Sie können es dann über die Objekteigenschaften oder die Objektmethode des Unterformulars konfigurieren.

Da Widgets auf 4D Unterformularen basieren, gelten hierfür dieselben Prinzipien wie für Unterformulare. Beachten Sie insbesondere die Initialisierung.

Aus Optimierungsgründen führt 4D Unterformularobjekte nur aus (Instanzierung), wenn das Unterformular angezeigt wird, d.h. Methodenaufrufe über EXECUTE METHOD IN SUBFORM oder Zugriff auf dynamische Objekte in Unterformularen ist erst möglich, wenn das Unterformular auf der aktuellen Seite angezeigt wird.

Setzen Sie Widgets auf andere Formularseiten als Seite 1, lässt sich keine Initialisierungsmethode (wie TimePicker SET STEP) im Formularereignis On Load aufrufen, da das Widget zum Zeitpunkt der Methodenausführung nicht instanziert ist.

Um das zu verwalten, geben Widget-Bereiche ein spezifisches Ereignis mit dem Wert -1 zurück, um anzuzeigen, dass sie geladen und einsatzbereit sind. Dieses Ereignis muss auf der Ebene der Objektmethode des Widgets selbst getestet werden, und zwar genauso wie die Konstanten On Data ChangeOn Load etc. Liegt das Widget nicht auf Seite 1 des Formulars, müssen Sie folgenden Code schreiben:

 If(Form event=-1) // Das Widget ist instanziert und kann initialisiert werden
    TimePicker SET STEP("myTimePicker";? 00:10:00?) // Beispiel
 End if

und nicht:

 If(Form event=On Load// Funktioniert nur, wenn das Widget auf Seite 1 liegt
    TimePicker SET STEP("myTimePicker";? 00:10:00?)
 End if

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D Widget Komponenten

 
GESCHICHTE 

 
ARTIKELVERWENDUNG

4D Widgets ( 4D v16)