Get format

Version 2004

Get format ({*; }Objekt) String

Die Funktion Get format gibt das aktuelle Anzeigeformat für das in Objekt angegebene Objekt zurück.

Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname ist. In diesem Fall übergeben Sie einen String. Ohne * geben Sie an, dass Objekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie eine Referenz auf ein Feld oder eine Variable.

Diese Funktion gibt das aktuelle Anzeigeformat des Objekts zurück; das ist das Format, welches in der Designumgebung oder über den Befehl SET FORMAT definiert wurde. Get format arbeitet mit allen Arten von Formularobjekten (Felder oder Variablen), die ein Anzeigeformat akzeptieren: Boolean, Datum, Zeit, Bild, String, Zahl sowie Schaltflächengitter, Halbkreisskalen, Thermometer, Bild PopUp-Menüs, Bildschaltflächen und 3D Schaltflächen.

Weitere Informationen zu den Anzeigeformaten finden Sie in der Dokumentation zum Befehl SET FORMAT.

Hinweis: Wenden Sie diese Funktion auf einen Satz Objekte an, wird das Format des zuletzt gewählten Objekts zurückgegeben.

Wird Get format auf die mit den Konstanten date, time oder picture definierten Objekte angewandt, entspricht der zurückgegebene String dem ASCII Code der Konstanten. Ihren Wert erhalten Sie, wenn Sie die Funktion Ascii auf das Ergebnis anwenden (siehe unten).

1. Über diesen Code erhalten Sie den Wert der Konstante format, angewandt auf die Bildvariable mit Namen "MeinFoto":

   C_STRING(2;$format)
   SET FORMAT(*;"MeinFoto";Char(On background))
      `Hintergrundformat anwenden (Wert= 3)
   $format:=Get format(*;"MeinFoto")
   ALERT("Formatnummer:"+String(Ascii($format)))
      `Anzeigewert "3"

2. Über diesen Code erhalten Sie das Format, angewandt auf das Boolean Feld [Members]Marital_status:

   C_STRING(30;$format)
   $format:=Get format([Members]Marital_status)
   ALERT($format)  `Anzeigeformat, zum Beispiel "Verheiratet;Single"

SET FORMAT.