NumberValidator

Paket	mx.validators
Klasse	public class NumberValidator
Vererbung	NumberValidator 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.NumberValidator als Alternative zu dieser Klasse.

Die NumberValidator-Klasse stellt sicher, dass ein String eine gültige Zahl darstellt. Sie kann sicherstellen, dass die Eingabe innerhalb eines bestimmten Bereichs (zwischen minValue und maxValue) liegt, eine Ganzzahl ist (festgelegt durch domain), nicht negativ ist (festgelegt durch allowNegative) und die angegebene precision nicht überschreitet. Der Validator überprüft formatierte Zahlen (z. B. „12.345,67“) und Sie können die thousandsSeparator und decimalSeparator-Eigenschaften für die Internationalisierung anpassen.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <mx:NumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:NumberValidator 
    allowNegative="true|false" 
    decimalPointCountError="The decimal separator can only occur once." 
    decimalSeparator="." 
    domain="real|int" 
    exceedsMaxError="The number entered is too large." 
    integerError="The number must be an integer." 
    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="-1" 
    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

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		allowNegative : Object Gibt an, ob negative Zahlen zulässig sind.	NumberValidator
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		decimalPointCountError : String Fehlermeldung, wenn das Dezimaltrennzeichen mehr als einmal vorkommt.	NumberValidator
		decimalSeparator : String Das Zeichen, das die Ganzzahl vom Bruchteil der Zahl trennt.	NumberValidator
		domain : String Zu überprüfender Zahlentyp.	NumberValidator
		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 die maxValue-Eigenschaft ist.	NumberValidator
		integerError : String Fehlermeldung, wenn die Zahl eine Ganzzahl sein muss, wie in der domain-Eigenschaft definiert.	NumberValidator
		invalidCharError : String Fehlermeldung, wenn der Wert ungültige Zeichen enthält.	NumberValidator
		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.	NumberValidator
		listener : Object Gibt den Überprüfungs-Listener an.	Validator
		lowerThanMinError : String Fehlermeldung, wenn der Wert kleiner als der minValue ist.	NumberValidator
		maxValue : Object Höchstwert für eine gültige Zahl.	NumberValidator
		minValue : Object Mindestwert für eine gültige Zahl.	NumberValidator
		negativeError : String Fehlermeldung, wenn der Wert negativ ist und die allowNegative-Eigenschaft auf false gesetzt ist.	NumberValidator
		precision : Object Die maximale zulässige Anzahl von Ziffern nach dem Dezimalzeichen.	NumberValidator
		precisionError : String Fehlermeldung, wenn die Genauigkeit des Werts den in der precision-Eigenschaft angegebenen Wert überschreitet.	NumberValidator
		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 sich das Tausendertrennzeichen in einer falschen Position befindet.	NumberValidator
		source : Object Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist.	Validator
		thousandsSeparator : String Das Zeichen, das zur Trennung der Tausender in der Ganzzahl dient.	NumberValidator
		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
		NumberValidator() Konstruktor.	NumberValidator
		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
		validateNumber(validator:NumberValidator, value:Object, baseField:String):Array [statisch] Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.	NumberValidator
		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 einer Zahl.	NumberValidator
		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

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. Gültige Werte sind true oder false.

Der Standardwert ist true.

Implementierung
public function get allowNegative():Object
public function set allowNegative(value:Object):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 occur only 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 thousandsSeparator sein.

Der Standardwert ist ".".

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

domain

Eigenschaft

domain:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Zu überprüfender Zahlentyp. Zulässige Werte sind "real" und "int".

In ActionScript können Sie die folgenden Konstanten zum Festlegen dieser Eigenschaft verwenden: NumberValidatorDomainType.REAL oder NumberValidatorDomainType.INT.

Der Standardwert ist "real".

Implementierung
public function get domain():String
public function set domain(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 die maxValue-Eigenschaft ist.

Der Standardwert ist "The number entered is too large.".

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

integerError

Eigenschaft

integerError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die Zahl eine Ganzzahl sein muss, wie in der domain-Eigenschaft definiert.

Der Standardwert ist "The number must be an integer.".

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

invalidCharError

Eigenschaft

invalidCharError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn der Wert 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 ungültige Formatzeichen enthält, d. h. er enthält eine Ziffer oder ein Minuszeichen (-) als Trennzeichen bzw. zwei oder mehr aufeinanderfolgende Trennzeichen.

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 es keinen Höchstwert gibt.

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 es keinen Mindestwert gibt.

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 domain auf "int". Der Wert -1 bedeutet, dass die Eigenschaft ignoriert wird.

Der Standardwert ist -1.

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 sich das Tausendertrennzeichen in einer falschen Position befindet.

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 zur Trennung der Tausender in der Ganzzahl dient. Darf keine Ziffer sein und muss verschieden vom decimalSeparator sein.

Der Standardwert ist ",".

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

Konstruktordetails

()

Konstruktor

public function NumberValidator()

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 einer Zahl.

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.

validateNumber

()

Methode

public static function validateNumber(validator:NumberValidator, value:Object, baseField:String):Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode.

Parameter

	`validator:NumberValidator` — Die NumberValidator-Instanz.

	`value:Object` — Ein zu überprüfendes Feld.

	`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

Beispiele Verwendung dieses Beispiels

NumberValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the 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:Script>
        import mx.controls.Alert;
    </fx:Script>

    <fx:Declarations>
        <mx:NumberValidator source="{age}" property="text" integerError="Enter Integer value"
                minValue="18" maxValue="50" domain="int" 
                trigger="{myButton}" triggerEvent="click"
                valid="Alert.show('Validation Succeeded!');"
                invalid="Alert.show('Validation failed!');"/>
    </fx:Declarations>

    <s:Panel title="NumberValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter an age between 18 and 50:">
                <s:TextInput id="age" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

NumberValidator - AS3 Flex

Klassen x

allowNegative

decimalPointCountError

decimalSeparator

domain

exceedsMaxError

integerError

invalidCharError

invalidFormatCharsError

lowerThanMinError

maxValue

minValue

negativeError

precision

precisionError

separationError

thousandsSeparator