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...
mx.validators 

RegExpValidator  - AS3 Flex

Paketmx.validators
Klassepublic class RegExpValidator
VererbungRegExpValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Mit der RegExpValidator-Klasse kann ein regulärer Ausdruck zur Überprüfung eines Felds verwendet werden. Sie übergeben dem Validator einen regulären Ausdruck mithilfe der expression-Eigenschaft und unter Verwendung der flags-Eigenschaft zusätzliche Flags zur Steuerung der Übereinstimmung des regulären Ausdrucksmusters.

Die Überprüfung ist erfolgreich, wenn der Validator im zu überprüfenden Feld eine Übereinstimmung für den regulären Ausdruck findet. Ein Überprüfungsfehler wird ausgegeben, wenn der Validator kein Ergebnis findet.

Die RegExpValidator-Klasse löst die valid- und invalid-Ereignisse aus. Für ein invalid-Ereignis ist das Ereignisobjekt eine Instanz der ValidationResultEvent-Klasse und enthält ein Array von ValidationResult-Objekten.

Für ein valid-Ereignis hingegen enthält das ValidationResultEvent-Objekt ein Array von RegExpValidationResult-Objekten. Die RegExpValidationResult-Klasse ist eine Unterklasse der ValidationResult-Klasse und enthält zusätzliche Eigenschaften, die mit regulären Ausdrücken verwendet werden, einschließlich den folgenden:

  • matchedIndex Eine Ganzzahl, die die Anfangsindexposition im Eingabestring der Übereinstimmung enthält.
  • matchedString Ein String, der den untergeordneten String eines Eingabestrings enthält, der mit dem regulären Ausdruck übereinstimmt.
  • matchedSubStrings Ein Stringarray, das (wenn überhaupt) übereinstimmende untergeordnete Strings in Klammern enthält. Wenn keine übereinstimmenden untergeordneten Strings gefunden werden, ist die Länge dieses Arrays 0. Verwenden Sie matchedSubStrings[0], um auf die erste Übereinstimmung eines untergeordneten Strings zuzugreifen.

MXML-SyntaxexpandedMXML-Syntax ausblenden

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

  <mx:RegExpValidator
    expression="No default" 
    flags="No default" 
    noExpressionError="The expression is missing." 
    noMatchError="The field is invalid." 
  />
  

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedenabled : Boolean
Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt.
Validator
  expression : String
Der für die Überprüfung zu verwendende reguläre Ausdruck.
RegExpValidator
  flags : String
Die für die Überprüfung zu verwendenden Flags des regulären Ausdrucks.
RegExpValidator
 Inheritedlistener : Object
Gibt den Überprüfungs-Listener an.
Validator
  noExpressionError : String
Fehlermeldung, wenn kein regulärer Ausdruck angegeben wird.
RegExpValidator
  noMatchError : String
Fehlermeldung, wenn keine Übereinstimmungen für den regulären Ausdruck vorhanden sind.
RegExpValidator
 Inheritedproperty : String
Ein String, der den Namen der Eigenschaft des Quellobjekts angibt, das den zu prüfenden Wert enthält.
Validator
 Inheritedrequired : Boolean = true
Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt.
Validator
 InheritedrequiredFieldError : String
Fehlermeldung, wenn ein Wert fehlt und die erforderliche Eigenschaft true ist.
Validator
 Inheritedsource : Object
Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist.
Validator
 Inheritedtrigger : IEventDispatcher
Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst.
Validator
 InheritedtriggerEvent : String
Gibt das Ereignis an, das die Überprüfung auslöst.
Validator
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedactualListeners : Array
[schreibgeschützt] Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt.
Validator
 InheritedactualTrigger : IEventDispatcher
[schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.
Validator
 InheritedresourceManager : IResourceManager
[schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.
Validator
 InheritedsubFields : Array
Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde.
Validator
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor
RegExpValidator
 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
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 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
Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird.
Validator
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 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
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit.
Validator
 Inherited
validateAll(validators:Array):Array
[statisch] Ruft alle Validators im Array der Validators auf.
Validator
 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
 Inherited
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 eines regulären Ausdrucks.
RegExpValidator
 Inherited
Gibt das zu überprüfende Objekt zurück.
Validator
 Inherited
Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.
Validator
 Inherited
Gibt true zurück, wenn der Wert ungleich null ist.
Validator
 Inherited
Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.
Validator
 Inherited
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
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
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn eine Überprüfung fehlschlägt.Validator
 InheritedWird ausgelöst, wenn eine Überprüfung erfolgreich ist.Validator
Eigenschaftendetails

expression

Eigenschaft
expression:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der für die Überprüfung zu verwendende reguläre Ausdruck.



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

flags

Eigenschaft 
flags:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die für die Überprüfung zu verwendenden Flags des regulären Ausdrucks.



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

noExpressionError

Eigenschaft 
noExpressionError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung, wenn kein regulärer Ausdruck angegeben wird. Der Standardwert ist: „Der Ausdruck fehlt“.



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

noMatchError

Eigenschaft 
noMatchError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung, wenn keine Übereinstimmungen für den regulären Ausdruck vorhanden sind. Der Standardwert ist: „Das Feld ist ungültig.“



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

RegExpValidator

()Konstruktor
public function RegExpValidator()

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor

Methodendetails

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 eines regulären Ausdrucks.

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.

Rückgabewerte
Array — Für ein ungültiges Ergebnis: ein Array von ValidationResult-Objekten mit einem ValidationResult-Objekt für jedes vom Validator überprüfte Feld.
RegExValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the RegExpValidator. -->
<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>
        <![CDATA[
            import mx.events.ValidationResultEvent;
            import mx.validators.*;

            // Write the results to the 
            private function handleResult(eventObj:ValidationResultEvent):void {
                if (eventObj.type == ValidationResultEvent.VALID) {
                    // For valid events, the results Array contains
                    // RegExpValidationResult objects.
                    var xResult:RegExpValidationResult;
                    reResults.text = "";
                    for (var i:uint = 0; i < eventObj.results.length; i++) {
                        xResult = eventObj.results[i];
                        reResults.text=reResults.text + xResult.matchedIndex + " " + xResult.matchedString + "\n";
                    }
                } else {
                    reResults.text = "";
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:RegExpValidator id="regExpV" 
                source="{regex_text}" property="text" 
                flags="g" expression="{regex.text}" 
                valid="handleResult(event)"
                invalid="handleResult(event)"
                trigger="{myButton}"
                triggerEvent="click"/>
    </fx:Declarations>

    <s:Panel title="RegExpValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:VGroup left="10" right="10" top="10" bottom="10">
            <s:Label width="100%" text="Instructions:"/>
            <s:Label width="100%" text="1. Enter text to search. By default, enter  a string containing the letters ABC in sequence followed by any digit."/>
            <s:Label width="100%" text="2. Enter the regular expression. By default, enter ABC\d."/>
            <s:Label width="100%" text="3. Click the Button control to trigger the validation."/>
            <s:Label width="100%" text="4. The results show the index in the text where the matching pattern begins, and the matching pattern. "/>
            <mx:Form>
                <mx:FormItem label="Enter text:">
                    <s:TextInput id="regex_text" text="xxxxABC4xxx" width="100%"/>
                </mx:FormItem>
                <mx:FormItem label="Enter regular expression:">
                    <s:TextInput id="regex" text="ABC\d" width="100%"/>
                </mx:FormItem>
                <mx:FormItem label="Results:">
                    <s:TextInput id="reResults" width="100%"/>
                </mx:FormItem>
                <mx:FormItem >
                    <s:Button id="myButton" label="Validate"/>
                </mx:FormItem>
            </mx:Form>
        </s:VGroup>
    </s:Panel>

</s:Application>




[ 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.