4D v14.3
FORM GET NAMES
- 4D Programmiersprache
-
- Zugriff Designobjekte
-
- Befehle für Zugriff auf Designobjekte
- Current method path
- FORM GET NAMESUpd
- METHOD Get attribute
- METHOD GET CODEUpd
- METHOD GET COMMENTS
- METHOD GET FOLDERS
- METHOD GET MODIFICATION DATE
- METHOD GET NAMES
- METHOD Get path
- METHOD GET PATHS
- METHOD GET PATHS FORM
- METHOD OPEN PATH
- METHOD RESOLVE PATH
- METHOD SET ACCESS MODE
- METHOD SET ATTRIBUTEUpd
- METHOD SET CODEUpd
- METHOD SET COMMENTS
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.) | |||||
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.
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;*)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;*)
Produkt: 4D
Thema: Zugriff Designobjekte
Nummer:
1167
Erstellt: 4D v13
Geändert: 4D v14
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)
Geerbt von : FORM GET NAMES ( 4D v13.5)
