| Paket | mx.validators |
| Klasse | public class RegExpValidator |
| Vererbung | RegExpValidator  Validator EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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:
-
matchedIndexEine Ganzzahl, die die Anfangsindexposition im Eingabestring der Übereinstimmung enthält. -
matchedStringEin String, der den untergeordneten String eines Eingabestrings enthält, der mit dem regulären Ausdruck übereinstimmt. -
matchedSubStringsEin 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-Syntax anzeigen
MXML-Syntax ausblendenThe <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."
/>
Verwandte API-Elemente
Öffentliche Eigenschaften
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : 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. | 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 | ||
| listener : 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 | ||
| 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 | |
| source : Object
Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist. | Validator | |
| 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 | |
Geschützte Eigenschaften
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor
| RegExpValidator | ||
| 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 | |
|
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 | |
Geschützte Methoden
| 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 eines regulären Ausdrucks. | RegExpValidator | ||
|
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 | |
Ereignisse
Geschützte Konstanten
Eigenschaftendetails
expression | Eigenschaft |
flags | Eigenschaft |
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):voidnoMatchError | 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):voidKonstruktordetails
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.
|
Array — Für ein ungültiges Ergebnis: ein Array von ValidationResult-Objekten mit einem ValidationResult-Objekt für jedes vom Validator überprüfte Feld.
|
Beispiele Verwendung dieses Beispiels
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>
Tue Jun 12 2018, 10:04 AM Z