spark.validatorsCurrencyValidator Die CurrencyValidator-Klasse stellt sicher, dass ein String gemäß den Konventionen eines Gebietsschemas einen gültigen Währungsbetrag darstellt.The <s:CurrencyValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:CurrencyValidator
    Properties
    currencyISOCode="locale specified string or customized by user."
    currencyStringError="Currency name is repeated or not correct."
    currencySymbol="locale specified string or customized by user."
    negativeCurrencyFormat="locale specified string or customized by user."
    negativeCurrencyFormatError="The negative format of the input currency is incorrect."
    positiveCurrencyFormat="locale specified string or customized by user."
    positiveCurrencyFormatError="The positive format of the input currency is incorrect."
  />
]]>spark.validators.supportClasses:NumberValidatorBase Die CurrencyValidator-Klasse stellt sicher, dass ein String gemäß den Konventionen eines Gebietsschemas einen gültigen Währungsbetrag darstellt. Diese Klasse verwendet den locale-Stil zum Festlegen der Gebietsschema-ID.

Der Validator kann sicherstellen, dass ein Währungsstring innerhalb eines bestimmten (durch die minValue- und maxValue-Eigenschaften festgelegten) Bereichs fällt, eine Ganzzahl ist (festgelegt durch die domain-Eigenschaft), einen nicht negativen Wert hat (festgelegt durch die allowNegative-Eigenschaft), negative und positive Zahlen korrekt angibt, den korrekten ISO-Währungscode oder das korrekte Währungssymbol aufweist und nicht die festgelegte Anzahl von fractionalDigits überschreitet. Der Validator legt Standardeigenschaftswerte unter Verwendung der flash.globalization.CurrencyFormatter-Klasse fest; daher werden die gebietsschemaspezifischen Werte vom Betriebssystem bereitgestellt.

Die flash.globalization.CurrencyFormatter-Klasse verwendet das zugrundeliegende Betriebssystem zum Bereitstellen der gebietschemaspezifischen Daten. Falls das Betriebssystem keine Währungsformatierung bereitstellt, stellt diese Klasse Ersatzfunktionen bereit.

flash.globalization.CurrencyFormatterCurrencyValidator Erstellt ein neues CurrencyValidator-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen. Erstellt ein neues CurrencyValidator-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen.

Das Gebietsschema für diese Klasse wird von der locale-Stileigenschaft bereitgestellt. Der Gebietsschema-Stil kann auf verschiedene Arten festgelegt werden:

  • Übernehmen des Stils aus einer UIComponent, indem die addStyleClient-Methode der UIComponent aufgerufen wird
  • Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält. 
    •       <fx:Declarations>
             <s:CurrencyValidator id="cv" />
      </fx:Declarations>
  • Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen. 
    •       <fx:Declarations>
          <s:CurrencyValidator id="cv_turkish" locale="tr-TR" />
      </fx:Declarations>
  • Aufrufen der setStyle-Methode, z. B. cv.setStyle("locale", "tr-TR")

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

Die Eigenschaften, die sich auf das Währungsstringformat beziehen, werden auf Standardwerte festgelegt, die auf dem Gebietsschema basieren.

Hinweis: Wenn ein Ersatzgebietsschema verwendet wird, werden die Währungseigenschaften auf die Standardwerte des Gebietsschemas „en_US“ festgelegt; sie stimmen deshalb möglicherweise nicht mit der Währung überein, für die die Überprüfung vorgesehen ist. Deshalb empfiehlt es sich, vor dem Überprüfen eines Währungsbetrags die Werte der currencySymbol- und currencyISOCode-Eigenschaften zu untersuchen.

flash.globalization.CurrencyFormatter.actualLocaleIDNamevalidateCurrency Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.Ein Array von ValidationResult-Objekten mit einem ValidationResult-Objekt für jedes vom Validator geprüfte Feld. valueEin zu überprüfender Währungszahlenstring. Der Zahlenstring kann neben ASCII-Minussymbolen Unicode-Minussymbole 0x2212, 0xFE63, 0xFF0D verwenden. baseFieldTextdarstellung des im value-Parameter angegebenen Unterfelds. Wenn zum Beispiel im value-Parameter value.number angegeben ist, ist der baseField-Wert „number“. Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode. Aufrufer muss den Überprüfungsstatus der ValidationResult-Objekte im zurückgegebenen Array prüfen. mx.validators.ValidationResultflash.globalization.CurrencyFormattercurrencyISOCode Der dreistellige ISO-4217-Währungscode für das aktuell verwendete Gebietsschema. Der dreistellige ISO-4217-Währungscode für das aktuell verwendete Gebietsschema.

