| 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
MXML-Syntax anzeigen
MXML-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):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 occur only 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 thousandsSeparator sein.
Der Standardwert ist ".".
Implementierung
public function get decimalSeparator():String public function set decimalSeparator(value:String):voiddomain | 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):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 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):voidintegerError | 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):voidinvalidCharError | 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):voidinvalidFormatCharsError | 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):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 es keinen Höchstwert gibt.
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 es keinen Mindestwert gibt.
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 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):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 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):voidthousandsSeparator | 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):voidNumberValidator | () | 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