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-SyntaxMXML-Syntax ausblendenThe <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="," />
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 |
Methode | Definiert von | ||
---|---|---|---|
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 | ||
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 aus einer benutzerdefinierten Überprüfungsfunktion. | NumberValidator | ||
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 einer Zahl. | NumberValidator | ||
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 |
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
NumberValidator | () | Konstruktor |
public function NumberValidator()
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 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.
|
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“.
|
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 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>
Tue Jun 12 2018, 10:04 AM Z