ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
spark.validators.supportClasses 

GlobalizationValidatorBase  - AS3 Flex

Paketspark.validators.supportClasses
Klassepublic class GlobalizationValidatorBase
VererbungGlobalizationValidatorBase Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object
Implementiert IValidator
Unterklassen NumberValidatorBase

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Die GlobalizationValidatorBase-Klasse ist die Basisklasse für alle Spark-Validators. Diese Klasse implementiert die Möglichkeit, dass der Validator ein Feld erforderlich macht, d. h., dass der Benutzer in das Feld einen Wert eingeben muss, anderenfalls schlägt die Überprüfung fehl. Diese Klasse aktiviert bzw. deaktiviert auch den Validator.

MXML-SyntaxexpandedMXML-Syntax ausblenden

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

  <s:GlobalizationValidatorBase
    Properties
    enabled="true"
    listener="Value of the source property"
    property="No default"
    required="true"
    requiredFieldError="This field is required."
    source="No default"
    trigger="Value of the source property"
    triggerEvent="valueCommit"
 
    Events
    invalid="No default"
    valid="No default"
  />
  

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedactualLocaleIDName : String
[schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird.
GlobalizationBase
 InheritedclassName : String
[schreibgeschützt] Der Name der Komponentenklasse.
AdvancedStyleClient
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  enabled : Boolean
Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt.
GlobalizationValidatorBase
 Inheritedid : String
Die Identität der Komponente.
AdvancedStyleClient
 InheritedinheritingStyles : Object
Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.
AdvancedStyleClient
 InheritedlastOperationStatus : String
[schreibgeschützt] Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat.
GlobalizationBase
  listener : Object
Gibt den Überprüfungs-Listener an.
GlobalizationValidatorBase
 InheritedmoduleFactory : IFlexModuleFactory
Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.
AdvancedStyleClient
 InheritednonInheritingStyles : Object
Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind.
AdvancedStyleClient
  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
 InheritedstyleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[schreibgeschützt] Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.
AdvancedStyleClient
 InheritedstyleName : Object
Die Quelle der Stilwerte dieses Objekts.
AdvancedStyleClient
 InheritedstyleParent : 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
Geschützte Eigenschaften
 EigenschaftDefiniert von
  actualListeners : Array
[schreibgeschützt] Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt.
GlobalizationValidatorBase
  actualTrigger : IEventDispatcher
[schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.
GlobalizationValidatorBase
  resourceManager : IResourceManager
[schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.
GlobalizationValidatorBase
  subFields : Array
Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde.
GlobalizationValidatorBase
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
GlobalizationValidatorBase
 Inherited
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
 Inherited
Löscht eine Stileigenschaft aus dieser Komponenteninstanz.
AdvancedStyleClient
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.
AdvancedStyleClient
 Inherited
getStyle(styleProp:String):*
[override] Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.
GlobalizationBase
 Inherited
Gibt true zurück, wenn currentCSSState ungleich null ist.
AdvancedStyleClient
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird.
AdvancedStyleClient
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt.
AdvancedStyleClient
 Inherited
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.
AdvancedStyleClient
 Inherited
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter.
AdvancedStyleClient
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.
AdvancedStyleClient
 Inherited
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Legt eine Stileigenschaft für diese Komponenteninstanz fest.
AdvancedStyleClient
 Inherited
Erkennt Änderungen an Stileigenschaften.
AdvancedStyleClient
 Inherited
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.
AdvancedStyleClient
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
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.
GlobalizationValidatorBase
  
validateAll(validators:Array):Array
[statisch] Ruft alle Validators im Array der Validators auf.
GlobalizationValidatorBase
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 MethodeDefiniert von
  
Richtet alle Listener für die gültigen und ungültigen Ereignisse ein, die vom Validator ausgelöst werden.
GlobalizationValidatorBase
  
Führt die Überprüfungslogik dieses Validators aus, einschließlich der Überprüfung, ob ein fehlender oder leerer Wert einen Überprüfungsfehler verursacht, wie vom Wert der erforderlichen Eigenschaft definiert.
GlobalizationValidatorBase
  
Gibt das zu überprüfende Objekt zurück.
GlobalizationValidatorBase
  
Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.
GlobalizationValidatorBase
  
Gibt true zurück, wenn der Wert ungleich null ist.
GlobalizationValidatorBase
  
Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.
GlobalizationValidatorBase
  
Diese Methode wird aufgerufen, wenn eine GlobalizationValidatorBase erstellt wird und jedes Mal, wenn der ResourceManager ein "change"-Ereignis auslöst, um anzugeben, dass die lokalisierten Ressourcen geändert wurden.
GlobalizationValidatorBase
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedDas Änderungsereignis wird immer dann generiert, wenn der Gebietsschemastil geändert oder eine andere Eigenschaft festgelegt wird, die zur Änderung des Zahlenformats oder zu Updates der anderen durch diese Klasse bereitgestellten Werte führen würde.GlobalizationBase
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  Wird ausgelöst, wenn eine Überprüfung fehlschlägt.GlobalizationValidatorBase
  Wird ausgelöst, wenn eine Überprüfung erfolgreich ist.GlobalizationValidatorBase
Stile

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.

Allgemeine Stile
 Stil Beschreibung Definiert von
 InheritedTyp: String CSS-Vererbung: Ja
Sprachversion: ActionScript 3.0  Produktversion: Flex 4.5  Laufzeitversionen: Flash10.1, AIR 2.5

Die Gebietsschema-ID, die die Tags und Schlüssel für Sprache, Region und Skript sowie optional weitere entsprechende Tags und Schlüssel angibt.
GlobalizationBase
Eigenschaftendetails

actualListeners

Eigenschaft
actualListeners:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt. Wird verwendet, um zu bestimmen, welchem Objekt das Überprüfungsergebnis mitzuteilen ist



Implementierung
    protected function get actualListeners():Array

actualTrigger

Eigenschaft 
actualTrigger:IEventDispatcher  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt. Wird verwendet, um zu bestimmen, welchem Objekt das triggerEvent mitgeteilt werden soll.



Implementierung
    protected function get actualTrigger():IEventDispatcher

enabled

Eigenschaft 
enabled:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt. Wenn ein Validator deaktiviert ist, werden keine Ereignisse ausgelöst und die validate()-Methode gibt null zurück.

Der Standardwert ist true.



Implementierung
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void

listener

Eigenschaft 
listener:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt den Überprüfungs-Listener an.

Wird kein Listener angegeben, verwendet Flex den Wert der source-Eigenschaft. Nachdem Flex die Quellkomponente bestimmt hat, wird die Rahmenfarbe der Komponente geändert und eine Fehlermeldung angezeigt bzw. eine bestehende Fehlermeldung für eine erfolgreiche Überprüfung ausgeblendet.



Implementierung
    public function get listener():Object
    public function set listener(value:Object):void

property

Eigenschaft 
property:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Ein String, der den Namen der Eigenschaft des source-Objekts angibt, das den zu prüfenden Wert enthält. Diese Eigenschaft ist optional, aber wenn Sie die source-Eigenschaft angeben, sollten Sie auch einen Wert für diese Eigenschaft einstellen.

Der Standardwert ist null.



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

required

Eigenschaft 
public var required:Boolean = true

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt.

Der Standardwert ist true.

requiredFieldError

Eigenschaft 
requiredFieldError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Fehlermeldung, wenn ein Wert fehlt und die required-Eigenschaft true ist.

Der Standardwert ist "This field is required.".



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

resourceManager

Eigenschaft 
resourceManager:IResourceManager  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet. Dabei handelt es sich um eine Singleton-Instanz, die die IResourceManager-Schnittstelle implementiert.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das unused -Ereignis ausgelöst.



Implementierung
    protected function get resourceManager():IResourceManager

source

Eigenschaft 
source:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist. Setzt dies auf eine Instanz einer Komponente oder eines Datenmodells. Verwenden Sie Datenbindungssyntax in MXML, um den Wert anzugeben. Diese Eigenschaft unterstützt durch Punkte getrennte Strings zur Angabe verschachtelter Eigenschaften. Wenn Sie für die source-Eigenschaft einen Wert angeben, sollten Sie auch einen Wert für die property-Eigenschaft angeben. Die source-Eigenschaft ist optional.

Der Standardwert ist null.



Implementierung
    public function get source():Object
    public function set source(value:Object):void

subFields

Eigenschaft 
protected var subFields:Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde. CreditCardValidator setzt diese Eigenschaft z. B. auf [ "cardNumber", "cardType" ]. Dieser Wert bedeutet, dass das value-Objekt, das der validate()-Methode übergeben wurde, eine cardNumber- und eine cardType-Eigenschaft enthalten sollte.

trigger

Eigenschaft 
trigger:IEventDispatcher

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst. Wenn unterdrückt, verwendet Flex standardmäßig diesen Wert der source-Eigenschaft. Wenn der trigger eine triggerEvent-Überprüfung auslöst.



Implementierung
    public function get trigger():IEventDispatcher
    public function set trigger(value:IEventDispatcher):void

triggerEvent

Eigenschaft 
triggerEvent:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt das Ereignis an, das die Überprüfung auslöst. Wenn es fehlt, verwendet Flex das valueCommit-Ereignis. Flex löst das valueCommit-Ereignis aus, wenn ein Benutzer eine Dateneingabe in ein Steuerelement abschließt. Dies ist normalerweise der Fall, wenn der Benutzer die Komponente ausblendet oder wenn ein Eigenschaftswert programmgesteuert geändert wird. Wenn Sie möchten, dass alle Ereignisse ignoriert werden, setzen Sie triggerEvent auf einen leeren String.



Implementierung
    public function get triggerEvent():String
    public function set triggerEvent(value:String):void
Konstruktordetails

GlobalizationValidatorBase

()Konstruktor
public function GlobalizationValidatorBase()

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Konstruktor.

Methodendetails

addListenerHandler

()Methode
protected function addListenerHandler():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Richtet alle Listener für die valid und invalid Ereignisse ein, die vom Validator ausgelöst werden. Unterklassen der GlobalizationValidatorBase-Klasse sollten zunächst die removeListenerHandler()-Methode und dann die addListenerHandler()-Methode aufrufen, wenn der Wert eines Listeners oder einer Quelle geändert wurde. Die CreditCardValidator- und DateValidator-Klassen verwenden diese Funktion intern.

doValidation

()Methode 
protected function doValidation(value:Object):Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Führt die Überprüfungslogik dieses Validators aus, einschließlich der Überprüfung, ob ein fehlender oder leerer Wert einen Überprüfungsfehler verursacht, wie vom Wert der required-Eigenschaft definiert.

Wenn Sie eine Validator-Unterklasse erstellen, müssen Sie diese Methode überschreiben.

Parameter

value:Object — Zu überprüfender Wert.

Rückgabewerte
Array — Für ein ungültiges Ergebnis: ein Array von ValidationResult-Objekten mit einem ValidationResult-Objekt für jedes vom Validator geprüfte Feld, bei dem die Überprüfung fehlschlug.

Verwandte API-Elemente

getValueFromSource

()Methode 
protected function getValueFromSource():Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt das zu überprüfende Objekt zurück.

Rückgabewerte
Object — Das zu überprüfende Objekt.

handleResults

()Methode 
protected function handleResults(errorResults:Array):ValidationResultEvent

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück. Intern entnimmt diese Funktion die Ergebnisse der doValidation()-Methode und stellt sie in ein ValidationResultEvent-Objekt. Diese Funktion wird nie direkt aufgerufen und sollte nur ausnahmesweise überschrieben werden.

Parameter

errorResults:Array — Array von ValidationResult-Objekten.

Rückgabewerte
ValidationResultEvent — Das von der validate()-Methode zurückgegebene ValidationResultEvent.

isRealValue

()Methode 
protected function isRealValue(value:Object):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Gibt true zurück, wenn value ungleich null ist.

Parameter

value:Object — Der zu testende Wert.

Rückgabewerte
Booleantrue, wenn value ungleich null ist.

removeListenerHandler

()Methode 
protected function removeListenerHandler():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Trennt alle Listener für die valid- und invalid-Ereignisse, die vom Validator ausgelöst werden. Unterklassen sollten zuerst die removeListenerHandler()-Methode und dann die addListenerHandler()-Methode aufrufen, wenn der Wert eines Listeners oder einer Quelle geändert wurde. Die CreditCardValidator- und DateValidator-Klassen verwenden diese Funktion intern.

resourcesChanged

()Methode 
protected function resourcesChanged():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Diese Methode wird aufgerufen, wenn eine GlobalizationValidatorBase erstellt wird und jedes Mal, wenn der ResourceManager ein "change"-Ereignis auslöst, um anzugeben, dass die lokalisierten Ressourcen geändert wurden.

Dieses Ereignis wird ausgelöst, wenn Sie die localeChain-Eigenschaft des ResourceManager setzen, wenn ein Ressourcenmodul den Ladevorgang abgeschlossen hat und wenn Sie die update()-Methode des ResourceManager aufrufen.

Unterklassen sollten diese Methode überschreiben und nach dem Aufruf von super.resourcesChanged() einen als Antwort auf die neuen Ressourcenwerte angemessenen Vorgang ausführen.

validate

()Methode 
public function validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit.

Parameter

value:Object (default = null) — Optionaler zu überprüfender Wert. Wenn null, verwendet der Validator die source- und property-Eigenschaften, um den Wert zu bestimmen. Wenn Sie dieses Argument angeben, sollten Sie auch die listener-Eigenschaft setzen, um die Zielkomponente für alle Überprüfungsfehlermeldungen anzugeben.
 
suppressEvents:Boolean (default = false) — Wenn false, wird nach der Überprüfung dem Listener das Ergebnis mitgeteilt.

Rückgabewerte
ValidationResultEvent — Das ValidationResultEvent-Objekt, das die Ergebnisse der Überprüfung enthält. Für eine erfolgreiche Überprüfung ist die ValidationResultEvent.results-Array-Eigenschaft leer. Für einen Überprüfungsfehler enthält die ValidationResultEvent.results-Array-Eigenschaft ein ValidationResult-Objekt für jedes vom Validator geprüfte Feld – unabhängig vom Ergebnis der Prüfung. Überprüfen Sie die ValidationResult.isError-Eigenschaft, um zu bestimmen, ob die Prüfung erfolgreich verlief oder nicht.

Verwandte API-Elemente

validateAll

()Methode 
public static function validateAll(validators:Array):Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Ruft alle Validators im Array der validators auf. Gibt ein Array zurück, das für jede fehlgeschlagene Überprüfung ein ValidationResultEvent-Objekt enthält. Gibt ein leeres Array zurück, wenn alle Überprüfungen erfolgreich abgeschlossen wurden.

Parameter

validators:Array — Ein Array, das die auszuführenden GlobalizationValidatorBase-Objekte enthält.

Rückgabewerte
Array — Array von ValidationResultEvent-Objekten, wobei das Array für jede fehlgeschlagene Überprüfung ein ValidationResultEvent-Objekt enthält. Das Array ist leer, wenn alle Überprüfungen erfolgreich abgeschlossen wurden.
Ereignisdetails

invalid

Ereignis
Ereignisobjekttyp: mx.events.ValidationResultEvent
Eigenschaft ValidationResultEvent.type = mx.events.ValidationResultEvent.INVALID

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Wird ausgelöst, wenn eine Überprüfung fehlschlägt.

Die ValidationResultEvent.INVALID-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein invalid-Ereignis. Der Wert dieser Konstante ist „invalid“.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
fieldDer Name des Felds, bei dem die Überprüfung fehlschlug.
messageEin einzelner String, der alle Fehlermeldungen der ValidationResult-Objekte im Ergebnisarray enthält.
resultsEin Array von ValidationResult-Objekten, ein Objekt pro validiertes Feld.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

valid

Ereignis  
Ereignisobjekttyp: mx.events.ValidationResultEvent
Eigenschaft ValidationResultEvent.type = mx.events.ValidationResultEvent.VALID

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Wird ausgelöst, wenn eine Überprüfung erfolgreich ist.

Die ValidationResultEvent.VALID-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein valid-Ereignis. Der Wert dieser Konstante ist „valid“.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
fieldEin leerer String.
messageEin leerer String.
resultsEin leeres Array.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.