Paket | spark.validators |
Klasse | public class NumberValidator |
Vererbung | NumberValidator NumberValidatorBase GlobalizationValidatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
int
-, uint
- und Number
-Objekte darstellen.
Diese Klasse verwendet den locale
-Stil zum Festlegen der angeforderten Gebietsschema-ID.
Der Validator kann sicherstellen, dass die Eingabe 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 und nicht die festgelegte Anzahl von fractionalDigits
überschreitet. Der Validator legt Standardeigenschaftswerte unter Verwendung von flash.globalization.NumberFormatter
fest; daher werden die gebietsschemaspezifischen Werte vom Betriebssystem bereitgestellt.
Die NumberValidator
-Klasse kann in MXML-Deklarationen oder in ActionScript-Code verwendet werden. Diese Klasse verwendet den Gebietsschemastil zur Angabe der von der flash.globalization.NumberFormatter
-Klasse angeforderten Gebietsschema-ID und hat Methoden und Eigenschaften, die bindbar sind.
The <spark:NumberValidator>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:NumberValidator Properties negativeNumberFormat="locale specified string or customized by user." negativeNumberFormatError="The negative format of the input number is incorrect." />
Verwandte API-Elemente
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 | ||
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 | ||
negativeError : String
Fehlermeldung, wenn der Wert negativ ist und die allowNegative-Eigenschaft auf false gesetzt ist. | NumberValidatorBase | ||
negativeNumberFormat : uint
Ein numerischer Wert, der ein Überprüfungsmuster für negative Zahlen angibt. | NumberValidator | ||
negativeNumberFormatError : String
Fehlermeldung, wenn das Format für negative Zahlen der Eingabezahl nicht dem von der negativeNumberFormat-Eigenschaft festgelegten Muster folgt. | NumberValidator | ||
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 | ||
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 |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein neues NumberValidator-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen. | 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 | ||
Löscht eine Stileigenschaft aus dieser Komponenteninstanz. | AdvancedStyleClient | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert. | AdvancedStyleClient | ||
[override]
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist. | GlobalizationBase | ||
Gibt true zurück, wenn currentCSSState ungleich null ist. | AdvancedStyleClient | ||
Ü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 | ||
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird. | AdvancedStyleClient | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt. | AdvancedStyleClient | ||
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist. | AdvancedStyleClient | ||
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter. | AdvancedStyleClient | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert. | AdvancedStyleClient | ||
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis. | AdvancedStyleClient | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt eine Stileigenschaft für diese Komponenteninstanz fest. | AdvancedStyleClient | ||
Erkennt Änderungen an Stileigenschaften. | AdvancedStyleClient | ||
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden. | AdvancedStyleClient | ||
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. | GlobalizationValidatorBase | ||
[statisch]
Ruft alle Validators im Array der Validators auf. | GlobalizationValidatorBase | ||
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 |
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.
negativeNumberFormat | Eigenschaft |
negativeNumberFormat: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 Zahlen angibt. Dieses Muster definiert die Position des Negativsymbols oder der Klammern in Relation zum numerischen Teil der zu überprüfenden Zahl.
In der folgenden Tabelle sind die möglichen Formate für negative Zahlen aufgeführt. Wenn eine negative Zahl überprüft wird, stellt das Minuszeichen den Wert der negativeSymbol
-Eigenschaft und das Zeichen „n“ den numerischen Wert dar.
Formattyp für negative Zahlen | Format |
0 | (n) |
1 | -n |
2 | - n |
3 | n- |
4 | n - |
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 negativeNumberFormat():uint
public function set negativeNumberFormat(value:uint):void
Auslöser
ArgumentError — wenn der zugewiesene Wert keine Zahl zwischen 0 und 4 ist.
|
Verwandte API-Elemente
negativeNumberFormatError | Eigenschaft |
negativeNumberFormatError: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 der Eingabezahl nicht dem von der negativeNumberFormat-Eigenschaft festgelegten Muster folgt.
Der Standardwert ist "The negative format of the input number 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 negativeNumberFormatError():String
public function set negativeNumberFormatError(value:String):void
NumberValidator | () | Konstruktor |
public function NumberValidator()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Erstellt ein neues NumberValidator-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu überprüfen.
Das Gebietsschema für diese Klasse wird vom Gebietsschema
-Stil bereitgestellt. Der Gebietsschema
-Stil kann auf verschiedene Arten festgelegt werden:
-
Übernehmen des Stils aus einer
UIComponent
, indem dieaddStyleClient
-Methode derUIComponent
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:NumberValidator id="nv" /> </fx:Declarations>
-
Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen.
<fx:Declarations> <s:NumberValidator id="nv_French_France" locale="fr_FR" /> </fx:Declarations>
-
Aufrufen der
setStyle
-Methode. Beispiel:nv.setStyle("locale", "fr-FR")
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.
validateNumber | () | Methode |
public function validateNumber(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 Zahlenstring.
| |
baseField:String — Textdarstellung des im value -Objekt 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"?> <!-- 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:NumberValidator id="numberValidator" source='{inputNumber}' property="text" trigger='{validateBtn}' triggerEvent="click" /> <s:NumberFormatter id="numberFormatter" 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="numberValidator.allowNegative = alowNegative.selected"/> </mx:FormItem> <mx:FormItem label="Fractional Digits"> <mx:TextInput id="fractionalDigits" text='{numberValidator.fractionalDigits}' change="numberFormatter.fractionalDigits = numberValidator.fractionalDigits = Number(fractionalDigits.text)"/> </mx:FormItem> <mx:FormItem label="Actual Locale ID Name"> <mx:Text text="{numberValidator.actualLocaleIDName}"/> </mx:FormItem> <mx:FormItem label="Input number" > <mx:HBox> <mx:TextInput id="inputNumber" /> <mx:Button id="validateBtn" label="Validate" /> </mx:HBox> </mx:FormItem> <mx:FormItem label="Example number"> <mx:Text text="{numberFormatter.format(123456789.12)}"/> </mx:FormItem> </mx:Form> </s:Application>
Tue Jun 12 2018, 10:04 AM Z