SET FIELD TITLES

Home

4D v20 R7

SET FIELD TITLES


SET FIELD TITLES ( Tabellenname ; FeldTitel ; FeldNr {; *} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle für Feldtitel
FeldTitel	Array String	Feldnamen, wie sie in Dialogfenstern erscheinen sollen
FeldNr	Array Lange Ganzzahl	Aktuelle Feldnummern
*		Verwende die eigenen Namen im Formeleditor

Beschreibung

Der Befehl SET FIELD TITLES kann Felder in Tabellenname ausblenden, umbenennen und umsortieren, wenn sie in den 4D Standarddialogfenstern erscheinen, z.B. im Sucheditor in der Anwendungsumgebung (wenn der Startup Modus Anwendung ist oder Sie im Menü Start > Anwendung testen gewählt haben).

Mit diesem Befehl können Sie Feldnamen in Ihren Formularen "on the fly" umbenennen, wenn Sie dynamische Namen verwendet haben. Weitere Informationen dazu finden Sie im Abschnitt Referenzen in statischem Text verwenden des Handbuchs 4D Designmodus.

Die Arrays FeldTitel und FeldNr müssen synchronisiert sein. Im Array FeldTitel übergeben Sie die gewünschten Namen. Wollen Sie ein bestimmtes Feld nicht anzeigen, vergeben Sie dafür keinen Namen im Array. Die Felder erscheinen in der im Array festgelegten Reihenfolge. Sie übergeben in jedem Element des Array FeldNr die aktuelle Feldnummer des dazugehörigen Feldnamens bzw. des neuen Titels, der in FeldTitel übergeben wurde.

Sie haben zum Beispiel eine Tabelle mit den Feldern F, G und H in dieser Reihenfolge. Diese Felder sollen als M, N und O erscheinen, wobei Feld N nicht angezeigt werden soll. Außerdem soll die Reihenfolge O und dann M sein. Übergeben Sie dazu O und M in einem Array FeldTitel aus zwei Elementen und 3 und 1 in einem Array FeldNr aus zwei Elementen.

Der optionale Parameter * gibt an, ob mit diesem Befehl in 4D Formeln selbst definierte Namen (virtuelle Strukturen) verwendbar sind. Standardmäßig, d.h. ohne diesen Parameter, können in 4D ausgeführte Formeln nicht die selbst definierten Namen verwenden; es müssen die tatsächlichen Feldnamen verwendet werden. Sie müssen diesen Parameter übergeben, wenn Sie an Benutzer gelieferte Information steuern wollen und damit die Konsistenz der Oberfläche gewährleistet ist, da wo Formeln oder Ausdrücke verwendet werden, z.B.

wenn Ihre Anwendung Zugriff auf den Formeleditor gewährt, z.B. über den Schnellberichteditor
wenn Ihre Anwendung Referenzen auf Ausdrücke anzeigt, z.B. in 4D Write Pro Dokumenten

Hinweis: Ist der Parameter * übergeben, lassen sich die von diesem Befehl definierten Namen in den Formeln verwenden. Beachten Sie in diesem Fall, dass die eigenen Namen keine Zeichen enthalten dürfen, die der Interpreter der 4D Programmiersprache nicht zulässt, wie -?*%!. So ist beispielsweise die Bezeichnung "Rate in %" in einer Formel nicht zulässig. Weitere Informationen dazu finden Sie im Abschnitt Konventionen.

SET FIELD TITLES verändert NICHT die aktuelle Struktur Ihrer Datenbank. Der Befehl beeinflusst nur den späteren Gebrauch der 4D Standardeditoren und Formulare mit dynamischen Namen, wenn sie in der Anwendungsumgebung verwendet werden. SET FIELD TITLES gilt während einer Arbeitssitzung. Ein Vorteil im Client/Server-Betrieb ist, dass mehrere Arbeitsstationen gleichzeitig Ihre Datenbank auf unterschiedliche Art “sehen” können. Sie können SET FIELD TITLES beliebig oft aufrufen.

Verwenden Sie den Befehl SET FIELD TITLES, wenn Sie:

Eine Tabelle dynamisch lokalisieren wollen,
Felder in eigener Darstellung anzeigen wollen, unabhängig von der aktuellen Definition Ihrer Tabelle.
Felder je nach Art des Benutzers oder ihm zugewiesene Privilegien anders anzeigen wollen.

Hinweise:

SET FIELD TITLES überschreibt NICHT die Eigenschaft Unsichtbar eines Feldes. Ist ein Feld im Designmodus Ihrer Anwendung auf Unsichtbar gesetzt, erscheint es nicht, auch wenn es im Aufruf von SET FIELD TITLES enthalten ist.
Plug-Ins greifen immer auf die virtuelle Struktur zu, die durch diesen Befehl spezifiziert ist.
Wird SET FIELD TITLES ohne einen Parameter aufgerufen, wird die virtuelle Struktur, inkl. eigene Tabellen- und Feldnamen, komplett aus der Anwendungsumgebung entfernt.

Beispiel

Siehe Beispiel zum Befehl SET TABLE TITLES.

Siehe auch

Field name
GET FIELD TITLES
Get last field number
Parse formula
SET TABLE TITLES