CurrencyValidator

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 expanded

MXML-Syntax ausblenden

The <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=","
  />

Beispiele anzeigen

Verwandte API-Elemente

mx.validators.CurrencyValidatorAlignSymbol

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		actualListeners : Array [schreibgeschützt] Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt.	Validator
		actualTrigger : IEventDispatcher [schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.	Validator
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	Validator
		subFields : Array Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde.	Validator

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		CurrencyValidator() 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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird.	Validator
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit.	Validator
		validateAll(validators:Array):Array [statisch] Ruft alle Validators im Array der Validators auf.	Validator
		validateCurrency(validator:CurrencyValidator, value:Object, baseField:String):Array [statisch] Vereinfachungsmethode zum Aufrufen eines Validators.	CurrencyValidator
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		addListenerHandler():void Richtet alle Listener für die gültigen und ungültigen Ereignisse ein, die vom Validator ausgelöst werden.	Validator
		doValidation(value:Object):Array [override] Überschreiben der doValidation()-Methode der Basisklasse für die Überprüfung eines Währungsausdrucks.	CurrencyValidator
		getValueFromSource():Object Gibt das zu überprüfende Objekt zurück.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.	Validator
		isRealValue(value:Object):Boolean Gibt true zurück, wenn der Wert ungleich null ist.	Validator
		removeListenerHandler():void Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.	Validator
		resourcesChanged():void 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

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
invalid	Wird ausgelöst, wenn eine Überprüfung fehlschlägt.	Validator
valid	Wird ausgelöst, wenn eine Überprüfung erfolgreich ist.	Validator

Geschützte Konstanten

Vererbte geschützte Konstanten ausblenden

Vererbte geschützte Konstanten anzeigen

	Konstante		Definiert von

Eigenschaftendetails

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):void

Verwandte API-Elemente

mx.validators.CurrencyValidatorAlignSymbol

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):void

currencySymbol

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):void

currencySymbolError

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):void

decimalPointCountError

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):void

decimalSeparator

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):void

exceedsMaxError

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):void

invalidCharError

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):void

invalidFormatCharsError

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):void

lowerThanMinError

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):void

maxValue

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):void

minValue

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):void

negativeError

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):void

precision

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):void

precisionError

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):void

separationError

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):void

thousandsSeparator

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):void

Konstruktordetails

()

Konstruktor

public function CurrencyValidator()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

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.

Rückgabewerte

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“.

Rückgabewerte

Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.

Verwandte API-Elemente

mx.validators.ValidationResult

Beispiele Verwendung dieses Beispiels

CurrencyValidatorExample.mxml

<?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>

Rechtliche Hinweise | Onlinedatenschutzerklärung

CurrencyValidator - AS3 Flex

Klassen x

alignSymbol

allowNegative

currencySymbol

currencySymbolError

decimalPointCountError

decimalSeparator

exceedsMaxError

invalidCharError

invalidFormatCharsError

lowerThanMinError

maxValue

minValue

negativeError

precision

precisionError

separationError

thousandsSeparator