Pakiet | mx.validators |
Klasa | public class CurrencyValidator |
Dziedziczenie | CurrencyValidator Validator EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Począwszy od Flex 4.5 firma Adobe zaleca użycie klasy spark.validators.CurrencyValidator jako zamiennika tej klasy. |
The CurrencyValidator class ensures that a String represents a valid currency expression. It can make sure the input falls within a given range (specified by
minValue
and maxValue
),
is non-negative (specified by allowNegative
),
and does not exceed the specified precision
. The
CurrencyValidator class correctly validates formatted and unformatted
currency expressions, e.g., "$12,345.00" and "12345".
You can customize the currencySymbol
, alignSymbol
,
thousandsSeparator
, and decimalSeparator
properties for internationalization.
Składnia MXMLUkryj składnię MXMLThe <mx:CurrencyValidator>
tag
inherits all of the tag properties of its superclass,
and adds the following tag properties:
<mx:CurrencyValidator alignSymbol="left|right|any" allowNegative="true|false" currencySymbol="$" currencySymbolError="The currency symbol occurs in an invalid location." decimalPointCountError="The decimal separator can occur only once." decimalSeparator="." exceedsMaxError="The amount entered is too large." 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="2" precisionError="The amount entered has too many digits beyond the decimal point." separationError="The thousands separator must be followed by three digits." thousandsSeparator="," />
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
alignSymbol : String
Specifies the alignment of the currencySymbol
relative to the rest of the expression. | CurrencyValidator | ||
allowNegative : Object
Specifies whether negative numbers are permitted. | CurrencyValidator | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
currencySymbol : String
The character String used to specify the currency symbol,
such as "$", "R$", or "£". | CurrencyValidator | ||
currencySymbolError : String
Error message when the currency symbol, defined by currencySymbol,
is in the wrong location. | CurrencyValidator | ||
decimalPointCountError : String
Error message when the decimal separator character occurs more than once. | CurrencyValidator | ||
decimalSeparator : String
The character used to separate the whole
from the fractional part of the number. | CurrencyValidator | ||
enabled : Boolean
Setting this value to false will stop the validator
from performing validation. | Validator | ||
exceedsMaxError : String
Error message when the value is greater than maxValue. | CurrencyValidator | ||
invalidCharError : String
Error message when the currency contains invalid characters. | CurrencyValidator | ||
invalidFormatCharsError : String
Error message when the value contains an invalid formatting character. | CurrencyValidator | ||
listener : Object
Specifies the validation listener. | Validator | ||
lowerThanMinError : String
Error message when the value is less than minValue. | CurrencyValidator | ||
maxValue : Object
Maximum value for a valid number. | CurrencyValidator | ||
minValue : Object
Minimum value for a valid number. | CurrencyValidator | ||
negativeError : String
Error message when the value is negative and
the allowNegative property is false. | CurrencyValidator | ||
precision : Object
The maximum number of digits allowed to follow the decimal point. | CurrencyValidator | ||
precisionError : String
Error message when the value has a precision that exceeds the value
defined by the precision property. | CurrencyValidator | ||
property : String
A String specifying the name of the property
of the source object that contains
the value to validate. | Validator | ||
required : Boolean = true
If true, specifies that a missing or empty
value causes a validation error. | Validator | ||
requiredFieldError : String
Error message when a value is missing and the
required property is true. | Validator | ||
separationError : String
Error message when the thousands separator is incorrectly placed. | CurrencyValidator | ||
source : Object
Specifies the object containing the property to validate. | Validator | ||
thousandsSeparator : String
The character used to separate thousands. | CurrencyValidator | ||
trigger : IEventDispatcher
Specifies the component generating the event that triggers the validator. | Validator | ||
triggerEvent : String
Specifies the event that triggers the validation. | Validator |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Constructor. | CurrencyValidator | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Called automatically by the MXML compiler when the Validator
is created using an MXML tag. | Validator | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Performs validation and optionally notifies
the listeners of the result. | Validator | ||
[statyczny]
Invokes all the validators in the validators Array. | Validator | ||
[statyczny]
Convenience method for calling a validator. | CurrencyValidator | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Sets up all of the listeners for the
valid and invalid
events dispatched from the validator. | Validator | ||
[przesłanianie]
Override of the base class doValidation() method
to validate a currency expression. | CurrencyValidator | ||
Returns the Object to validate. | Validator | ||
Returns a ValidationResultEvent from the Array of error results. | Validator | ||
Returns true if value is not null. | Validator | ||
Disconnects all of the listeners for the
valid and invalid
events dispatched from the validator. | Validator | ||
This method is called when a Validator is constructed,
and again whenever the ResourceManager dispatches
a "change" Event to indicate
that the localized resources have changed in some way. | Validator |
alignSymbol | właściwość |
alignSymbol:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Specifies the alignment of the currencySymbol
relative to the rest of the expression.
Acceptable values in ActionScript are CurrencyValidatorAlignSymbol.LEFT
,
CurrencyValidatorAlignSymbol.RIGHT
, and
CurrencyValidatorAlignSymbol.ANY
.
Acceptable values in MXML are "left"
,
"right"
, and
"any"
.
Wartością domyślną jest CurrencyValidatorAlignSymbol.LEFT.
Implementacja
public function get alignSymbol():String
public function set alignSymbol(value:String):void
Powiązane elementy interfejsu API
allowNegative | właściwość |
allowNegative:Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Specifies whether negative numbers are permitted.
Can be true
or false
.
Wartością domyślną jest true.
Implementacja
public function get allowNegative():Object
public function set allowNegative(value:Object):void
currencySymbol | właściwość |
currencySymbol:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
The character String used to specify the currency symbol,
such as "$", "R$", or "£".
Cannot be a digit and must be distinct from the
thousandsSeparator
and the decimalSeparator
.
Wartością domyślną jest "$".
Implementacja
public function get currencySymbol():String
public function set currencySymbol(value:String):void
currencySymbolError | właściwość |
currencySymbolError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the currency symbol, defined by currencySymbol
,
is in the wrong location.
Wartością domyślną jest "The currency symbol occurs in an invalid location.".
Implementacja
public function get currencySymbolError():String
public function set currencySymbolError(value:String):void
decimalPointCountError | właściwość |
decimalPointCountError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the decimal separator character occurs more than once.
Wartością domyślną jest "The decimal separator can only occur once.".
Implementacja
public function get decimalPointCountError():String
public function set decimalPointCountError(value:String):void
decimalSeparator | właściwość |
decimalSeparator:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
The character used to separate the whole
from the fractional part of the number.
Cannot be a digit and must be distinct from the
currencySymbol
and the thousandsSeparator
.
Wartością domyślną jest ".".
Implementacja
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void
exceedsMaxError | właściwość |
exceedsMaxError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the value is greater than maxValue
.
Wartością domyślną jest "The amount entered is too large.".
Implementacja
public function get exceedsMaxError():String
public function set exceedsMaxError(value:String):void
invalidCharError | właściwość |
invalidCharError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the currency contains invalid characters.
Wartością domyślną jest "The input contains invalid characters.".
Implementacja
public function get invalidCharError():String
public function set invalidCharError(value:String):void
invalidFormatCharsError | właściwość |
invalidFormatCharsError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the value contains an invalid formatting character.
Wartością domyślną jest "One of the formatting parameters is invalid.".
Implementacja
public function get invalidFormatCharsError():String
public function set invalidFormatCharsError(value:String):void
lowerThanMinError | właściwość |
lowerThanMinError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the value is less than minValue
.
Wartością domyślną jest "The amount entered is too small.".
Implementacja
public function get lowerThanMinError():String
public function set lowerThanMinError(value:String):void
maxValue | właściwość |
maxValue:Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Maximum value for a valid number. A value of NaN means it is ignored.
Wartością domyślną jest NaN.
Implementacja
public function get maxValue():Object
public function set maxValue(value:Object):void
minValue | właściwość |
minValue:Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Minimum value for a valid number. A value of NaN means it is ignored.
Wartością domyślną jest NaN.
Implementacja
public function get minValue():Object
public function set minValue(value:Object):void
negativeError | właściwość |
negativeError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the value is negative and
the allowNegative
property is false
.
Wartością domyślną jest "The amount may not be negative.".
Implementacja
public function get negativeError():String
public function set negativeError(value:String):void
precision | właściwość |
precision:Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
The maximum number of digits allowed to follow the decimal point.
Can be any non-negative integer.
Note: Setting to 0
has the same effect as setting NumberValidator.domain
to int
.
Setting it to -1, means it is ignored.
Wartością domyślną jest 2.
Implementacja
public function get precision():Object
public function set precision(value:Object):void
precisionError | właściwość |
precisionError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the value has a precision that exceeds the value
defined by the precision
property.
Wartością domyślną jest "The amount entered has too many digits beyond the decimal point.".
Implementacja
public function get precisionError():String
public function set precisionError(value:String):void
separationError | właściwość |
separationError:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Error message when the thousands separator is incorrectly placed.
Wartością domyślną jest "The thousands separator must be followed by three digits.".
Implementacja
public function get separationError():String
public function set separationError(value:String):void
thousandsSeparator | właściwość |
thousandsSeparator:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
The character used to separate thousands.
Cannot be a digit and must be distinct from the
currencySymbol
and the decimalSeparator
.
Wartością domyślną jest ",".
Implementacja
public function get thousandsSeparator():String
public function set thousandsSeparator(value:String):void
CurrencyValidator | () | Konstruktor |
public function CurrencyValidator()
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Constructor.
doValidation | () | metoda |
override protected function doValidation(value:Object):Array
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Override of the base class doValidation()
method
to validate a currency expression.
You do not call this method directly; Flex calls it as part of performing a validation. If you create a custom Validator class, you must implement this method.
Parametry
value:Object — Object to validate.
|
Array — An Array of ValidationResult objects, with one ValidationResult
object for each field examined by the validator.
|
validateCurrency | () | metoda |
public static function validateCurrency(validator:CurrencyValidator, value:Object, baseField:String):Array
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Convenience method for calling a validator. Each of the standard Flex validators has a similar convenience method.
Parametry
validator:CurrencyValidator — The CurrencyValidator instance.
| |
value:Object — The object to validate.
| |
baseField:String — Text representation of the subfield
specified in the value parameter.
For example, if the value parameter specifies value.currency,
the baseField value is "currency".
|
Array — An Array of ValidationResult objects, with one ValidationResult
object for each field examined by the validator.
|
Powiązane elementy interfejsu API
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the CurrencyValidator. --> <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:CurrencyValidator source="{priceUS}" property="text" precision="2" trigger="{myButton}" triggerEvent="click" valid="Alert.show('Validation Succeeded!');"/> </fx:Declarations> <s:Panel title="CurrencyValidator Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <mx:Form left="10" right="10" top="10" bottom="10"> <mx:FormItem label="Enter a U.S. dollar amount: "> <s:TextInput id="priceUS" width="100%"/> </mx:FormItem> <mx:FormItem > <s:Button id="myButton" label="Validate"/> </mx:FormItem> </mx:Form> </s:Panel> </s:Application>
Tue Jun 12 2018, 12:06 PM Z