CurrencyValidator

Paket	spark.validators
Klasse	public class CurrencyValidator
Vererbung	CurrencyValidator NumberValidatorBase GlobalizationValidatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

MXML-Syntax expanded

MXML-Syntax ausblenden

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."
  />

Beispiele anzeigen

Verwandte API-Elemente

flash.globalization.CurrencyFormatter

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		actualLocaleIDName : String [schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird.	GlobalizationBase
		allowNegative : Boolean Gibt an, ob negative Zahlen zulässig sind.	NumberValidatorBase
		className : String [schreibgeschützt] Der Name der Komponentenklasse.	AdvancedStyleClient
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		currencyISOCode : String Der dreistellige ISO-4217-Währungscode für das aktuell verwendete Gebietsschema.	CurrencyValidator
		currencyStringError : String Fehlermeldung, wenn das Währungssymbol oder der ISO-Währungscode wiederholt wird oder sich an der falschen Position befindet.	CurrencyValidator
		currencySymbol : String Das Währungssymbol oder der String für das aktuell verwendete Gebietsschema.	CurrencyValidator
		decimalPointCountError : String Fehlermeldung, wenn das Dezimaltrennzeichen mehr als einmal vorkommt.	NumberValidatorBase
		decimalSeparator : String Das Dezimaltrennzeichen, das für die Überprüfung von Zahlen mit Dezimalteil verwendet wird.	NumberValidatorBase
		digitsType : uint Definiert den Satz von Ziffernzeichen, die beim Überprüfen von Zahlen verwendet werden sollen.	NumberValidatorBase
		domain : String Zu überprüfender Zahlentyp.	NumberValidatorBase
		enabled : Boolean Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt.	GlobalizationValidatorBase
		fractionalDigits : int Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können.	NumberValidatorBase
		fractionalDigitsError : String Fehlermeldung, wenn die Nachkommastellen den von der fractionalDigits-Eigenschaft angegebenen Wert übersteigen.	NumberValidatorBase
		greaterThanMaxError : String Fehlermeldung, wenn der Wert größer als die maxValue-Eigenschaft ist.	NumberValidatorBase
		groupingSeparator : String Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird.	NumberValidatorBase
		id : String Die Identität der Komponente.	AdvancedStyleClient
		inheritingStyles : Object Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.	AdvancedStyleClient
		invalidCharError : String Fehlermeldung, wenn der Wert ungültige Zeichen enthält.	NumberValidatorBase
		invalidFormatCharsError : String Fehlermeldung, wenn der Wert ungültige Formatzeichen enthält, d. h. er enthält eine Ziffer oder ein Minuszeichen (-) als Trennzeichen bzw. zwei oder mehr aufeinanderfolgende Trennzeichen.	NumberValidatorBase
		lastOperationStatus : String [override] [schreibgeschützt] Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat.	NumberValidatorBase
		lessThanMinError : String Fehlermeldung, wenn der Wert kleiner als der minValue ist.	NumberValidatorBase
		listener : Object Gibt den Überprüfungs-Listener an.	GlobalizationValidatorBase
		localeUndefinedError : String Fehlermeldung, wenn das Gebietsschema nicht definiert wurde oder nicht verfügbar ist.	NumberValidatorBase
		maxValue : Number Höchstwert für eine gültige Zahl.	NumberValidatorBase
		minValue : Number Mindestwert für eine gültige Zahl.	NumberValidatorBase
		moduleFactory : IFlexModuleFactory Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.	AdvancedStyleClient
		negativeCurrencyFormat : uint Ein numerischer Wert, der ein Überprüfungsmuster für negative Währungsbeträge angibt.	CurrencyValidator
		negativeCurrencyFormatError : String Fehlermeldung, wenn das Format für negative Zahlen des Eingabewährungsstrings falsch ist.	CurrencyValidator
		negativeError : String Fehlermeldung, wenn der Wert negativ ist und die allowNegative-Eigenschaft auf false gesetzt ist.	NumberValidatorBase
		negativeSymbol : String [schreibgeschützt] Das Negativsymbol, das bei der Überprüfung negativer Werte verwendet wird.	NumberValidatorBase
		negativeSymbolError : String Fehlermeldung, wenn das Negativsymbol wiederholt wird oder an der falschen Stelle steht.	NumberValidatorBase
		nonInheritingStyles : Object Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind.	AdvancedStyleClient
		notAnIntegerError : String Fehlermeldung, wenn die Zahl eine Ganzzahl sein muss, wie in der domain-Eigenschaft definiert.	NumberValidatorBase
		parseError : String Fehlermeldung, wenn die Zahl nicht analysiert werden konnte.	NumberValidatorBase
		positiveCurrencyFormat : uint Ein numerischer Wert, der ein Überprüfungsmuster für positive Währungsbeträge angibt.	CurrencyValidator
		positiveCurrencyFormatError : String Fehlermeldung, wenn das Format für positive Währungszahlen falsch ist.	CurrencyValidator
		property : String Ein String, der den Namen der Eigenschaft des Quellobjekts angibt, das den zu prüfenden Wert enthält.	GlobalizationValidatorBase
		required : Boolean = true Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt.	GlobalizationValidatorBase
		requiredFieldError : String Fehlermeldung, wenn ein Wert fehlt und die erforderliche Eigenschaft true ist.	GlobalizationValidatorBase
		source : Object Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist.	GlobalizationValidatorBase
		styleDeclaration : CSSStyleDeclaration Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.	AdvancedStyleClient
		styleManager : IStyleManager2 [schreibgeschützt] Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.	AdvancedStyleClient
		styleName : Object Die Quelle der Stilwerte dieses Objekts.	AdvancedStyleClient
		styleParent : IAdvancedStyleClient Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet.	AdvancedStyleClient
		trigger : IEventDispatcher Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst.	GlobalizationValidatorBase
		triggerEvent : String Gibt das Ereignis an, das die Überprüfung auslöst.	GlobalizationValidatorBase

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.	GlobalizationValidatorBase
		actualTrigger : IEventDispatcher [schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.	GlobalizationValidatorBase
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	GlobalizationValidatorBase
		subFields : Array Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde.	GlobalizationValidatorBase

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		CurrencyValidator() Erstellt ein neues CurrencyValidator-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen.	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
		clearStyle(styleProp:String):void Löscht eine Stileigenschaft aus dieser Komponenteninstanz.	AdvancedStyleClient
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getClassStyleDeclarations():Array Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.	AdvancedStyleClient
		getStyle(styleProp:String):* [override] Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.	GlobalizationBase
		hasCSSState():Boolean Gibt true zurück, wenn currentCSSState ungleich null ist.	AdvancedStyleClient
		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 Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird.	AdvancedStyleClient
		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
		matchesCSSState(cssState:String):Boolean Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt.	AdvancedStyleClient
		matchesCSSType(cssType:String):Boolean Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.	AdvancedStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter.	AdvancedStyleClient
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		regenerateStyleCache(recursive:Boolean):void Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.	AdvancedStyleClient
		registerEffects(effects:Array):void Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.	AdvancedStyleClient
		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
		setStyle(styleProp:String, newValue:*):void Legt eine Stileigenschaft für diese Komponenteninstanz fest.	AdvancedStyleClient
		styleChanged(styleProp:String):void Erkennt Änderungen an Stileigenschaften.	AdvancedStyleClient
		stylesInitialized():void Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.	AdvancedStyleClient
		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.	GlobalizationValidatorBase
		validateAll(validators:Array):Array [statisch] Ruft alle Validators im Array der Validators auf.	GlobalizationValidatorBase
		validateCurrency(value:Object, baseField:String):Array Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.	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.	GlobalizationValidatorBase
		doValidation(value:Object):Array Führt die Überprüfungslogik dieses Validators aus, einschließlich der Überprüfung, ob ein fehlender oder leerer Wert einen Überprüfungsfehler verursacht, wie vom Wert der erforderlichen Eigenschaft definiert.	GlobalizationValidatorBase
		getValueFromSource():Object Gibt das zu überprüfende Objekt zurück.	GlobalizationValidatorBase
		handleResults(errorResults:Array):ValidationResultEvent Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.	GlobalizationValidatorBase
		isRealValue(value:Object):Boolean Gibt true zurück, wenn der Wert ungleich null ist.	GlobalizationValidatorBase
		removeListenerHandler():void Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.	GlobalizationValidatorBase
		resourcesChanged():void Diese Methode wird aufgerufen, wenn eine GlobalizationValidatorBase erstellt wird und jedes Mal, wenn der ResourceManager ein "change"-Ereignis auslöst, um anzugeben, dass die lokalisierten Ressourcen geändert wurden.	GlobalizationValidatorBase

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
change	Das Änderungsereignis wird immer dann generiert, wenn der Gebietsschemastil geändert oder eine andere Eigenschaft festgelegt wird, die zur Änderung des Zahlenformats oder zu Updates der anderen durch diese Klasse bereitgestellten Werte führen würde.	GlobalizationBase
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.	GlobalizationValidatorBase
valid	Wird ausgelöst, wenn eine Überprüfung erfolgreich ist.	GlobalizationValidatorBase

Stile

Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.

Allgemeine Stile

Klicken Sie, um weitere Informationen zu Stilen zu erhalten.

Vererbte Stile ausblenden

Vererbte Stile anzeigen

	Stil		Beschreibung	Definiert von
		locale	Typ: String CSS-Vererbung: Ja Sprachversion: ActionScript 3.0 Produktversion: Flex 4.5 Laufzeitversionen: Flash10.1, AIR 2.5 Die Gebietsschema-ID, die die Tags und Schlüssel für Sprache, Region und Skript sowie optional weitere entsprechende Tags und Schlüssel angibt.	GlobalizationBase

Eigenschaftendetails

currencyISOCode

Eigenschaft

currencyISOCode:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get currencyISOCode():String
public function set currencyISOCode(value:String):void

Verwandte API-Elemente

validate()
currencySymbol

currencyStringError

Eigenschaft

currencyStringError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Fehlermeldung, wenn das Währungssymbol oder der ISO-Währungscode wiederholt wird oder sich an der falschen Position befindet.

Der Standardwert ist "Currency name is repeated or not correct.".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get currencyStringError():String
public function set currencyStringError(value:String):void

currencySymbol

Eigenschaft

currencySymbol:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get currencySymbol():String
public function set currencySymbol(value:String):void

Verwandte API-Elemente

format()
setCurrency()
formattingWithCurrencySymbolIsSafe()
currencyISOCode

negativeCurrencyFormat

Eigenschaft

negativeCurrencyFormat:uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get negativeCurrencyFormat():uint
public function set negativeCurrencyFormat(value:uint):void

Auslöser

ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 15 liegt.

Verwandte API-Elemente

format()
currencySymbol
negativeSymbol

negativeCurrencyFormatError

Eigenschaft

negativeCurrencyFormatError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Fehlermeldung, wenn das Format für negative Zahlen des Eingabewährungsstrings falsch ist.

Der Standardwert ist "The negative format of the input currency is incorrect.".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get negativeCurrencyFormatError():String
public function set negativeCurrencyFormatError(value:String):void

positiveCurrencyFormat

Eigenschaft

positiveCurrencyFormat:uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get positiveCurrencyFormat():uint
public function set positiveCurrencyFormat(value:uint):void

Auslöser

ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 3 liegt.

Verwandte API-Elemente

currencySymbol
format()

positiveCurrencyFormatError

Eigenschaft

positiveCurrencyFormatError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Fehlermeldung, wenn das Format für positive Währungszahlen falsch ist.

Der Standardwert ist "The positive format of the input currency is incorrect.".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get positiveCurrencyFormatError():String
public function set positiveCurrencyFormatError(value:String):void

Konstruktordetails

()

Konstruktor

public function CurrencyValidator()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Verwandte API-Elemente

flash.globalization.CurrencyFormatter.actualLocaleIDName

Methodendetails

validateCurrency

()

Methode

public function validateCurrency(value:Object, baseField:String):Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

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.

Parameter

	`value:Object` — Ein zu überprüfender Währungszahlenstring. Der Zahlenstring kann neben ASCII-Minussymbolen Unicode-Minussymbole 0x2212, 0xFE63, 0xFF0D verwenden.

	`baseField:String` — Textdarstellung des im `value`-Parameter angegebenen Unterfelds. Wenn zum Beispiel im `value`-Parameter value.number angegeben ist, ist der `baseField`-Wert „number“.

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
flash.globalization.CurrencyFormatter

Beispiele Verwendung dieses Beispiels

CurrencyValidatorExample1.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.NumberValidator -->
<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:Declarations>
        <s:CurrencyValidator id="currencyValidator" source='{inputNumber}' 
                           property="text" trigger='{validateBtn}'
                           triggerEvent="click" />
        <s:CurrencyFormatter id="currencyFormatter" useCurrencySymbol="true" 
                           useGrouping="true"/>
    </fx:Declarations>
    
    <fx:Script>
        <![CDATA[
            [Bindable]
            private var number:Number = 123456789.12;
        ]]>
    </fx:Script>
    
    <mx:Form>
        <mx:FormItem label="Input Locale ID Name">
            <mx:HBox>
                <s:TextInput id="inputLocaleIDName" text="en-US"/>
                <!-- Upon button click, sets the locale style on the document
                UI component. The formatter will inherit this style. -->
                <s:Button click="setStyle('locale', inputLocaleIDName.text);"
                          label="Apply"/>
            </mx:HBox>
            <mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
        </mx:FormItem>
        
        <mx:FormItem label="Allow Negative">
            <mx:CheckBox id="alowNegative" selected="true"
                         change="currencyValidator.allowNegative = alowNegative.selected"/>
        </mx:FormItem>
        
        <mx:FormItem label="Fractional Digits">
            <mx:TextInput id="fractionalDigits" text='{currencyValidator.fractionalDigits}' 
                          change="currencyFormatter.fractionalDigits = 
                          currencyValidator.fractionalDigits = Number(fractionalDigits.text)"/>
        </mx:FormItem>
        
        <mx:FormItem label="Currency Symbol">
            <mx:TextInput id="currencySymbol" text='{currencyValidator.currencySymbol}' 
                          change="currencyFormatter.currencySymbol = 
                          currencyValidator.currencySymbol = currencySymbol.text"/>
        </mx:FormItem>
        
        <mx:FormItem label="Actual Locale ID Name">
            <mx:Text text="{currencyValidator.actualLocaleIDName}"/>
        </mx:FormItem>
        
        <mx:FormItem label="Enter currency amount" >
            <mx:HBox>
                <mx:TextInput id="inputNumber" />
                <mx:Button id="validateBtn" label="Validate" />
            </mx:HBox>
        </mx:FormItem>

        <mx:FormItem label="Example currency">
            <mx:Text text="{currencyFormatter.format(123456789.12)}"/>
        </mx:FormItem>
    </mx:Form>
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

CurrencyValidator - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket spark.validators

currencyISOCode

currencyStringError

currencySymbol

negativeCurrencyFormat

negativeCurrencyFormatError

positiveCurrencyFormat

positiveCurrencyFormatError

CurrencyValidator

validateCurrency