Data.DB.TNumericField.EditFormat
Delphi
property EditFormat: string read FEditFormat write SetEditFormat;
C++
__property System::UnicodeString EditFormat = {read=FEditFormat, write=SetEditFormat};
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 erscheint, während er in einem datensensitiven Steuerelement angezeigt wird.
Mit Hilfe der Eigenschaft EditFormat kann die Formatierung eines Feldes gesteuert werden, wenn in einem datensensitiven Steuerelement ein Wert bearbeitet wird.
Wenn keine Zuweisung an EditFormat erfolgt, aber die Eigenschaft DisplayFormat einen Wert besitzt, wird der String in DisplayFormat verwendet.
Der Wert von EditFormat ist ein String, der in codierter Form die Formatierung numerischer Daten beschreibt. Die gültigen Bezeichner finden Sie in dieser Tabelle:
| Bezeichner | Repräsentiert |
|---|---|
| 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. |
| . | Dezimaltrennzeichen. Der erste Punkt im Format-String bestimmt die Position des Dezimaltrennzeichens 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 Dezimaltrennzeichen 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 Dezimaltrennzeichen) 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 Dezimaltrennzeichen vorgegeben ist. Fehlt im Format-String ein Dezimaltrennzeichen, 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.
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 oder Nullwerte keine Angaben enthält, 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.
Anmerkung: Die Eigenschaft EditFormat wirkt sich nur auf die reine Anzeige der Felddaten während einer Bearbeitung aus. Es besteht kein Zusammenhang mit der Gültigkeit von Strings, die einem numerischen Feld mit der Eigenschaft AsString zugewiesen werden. EditFormat betrifft auch nicht das Anzeigeformat, wenn keine Bearbeitung stattfindet.