Zum Hauptinhalt springen

DbFieldName

DbFieldName​

Verknüpftes Datenbankfeld

Details

In dieser Eigenschaft kann ein Datenbankfeld angegeben werden. Die Angabe kann entweder durch den Namen des Feldes oder durch die Nummer der Datei, des Teildatensatzes und des Feldes (zum Beispiel 100,1,2) erfolgen. Ein Feld kann ebenfalls über die Drag & Drop-Funktionalität aus der Datenbankinfo in die Eigenschaft gezogen werden. Wird zu einem späteren Zeitpunkt die Datenstruktur verändert, sodass der Feldname nicht mehr vorhanden ist, wird der Inhalt der Eigenschaft im Designer rot dargestellt.

Nicht alle Oberflächen-Objekte können alle Datentypen darstellen. Welche Datentypen angezeigt werden können, ist bei den entsprechenden Oberflächenobjekten beschrieben.

Ist in den Einstellungen die Option "Setzen von DbFieldName setzt auch Eingabelimit" aktiviert, wird nach der Angabe eines Datenbankfeldes der zulässige Eingabebereich des Objektes an das Datenbankfeld angepasst. Dies betrifft die Eigenschaften LengthMax (bei Feldern vom Typ alpha) sowie MinInt / MinBigInt und MaxInt / MaxBigInt (bei Feldern vom Typ Ganzzahlig kurz, Ganzzahlig lang und Ganzzahlig (64)). Die entsprechenden Eingabelimits werden sofort umgesetzt, wirken sich also auf die Eingabemöglichkeiten in der Caption-, CaptionInt- bzw. CaptionBigInt-Eigenschaften aus.

Wurden die Eingabemöglichkeiten bereits zuvor eingeschränkt, werden nur die Eingabebeschränkungen verändert, die die Möglichkeiten des zugeordneten Datenbankfeldes überschreiten. Ist zum Beispiel der Eingabebereich auf -100 bis +100 eingeschränkt und es wird ein Datenbankfeld von Typ Ganzzahlig kurz zugewiesen, verändert sich die Eingabemöglichkeit auf 0 bis +100.

Unter folgenden Bedingungen wird der Inhalt (Caption) des Eingabeobjektes automatisch in die Feldpuffer übertragen:

  • **** Das Eingabeobjekt verliert den Eingabefokus
  • **** Das Eingabeobjekt besitzt den Eingabefokus und eine Menüoption wurde angewählt
  • **** Das Eingabeobjekt besitzt den Eingabefokus und ein Button bzw. Toolbarbutton wurde angewählt

Erhält das Objekt den Fokus, wird der Inhalt des Feldpuffers automatisch in das Eingabeobjekt übertragen.

Dieser Automatismus kann über die Flags _WinAppObj2FldOff und _WinAppFld2ObjOff nach Bedarf aktiviert bzw. deaktiviert werden.

Ein Übertragen des Inhaltes zwischen Objekt und Feldpuffer kann auch mit dem Befehl WinUpdate () unter Verwendung der Optionen _WinUpdObj2Fld bzw. _WinUpdFld2Obj erfolgen. Je nach dem in welche Richtung das Übertragen stattfinden soll, wird eine der beiden Optionen verwendet.

Damit ein geänderter Feldpuffer, z. B. durch Lesen eines Datensatzes, in dem Objekt angezeigt wird, muss dieser über die Funktion WinUpdate () und der Option _WinUpdFld2Obj in das Objekt übertragen werden.

Die Eigenschaft kann im Eigenschaftsfenster oder über die Befehle WinPropGet () / PrtPropGet () und WinPropSet () / PrtPropSet () gelesen bzw. geändert werden.