Data.DB.TNumericField.DisplayFormat

Übergeordnet: TNumericField

Delphi

property DisplayFormat: string read FDisplayFormat write SetDisplayFormat;

C++

__property System::UnicodeString DisplayFormat = {read=FDisplayFormat, write=SetDisplayFormat};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	published	Data.DB.pas Data.DB.hpp	Data.DB	TNumericField

Beschreibung

Legt fest, in welchem Format der Wert eines numerischen Feldes in einem datensensitiven Steuerelement angezeigt wird.

Mit DisplayFormat kann die automatische Feldformatierung außer Kraft gesetzt werden, um eine individuelle Darstellung zu erreichen.

Anmerkung: DisplayFormat wirkt sich nur auf die Anzeige der Felddaten aus. Die Eigenschaft wirkt sich nicht auf die Gültigkeit von Strings aus, die einem numerischen Feld in der Eigenschaft AsString zugewiesen sind.

Der Wert von DisplayFormat ist ein String, der in codierter Form die Formatierung numerischer Daten beschreibt. Die gültigen Bezeichner finden Sie in dieser Tabelle:

Bezeichner	Bedeutung
0	Platzhalter für Ziffern. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen 0 (Null) steht, wird die betreffende Ziffer in den Ausgabe-String übernommen. Andernfalls erscheint im Ausgabe-String an dieser Position eine Null.
#	Platzhalter für Ziffern. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen # steht, dann wird diese Ziffer in den Ausgabe-String übernommen. Andernfalls wird an dieser Position kein Zeichen im Ausgabe-String gespeichert.
.	Dezimalzeichen. Der erste Punkt im Format-String bestimmt die Position des Dezimalzeichens im formatierten Wert. Alle weiteren Punktzeichen werden ignoriert. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable DecimalSeparator festgelegt. Der Standardwert von DecimalSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register "Eigenschaften von Ländereinstellungen", Registerkarte "Zahlen").
,	Tausendertrennzeichen. Wenn der Format-String ein oder mehrere Kommazeichen enthält, werden im Ausgabe-String alle Stellen links vom Dezimalzeichen in Dreiergruppen gegliedert, die jeweils durch ein Tausendertrennzeichen getrennt sind. Um zu kennzeichnen, dass ein Tausendertrennzeichen gewünscht wird, ist es nicht von Bedeutung, wie viele Kommas der Format-String enthält. Auch die Position ist beliebig. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable ThousandSeparator festgelegt. Der Standardwert von ThousandSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register "Eigenschaften von Ländereinstellungen", Registerkarte "Zahlen").
E+	Wissenschaftliche Notation. Sobald der Format-String einen der Bezeichner "E+", "E-", "e+" oder "e-" enthält, wird die formatierte Zahl in wissenschaftlicher Notation dargestellt. Unmittelbar nach "E+", "E-", "e+" oder "e-" kann eine Gruppe von bis zu vier Nullen folgen, mit denen die minimale Stellenzahl im Exponenten festgelegt wird. Die beiden Kürzel "E+" und "e+" bewirken, dass sowohl positive als auch negative Exponenten mit einem Vorzeichen versehen werden. Die Kürzel "E-" und "e-" bewirken, dass nur negative Exponenten ein Vorzeichen erhalten.
'xx'/"xx"	In halbe oder ganze Anführungszeichen eingeschlossene Zeichen wirken sich nicht auf die Formatierung aus und werden wie eingegeben angezeigt.
;	Trennt Abschnitte für positive, negative und Nullwerte im Format-String.

Innerhalb des Format-Strings bestimmt die Position des am weitesten links stehenden Nullzeichens zusammen mit der Position des am weitesten rechts stehenden Nullzeichens (bezogen auf das Dezimalzeichen) die Anzahl der Stellen, die immer im Ausgabe-String angezeigt werden.

Die darzustellende Zahl wird bei der Formatierung stets auf die Anzahl von Nachkommastellen gerundet, die durch die Anzahl der Ziffern-Platzhalter ("0" oder "#") rechts vom Dezimalzeichen vorgegeben ist. Fehlt im Format-String ein Dezimalzeichen, wird der formatierte Wert auf die nächste ganze Zahl gerundet.

Wenn die festgelegte Anzahl von Vorkommastellen nicht ausreicht, um eine Zahl darzustellen, werden vor dem ersten Ziffern-Platzhalter zusätzliche Stellen eingefügt.

Die folgende Tabelle zeigt das Ergebnis verschiedener Format-Strings.

DisplayFormat	Wert	Ergebnis	Bemerkung
#.##	12.2	12.2	Beachten Sie, dass die zusätzliche Ziffer links vom Dezimalzeichen angezeigt wird.
#.00	2.5	2.50	Beachten Sie die zusätzliche Null: In dem Feld werden immer zwei Dezimalstellen angezeigt.
00.##	.006	00.01	Beachten Sie die zusätzlichen Nullen rechts vom Dezimalzeichen und das Runden der beiden Dezimalstellen.

Das Semikolon gliedert den Format-String in bis zu drei Abschnitte, in denen jeweils eine eigene Formatierung für positive und negative Zahlen sowie für Nullen definiert werden kann.

Ein Abschnitt: Der Format-String wird für alle Werte verwendet.
Zwei Abschnitte: Der erste Abschnitt wird für positive und Nullwerte, der zweite Abschnitt für negative Werte verwendet.
Drei Abschnitte: Der erste Abschnitt wird für positive, der zweite für negative und der dritte Abschnitt für Nullwerte verwendet.

Wenn der Abschnitt für negative Werte oder der Abschnitt für Nullen leer ist, wenn also zwischen den Semikolons nichts steht, wird stattdessen der Abschnitt für positive Werte verwendet.

Wenn der Abschnitt für positive Zahlen leer ist, oder der gesamte Format-String leer ist, erfolgt eine standardisierte Gleitkommaformatierung mit 15 signifikanten Stellen. Die allgemeine Formatierung für Gleitkommawerte wird auch verwendet, wenn der Wert mehr als 18 Ziffern links neben dem Dezimalzeichen enthält und im Format-String keine wissenschaftliche Schreibweise festgelegt wurde.