FORM GET NAMES

Home

4D v16.3

FORM GET NAMES


FORM GET NAMES ( {Tabellenname ;} arrNamen {; Filter {; Marker}}{; *} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Referenz der Tabelle
arrNamen	Array Text	Array der Formularnamen
Filter	Text	Filter für Namen
Marker	Lange Ganzzahl	Marker für zurückzugebende Mindestversion
		Neuer Wert
*	Operator	Mit Stern: Befehl gilt für Host Datenbanken, wenn er von einer Komponente ausgeführt wird. (außerhalb dieses Kontexts wird der Parameter ignoriert.)

Beschreibung

Der Befehl FORM GET NAMES füllt das Array arrNamen mit den Namen der Formulare in der Anwendung.
Übergeben Sie den Parameter Tabellenname, gibt der Befehl die Namen der Tabellenformulare zurück, die dieser Tabelle zugewiesen sind. Lassen Sie diesen Parameter weg, gibt er die Namen der Projektformulare der Datenbank zurück.

Sie können die Liste der Formulare einschränken, wenn Sie im Parameter Filter einen Vergleichs-String übergeben: In diesem Fall werden nur die Formulare zurückgegeben, deren Namen zum Filter passen. Sie können das Zeichen @ verwenden, um Filter vom Typ "beginnt mit", "endet mit" oder "enthält" zu übergeben. Übergeben Sie einen leeren String, wird der Parameter Filter ignoriert.

Sie können die Liste der Formulare auch über den optionalen Parameter Marker einschränken. Damit lassen sich in arrNamen zurückgegebene Formulare beschränken auf Formulare, die in einem bestimmten Zeitraum geändert wurden. Als Teil eines Systems zu Versionskontrolle ermöglicht dieser Parameter, nur Formulare zu aktualisieren, die seit dem letzten Backup geändert wurden.
Es funktioniert folgendermaßen: 4D führt intern einen Zähler der Änderungen der Datenbank-Ressourcen. Da Formulare Ressourcen sind, erhöht sich der Zähler bei jedem Erstellen oder Sichern eines Formulars.

Übergeben Sie den Parameter Marker, gibt der Befehl in arrNamen nur Formulare zurück, deren interner Marker größer oder gleich dem Wert von Marker ist. Übergeben Sie zusätzlich eine Variable in Marker, gibt der Befehl den neuen Wert des Zählers für Änderungen zurück, z.B. den höchsten in dieser Variable. Sie können diesen Wert dann sichern und im nächsten Aufruf des Befehls FORM GET NAMES verwenden, um nur neue oder geänderte Formulare wiederzufinden.

Wird der Befehl in einer Komponente ausgeführt, gibt er standardmäßig die Namen der Projektformulare der Komponente zurück. Übergeben Sie den Parameter *, enthält das Array die Formulare der Host Datenbank.

Hinweis: Formulare, die im Papierkorb liegen, werden nicht gelistet.

Beispiel

Beispiele für typische Anwendungen:

  // Liste aller Projektformulare der Datenbank

 FORM GET NAMES(arr_Names)

 

  // Liste der Formulare der Tabelle [Employees]

 FORM GET NAMES([Employees] ;arr_Names)

 

  // Liste der Eingabeformulare der Tabelle [Employees]

 FORM GET NAMES([Employees] ;arr_Names;"input_@")

 

  // Liste spezifischer Projektformulare der Datenbank

 FORM GET NAMES(arr_Names;"dialogue_@")

 

  // Liste aller  Projektformulare der Datenbank, die seit der letzten Synchronisation geändert wurden

  // vMarker enthält einen numerischen Wert

 FORM GET NAMES(arr_Names;"";vMarker)

 

  // Liste der Tabellenformulare aus einer Komponente

  // Ein Zeiger ist notwendig, da der Tabellenname unbekannt ist

 FORM GET NAMES(tablePtr->;arr_Names;*)

Siehe auch

METHOD GET PATHS FORM