| Paket | mx.validators |
| Klasse | public class CurrencyValidator |
| Vererbung | CurrencyValidator  Validator EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
 | Beginnend mit Flex 4.5 empfiehlt Adobe die Verwendung der Klasse spark.validators.CurrencyValidator als Alternative zu dieser Klasse. |
Die CurrencyValidator-Klasse überprüft, dass ein String einen gültigen Währungsausdruck darstellt. Sie kann sicherstellen, dass die Eingabe innerhalb des (von
minValue und maxValue) angegebenen Bereichs liegt, (gemäß allowNegative) nicht negativ ist und die angegebene precision nicht überschreitet. Die CurrencyValidator-Klasse überprüft ordnungsgemäß formatierte und unformatierte Währungsausdrücke, z. B. „$12,345.00“ und „12345“. Sie können die currencySymbol-, alignSymbol-, thousandsSeparator- und decimalSeparator-Eigenschaften für die Internationalisierung anpassen.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:CurrencyValidator> tag
inherits all of the tag properties of its superclass,
and adds the following tag properties:
<mx:CurrencyValidator
alignSymbol="left|right|any"
allowNegative="true|false"
currencySymbol="$"
currencySymbolError="The currency symbol occurs in an invalid location."
decimalPointCountError="The decimal separator can occur only once."
decimalSeparator="."
exceedsMaxError="The amount entered is too large."
invalidCharError="The input contains invalid characters."
invalidFormatCharsError="One of the formatting parameters is invalid."
lowerThanMinError="The amount entered is too small."
maxValue="NaN"
minValue="NaN"
negativeError="The amount may not be negative."
precision="2"
precisionError="The amount entered has too many digits beyond the decimal point."
separationError="The thousands separator must be followed by three digits."
thousandsSeparator=","
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| alignSymbol : String
Gibt die Ausrichtung des currencySymbol im Verhältnis zum Rest des Ausdrucks an. | CurrencyValidator | ||
| allowNegative : Object
Gibt an, ob negative Zahlen zulässig sind. | CurrencyValidator | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currencySymbol : String
Der Zeichenstring, der für die Angabe des Währungssymbols verwendet wird, wie z. B. „$“, „R$“ oder „£“. | CurrencyValidator | ||
| currencySymbolError : String
Fehlermeldung, wenn sich das von currencySymbol definierte Währungssymbol in einer falschen Position befindet. | CurrencyValidator | ||
| decimalPointCountError : String
Fehlermeldung, wenn das Dezimaltrennzeichen mehr als einmal vorkommt. | CurrencyValidator | ||
| decimalSeparator : String
Das Zeichen, das die Ganzzahl vom Bruchteil der Zahl trennt. | CurrencyValidator | ||
| enabled : Boolean
Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt. | Validator | |
| exceedsMaxError : String
Fehlermeldung, wenn der Wert größer als der maxValue ist. | CurrencyValidator | ||
| invalidCharError : String
Fehlermeldung, wenn die Währung ungültige Zeichen enthält. | CurrencyValidator | ||
| invalidFormatCharsError : String
Fehlermeldung, wenn der Wert ein ungültiges Formatierungszeichen enthält. | CurrencyValidator | ||
| listener : Object
Gibt den Überprüfungs-Listener an. | Validator | |
| lowerThanMinError : String
Fehlermeldung, wenn der Wert kleiner als der minValue ist. | CurrencyValidator | ||
| maxValue : Object
Höchstwert für eine gültige Zahl. | CurrencyValidator | ||
| minValue : Object
Mindestwert für eine gültige Zahl. | CurrencyValidator | ||
| negativeError : String
Fehlermeldung, wenn der Wert negativ ist und die allowNegative-Eigenschaft auf false gesetzt ist. | CurrencyValidator | ||
| precision : Object
Die maximale zulässige Anzahl von Ziffern nach dem Dezimalzeichen. | CurrencyValidator | ||
| precisionError : String
Fehlermeldung, wenn die Genauigkeit des Werts den in der precision-Eigenschaft angegebenen Wert überschreitet. | CurrencyValidator | ||
| property : String
Ein String, der den Namen der Eigenschaft des Quellobjekts angibt, das den zu prüfenden Wert enthält. | Validator | |
| required : Boolean = true
Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt. | Validator | |
| requiredFieldError : String
Fehlermeldung, wenn ein Wert fehlt und die erforderliche Eigenschaft true ist. | Validator | |
| separationError : String
Fehlermeldung, wenn das Tausendertrennzeichen falsch platziert wurde. | CurrencyValidator | ||
| source : Object
Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist. | Validator | |
| thousandsSeparator : String
Das Zeichen, das die Tausender trennt. | CurrencyValidator | ||
| trigger : IEventDispatcher
Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst. | Validator | |
| triggerEvent : String
Gibt das Ereignis an, das die Überprüfung auslöst. | Validator | |
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | CurrencyValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird. | Validator | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit. | Validator | |
| [statisch]
Ruft alle Validators im Array der Validators auf. | Validator | |
[statisch]
Vereinfachungsmethode zum Aufrufen eines Validators. | CurrencyValidator | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Methode | Definiert von | ||
|---|---|---|---|
|
Richtet alle Listener für die gültigen und ungültigen Ereignisse ein, die vom Validator ausgelöst werden. | Validator | |
[override]
Überschreiben der doValidation()-Methode der Basisklasse für die Überprüfung eines Währungsausdrucks. | CurrencyValidator | ||
|
Gibt das zu überprüfende Objekt zurück. | Validator | |
|
Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück. | Validator | |
|
Gibt true zurück, wenn der Wert ungleich null ist. | Validator | |
|
Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden. | Validator | |
|
Diese Methode wird aufgerufen, wenn ein Validator erzeugt wird und jedes Mal, wenn ein ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass die lokalisierten Ressourcen eine Änderung erfahren haben. | Validator | |
alignSymbol | Eigenschaft |
alignSymbol:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Ausrichtung des currencySymbol im Verhältnis zum Rest des Ausdrucks an. Zulässige Werte in ActionScript sind CurrencyValidatorAlignSymbol.LEFT, CurrencyValidatorAlignSymbol.RIGHT und CurrencyValidatorAlignSymbol.ANY. Zulässige Werte in MXML sind "left", "right" und "any".
Der Standardwert ist CurrencyValidatorAlignSymbol.LEFT.
Implementierung
public function get alignSymbol():String public function set alignSymbol(value:String):voidVerwandte API-Elemente
allowNegative | Eigenschaft |
allowNegative:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob negative Zahlen zulässig sind. Kann true oder false sein.
Der Standardwert ist true.
Implementierung
public function get allowNegative():Object public function set allowNegative(value:Object):voidcurrencySymbol | Eigenschaft |
currencySymbol:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Zeichenstring, der für die Angabe des Währungssymbols verwendet wird, wie z. B. „$“, „R$“ oder „£“. Darf keine Ziffer sein und muss verschieden vom thousandsSeparator und vom decimalSeparator sein.
Der Standardwert ist "$".
Implementierung
public function get currencySymbol():String public function set currencySymbol(value:String):voidcurrencySymbolError | Eigenschaft |
currencySymbolError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn sich das von currencySymbol definierte Währungssymbol in einer falschen Position befindet.
Der Standardwert ist "The currency symbol occurs in an invalid location.".
Implementierung
public function get currencySymbolError():String public function set currencySymbolError(value:String):voiddecimalPointCountError | Eigenschaft |
decimalPointCountError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn das Dezimaltrennzeichen mehr als einmal vorkommt.
Der Standardwert ist "The decimal separator can only occur once.".
Implementierung
public function get decimalPointCountError():String public function set decimalPointCountError(value:String):voiddecimalSeparator | Eigenschaft |
decimalSeparator:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Zeichen, das die Ganzzahl vom Bruchteil der Zahl trennt. Darf keine Ziffer sein und muss verschieden vom currencySymbol und dem thousandsSeparator sein.
Der Standardwert ist ".".
Implementierung
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidexceedsMaxError | Eigenschaft |
exceedsMaxError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Wert größer als der maxValue ist.
Der Standardwert ist "The amount entered is too large.".
Implementierung
public function get exceedsMaxError():String public function set exceedsMaxError(value:String):voidinvalidCharError | Eigenschaft |
invalidCharError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn die Währung ungültige Zeichen enthält.
Der Standardwert ist "The input contains invalid characters.".
Implementierung
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidFormatCharsError | Eigenschaft |
invalidFormatCharsError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Wert ein ungültiges Formatierungszeichen enthält.
Der Standardwert ist "One of the formatting parameters is invalid.".
Implementierung
public function get invalidFormatCharsError():String public function set invalidFormatCharsError(value:String):voidlowerThanMinError | Eigenschaft |
lowerThanMinError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Wert kleiner als der minValue ist.
Der Standardwert ist "The amount entered is too small.".
Implementierung
public function get lowerThanMinError():String public function set lowerThanMinError(value:String):voidmaxValue | Eigenschaft |
maxValue:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Höchstwert für eine gültige Zahl. Der Wert NaN bedeutet, dass die Eigenschaft ignoriert wird.
Der Standardwert ist NaN.
Implementierung
public function get maxValue():Object public function set maxValue(value:Object):voidminValue | Eigenschaft |
minValue:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Mindestwert für eine gültige Zahl. Der Wert NaN bedeutet, dass die Eigenschaft ignoriert wird.
Der Standardwert ist NaN.
Implementierung
public function get minValue():Object public function set minValue(value:Object):voidnegativeError | Eigenschaft |
negativeError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Wert negativ ist und die allowNegative-Eigenschaft auf false eingestellt ist.
Der Standardwert ist "The amount may not be negative.".
Implementierung
public function get negativeError():String public function set negativeError(value:String):voidprecision | Eigenschaft |
precision:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die maximale zulässige Anzahl von Ziffern nach dem Dezimalzeichen. Kann eine beliebige nicht negative Ganzzahl sein. Hinweis: Die Einstellung 0 hat dieselbe Wirkung wie das Festlegen von NumberValidator.domain auf int. Die Einstellung -1 bedeutet, dass sie ignoriert wird.
Der Standardwert ist 2.
Implementierung
public function get precision():Object public function set precision(value:Object):voidprecisionError | Eigenschaft |
precisionError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn die Genauigkeit des Werts den in der precision-Eigenschaft angegebenen Wert überschreitet.
Der Standardwert ist "The amount entered has too many digits beyond the decimal point.".
Implementierung
public function get precisionError():String public function set precisionError(value:String):voidseparationError | Eigenschaft |
separationError:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn das Tausendertrennzeichen falsch platziert wurde.
Der Standardwert ist "The thousands separator must be followed by three digits.".
Implementierung
public function get separationError():String public function set separationError(value:String):voidthousandsSeparator | Eigenschaft |
thousandsSeparator:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Zeichen, das die Tausender trennt. Darf keine Ziffer sein und muss verschieden vom currencySymbol und vom decimalSeparator sein.
Der Standardwert ist ",".
Implementierung
public function get thousandsSeparator():String public function set thousandsSeparator(value:String):voidCurrencyValidator | () | Konstruktor |
public function CurrencyValidator()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
doValidation | () | Methode |
override protected function doValidation(value:Object):Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Überschreiben der doValidation()-Methode der Basisklasse für die Überprüfung eines Währungsausdrucks.
Diese Methode wird nicht direkt aufgerufen; Flex ruft sie als Teil einer Überprüfung auf. Wenn Sie eine benutzerdefinierte Validator-Klasse erstellen, müssen Sie diese Methode implementieren.
Parameter
value:Object — Zu überprüfendes Objekt.
|
Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.
|
validateCurrency | () | Methode |
public static function validateCurrency(validator:CurrencyValidator, value:Object, baseField:String):Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Vereinfachungsmethode zum Aufrufen eines Validators. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode.
Parameter
validator:CurrencyValidator — Die CurrencyValidator-Instanz.
| |
value:Object — Das zu überprüfende Objekt.
| |
baseField:String — Textdarstellung des im value-Parameter angegebenen Unterfelds. Wenn zum Beispiel im value-Parameter value.currency angegeben ist, ist der baseField-Wert „currency“.
|
Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.
|
Verwandte API-Elemente
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CurrencyValidator. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
import mx.controls.Alert;
</fx:Script>
<fx:Declarations>
<mx:CurrencyValidator source="{priceUS}" property="text" precision="2"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="CurrencyValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a U.S. dollar amount: ">
<s:TextInput id="priceUS" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z