4D Doc Center : FORM GET NAMES

4D v13.4

FORM GET NAMES


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

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Referenz der Tabelle
arrNamen	Array Text	Array der Formularnamen
Filter	Text	Filter für Namen
*	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.

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 der Tabellenformulare aus einer Komponente

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

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