Diese Eigenschaft wird verwendet, um den Währungsstring oder das Währungssymbol in den eingegebenen Währungsbeträgen mit der validate()-Methode zu überprüfen.

Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft den bevorzugten Standardwährungscode für das Ersatzgebietsschema an.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

validate()currencySymbolcurrencyStringError Fehlermeldung, wenn das Währungssymbol oder der ISO-Währungscode wiederholt wird oder sich an der falschen Position befindet."Currency name is repeated or not correct." Fehlermeldung, wenn das Währungssymbol oder der ISO-Währungscode wiederholt wird oder sich an der falschen Position befindet. currencySymbol Das Währungssymbol oder der String für das aktuell verwendete Gebietsschema. Das Währungssymbol oder der String für das aktuell verwendete Gebietsschema.

Diese Eigenschaft wird als Währungssymbol verwendet, wenn Währungsbeträge mit der validate()-Methode überprüft werden. Das Währungssymbol oder der Währungsname im Überprüfungsstring muss entweder mit dem Wert der currencySymbol-Eigenschaft oder dem Wert der currencyISOCode-Eigenschaft übereinstimmen.

Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft das bevorzugte Standardwährungssymbol für das Ersatzgebietsschema an.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

format()setCurrency()formattingWithCurrencySymbolIsSafe()currencyISOCodenegativeCurrencyFormatError Fehlermeldung, wenn das Format für negative Zahlen des Eingabewährungsstrings falsch ist."The negative format of the input currency is incorrect." Fehlermeldung, wenn das Format für negative Zahlen des Eingabewährungsstrings falsch ist. negativeCurrencyFormat Ein numerischer Wert, der ein Überprüfungsmuster für negative Währungsbeträge angibt.wenn der zugewiesene Wert nicht zwischen 0 und 15 liegt. ArgumentErrorArgumentError Ein numerischer Wert, der ein Überprüfungsmuster für negative Währungsbeträge angibt. Diese Eigenschaft definiert die Position des Währungssymbols und des Negativsymbols oder der Klammern in Relation zum numerischen Teil des Währungsbetrags. Mit dieser Eigenschaft wird überprüft, ob der Eingabewährungsstring diesem Muster für negative Beträge folgt.

Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.

  • Das Symbol „¤“ stellt die Position des currencyISOCode oder des currencySymbol im Währungsstring dar.
  • Das Zeichen „-“ stellt die Position des negativeNumberSymbol dar.
  • Das Zeichen „n“ stellt den Währungsbetrag dar.
Formattyp für negative Währungsbeträge Formatierungsmuster 0 (¤n) 1 -¤n 2 ¤-n 3 ¤n- 4 (n¤) 5 -n¤ 6 n-¤ 7 n¤- 8 -n ¤ 9 -¤ n 10 n ¤- 11 ¤ n- 12 ¤ -n 13 n- ¤ 14 (¤ n) 15 (n ¤)

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

format()currencySymbolnegativeSymbolpositiveCurrencyFormatError Fehlermeldung, wenn das Format für positive Währungszahlen falsch ist."The positive format of the input currency is incorrect." Fehlermeldung, wenn das Format für positive Währungszahlen falsch ist. positiveCurrencyFormat Ein numerischer Wert, der ein Überprüfungsmuster für positive Währungsbeträge angibt.wenn der zugewiesene Wert nicht zwischen 0 und 3 liegt. ArgumentErrorArgumentError Ein numerischer Wert, der ein Überprüfungsmuster für positive Währungsbeträge angibt. Diese Eigenschaft definiert die Position des Währungssymbols in Relation zum numerischen Teil des Währungsbetrags. Mit dieser Eigenschaft wird überprüft, ob der Eingabewährungsstring diesem Muster für positive Beträge folgt.

Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.

  • Das Symbol „¤“ stellt die Position des currencyISOCode oder des currencySymbol im Währungsstring dar.
  • Das Zeichen „n“ stellt die Position des currencyISOCode oder des currencySymbol im Währungsstring dar.
Formattyp für positive Währungsbeträge Formatierungsmuster 0 ¤n 1 n¤ 2 ¤ n 3 n ¤

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

currencySymbolformat()NumberValidator Die NumberValidator-Klasse stellt sicher, dass ein String gemäß den Konventionen eines Gebietsschemas eine gültige Zahl darstellt.The <spark:NumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:NumberValidator
    Properties
    negativeNumberFormat="locale specified string or customized by user."
    negativeNumberFormatError="The negative format of the input number is incorrect."
  />
]]>spark.validators.supportClasses:NumberValidatorBase Die NumberValidator-Klasse stellt sicher, dass ein String gemäß den Konventionen eines Gebietsschemas eine gültige Zahl darstellt. Sie kann Strings überprüfen, die int-, uint- und Number-Objekte darstellen.

Diese Klasse verwendet den locale-Stil zum Festlegen der angeforderten Gebietsschema-ID.

Der Validator kann sicherstellen, dass die Eingabe innerhalb eines bestimmten (durch die minValue- und maxValue-Eigenschaften festgelegten) Bereichs fällt, eine Ganzzahl ist (festgelegt durch die domain-Eigenschaft), einen nicht negativen Wert hat (festgelegt durch die allowNegative-Eigenschaft), negative und positive Zahlen korrekt angibt und nicht die festgelegte Anzahl von fractionalDigits überschreitet. Der Validator legt Standardeigenschaftswerte unter Verwendung von flash.globalization.NumberFormatter fest; daher werden die gebietsschemaspezifischen Werte vom Betriebssystem bereitgestellt.

Die NumberValidator-Klasse kann in MXML-Deklarationen oder in ActionScript-Code verwendet werden. Diese Klasse verwendet den Gebietsschemastil zur Angabe der von der flash.globalization.NumberFormatter-Klasse angeforderten Gebietsschema-ID und hat Methoden und Eigenschaften, die bindbar sind.

flash.globalization.NumberFormatterNumberValidator Erstellt ein neues NumberValidator-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen. Erstellt ein neues NumberValidator-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen.

Das Gebietsschema für diese Klasse wird vom Gebietsschema-Stil bereitgestellt. Der Gebietsschema-Stil kann auf verschiedene Arten festgelegt werden:

  • Übernehmen des Stils aus einer UIComponent, indem die addStyleClient-Methode der UIComponent aufgerufen wird
  • Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält. 
          <fx:Declarations>
             <s:NumberValidator id="nv" />
      </fx:Declarations>
  • Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen. 
          <fx:Declarations>
          <s:NumberValidator id="nv_French_France" locale="fr_FR" />
      </fx:Declarations>
  • Aufrufen der setStyle-Methode. Beispiel: nv.setStyle("locale", "fr-FR")

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

validateNumber Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld. valueEin zu überprüfender Zahlenstring. baseFieldTextdarstellung des im value-Objekt angegebenen Unterfelds. Wenn zum Beispiel im value-Parameter value.number angegeben ist, ist der baseField-Wert „number“. Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode. Aufrufer muss den Überprüfungsstatus der ValidationResult-Objekte im zurückgegebenen Array prüfen. mx.validators.ValidationResultnegativeNumberFormatError Fehlermeldung, wenn das Format für negative Zahlen der Eingabezahl nicht dem von der negativeNumberFormat-Eigenschaft festgelegten Muster folgt."The negative format of the input number is incorrect." Fehlermeldung, wenn das Format für negative Zahlen der Eingabezahl nicht dem von der negativeNumberFormat-Eigenschaft festgelegten Muster folgt. negativeNumberFormat Ein numerischer Wert, der ein Überprüfungsmuster für negative Zahlen angibt.wenn der zugewiesene Wert keine Zahl zwischen 0 und 4 ist. ArgumentErrorArgumentError Ein numerischer Wert, der ein Überprüfungsmuster für negative Zahlen angibt. Dieses Muster definiert die Position des Negativsymbols oder der Klammern in Relation zum numerischen Teil der zu überprüfenden Zahl.

In der folgenden Tabelle sind die möglichen Formate für negative Zahlen aufgeführt. Wenn eine negative Zahl überprüft wird, stellt das Minuszeichen den Wert der negativeSymbol-Eigenschaft und das Zeichen „n“ den numerischen Wert dar.

Formattyp für negative Zahlen Format 0 (n) 1 -n 2 - n 3 n- 4 n - Der Standardwert hängt vom Gebietsschema und Betriebssystem ab. negativeSymbolformat()