| Paket | spark.core |
| Schnittstelle | public interface IEditableText extends IDisplayText , IEventDispatcher |
| Umsetzer | RichEditableText, StyleableStageText, StyleableTextField |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | IEditableText | ||
| displayAsPassword : Boolean
Gibt an, ob es sich um ein Kennworttextfeld handelt. | IEditableText | ||
| editable : Boolean
Flag, das angibt, ob der Text bearbeitet werden kann. | IEditableText | ||
| enabled : Boolean
Legt fest, ob die Komponente Benutzereingaben akzeptieren kann. | IEditableText | ||
| focusEnabled : Boolean
Gibt an, ob die Komponente den Fokus erhalten kann, wenn sie durch Drücken der Tabulatortaste aufgerufen wird. | IEditableText | ||
| horizontalScrollPosition : Number
Die horizontale Bildlaufposition des Texts. | IEditableText | ||
 | isTruncated : Boolean [schreibgeschützt]
Ein Flag, das angibt, ob der Text gekürzt ist. | IDisplayText | |
| lineBreak : String
Steuert den Zeilenumbruch im Text. | IEditableText | ||
| maxChars : int
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann. | IEditableText | ||
| multiline : Boolean
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. | IEditableText | ||
| restrict : String
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. | IEditableText | ||
| selectable : Boolean
Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann. | IEditableText | ||
| selectionActivePosition : int [schreibgeschützt]
Die aktive oder zuletzt angeklickte Position der Auswahl. | IEditableText | ||
| selectionAnchorPosition : int [schreibgeschützt]
Der Anker oder die zuerst angeklickte Position der Auswahl. | IEditableText | ||
| tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | IEditableText | ||
| text : String
Der von dieser Textkomponente angezeigte Text. | IDisplayText | |
| verticalScrollPosition : Number
Die vertikale Bildlaufposition des Texts. | IEditableText | ||
| Methode | Definiert von | ||
|---|---|---|---|
| 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. | IEventDispatcher | |
Hängt den angegebenen Text an das Ende der Textkomponente an, als ob Sie am Ende geklickt und den Text eingegeben hätten. | IEditableText | ||
|
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | |
Fügt den angegebenen Text in die Textkomponente ein, als ob Sie ihn eingegeben hätten. | IEditableText | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | |
Bildlauf ausführen, bis der angegebene Bereich angezeigt wird. | IEditableText | ||
Wählt den gesamten Text aus. | IEditableText | ||
Wählt einen angegebenen Zeichenbereich aus. | IEditableText | ||
Fokus in diesem Textfeld festlegen. | IEditableText | ||
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher | |
accessibilityProperties | Eigenschaft |
accessibilityProperties:AccessibilityProperties| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. Wenn Sie die accessibilityProperties-Eigenschaft oder eines der Felder innerhalb von accessibilityProperties ändern, müssen Sie die Accessibility.updateProperties()-Methode aufrufen, damit diese Änderungen angewendet werden.
Hinweis: Bei einem in der Flash-Authoring-Umgebung erstellten Objekt wird für accessibilityProperties ein etwaiger Wert aus dem Bedienfeld „Eigenschaften“ für dieses Objekt übernommen.
Implementierung
public function get accessibilityProperties():AccessibilityProperties public function set accessibilityProperties(value:AccessibilityProperties):voiddisplayAsPassword | Eigenschaft |
displayAsPassword:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt an, ob es sich um ein Kennworttextfeld handelt. Weist die Eigenschaft den Wert true auf, handelt es sich um ein Kennworttextfeld, und statt der eingegebenen Zeichen werden Sternchen angezeigt. Bei false handelt es sich nicht um ein Kennworttextfeld. Wenn der Kennwortmodus aktiviert ist, können die Befehle „Ausschneiden“ und „Kopieren“ sowie die entsprechenden Tastaturbefehle nicht verwendet werden. Dieser Sicherheitsmechanismus verhindert, dass skrupellose Benutzer anhand des Tastaturbefehls das Kennwort eines unbeaufsichtigten Computers herausfinden.
Implementierung
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voideditable | Eigenschaft |
editable:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Flag, das angibt, ob der Text bearbeitet werden kann.
Der Standardwert ist false.
Implementierung
public function get editable():Boolean public function set editable(value:Boolean):voidenabled | Eigenschaft |
enabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt an, ob die Komponente eine Interaktion mit dem Benutzer gestattet. Nachdem die enabled-Eigenschaft auf false eingestellt wurde, reagieren manche Komponenten immer noch auf Mausbewegungen wie beispielsweise mouseOver. Daher müssen Sie zu einer vollständigen Deaktivierung von UIComponents auch den Wert der mouseEnabled-Eigenschaft auf false festlegen. Wenn Sie die enabled-Eigenschaft für einen Container auf false festlegen, blendet Flex die Farbe des Containers und aller seiner untergeordneten Objekte ab und blockiert Benutzereingaben in den Container und alle seine untergeordneten Objekte.
Implementierung
public function get enabled():Boolean public function set enabled(value:Boolean):voidfocusEnabled | Eigenschaft |
focusEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt an, ob die Komponente den Fokus erhalten kann, wenn sie durch Drücken der Tabulatortaste aufgerufen wird. Sie können focusEnabled auf false setzen, wenn eine UIComponent als Unterkomponente einer anderen Komponente verwendet wird, sodass die äußere Komponente den Fokus erhält. Lautet der Wert dieser Eigenschaft false, wird der Fokus auf das erste übergeordnete Element übertragen, für das focusEnable auf true gesetzt ist.
Der Standardwert ist true, ausgenommen für die spark.components.Scroller-Komponente. Für diese lautet der Standardwert false.
Implementierung
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidhorizontalScrollPosition | Eigenschaft |
horizontalScrollPosition:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Die horizontale Bildlaufposition des Texts.
Implementierung
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidlineBreak | Eigenschaft |
lineBreak:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Steuert den Zeilenumbruch im Text. Diese Eigenschaft entspricht dem lineBreak-Stil.
Implementierung
public function get lineBreak():String public function set lineBreak(value:String):voidVerwandte API-Elemente
maxChars | Eigenschaft |
maxChars:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann. Mit einem Skript kann mehr Text eingefügt werden, als die Eigenschaft maxChars zulässt. maxChars gibt lediglich an, wie viel Text ein Benutzer eingeben kann. Wenn der Wert dieser Eigenschaft 0 ist, können die Benutzer unbegrenzt viel Text eingeben.
Implementierung
public function get maxChars():int public function set maxChars(value:int):voidmultiline | Eigenschaft |
multiline:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. Bei true ist das Textfeld mehrzeilig, bei false ist es einzeilig. In einem Feld des Typs TextFieldType.INPUT gibt der multiline-Wert an, ob die Enter-Taste eine neue Zeile erstellt (bei false wird die Enter-Taste ignoriert). Wenn Sie Text in ein TextField einfügen, dessen multiline-Wert auf false gesetzt ist, werden neue Zeilen aus dem Text entfernt.
Implementierung
public function get multiline():Boolean public function set multiline(value:Boolean):voidrestrict | Eigenschaft |
restrict:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. Wenn die restrict-Eigenschaft auf null gesetzt ist, kann jedes beliebige Zeichen eingegeben werden. Wenn die restrict-Eigenschaft einen leeren String enthält, können keine Zeichen eingegeben werden. Weist die Eigenschaft restrict eine bestimmte Zeichenfolge als Wert auf, können nur diese Zeichen in das Textfeld eingegeben werden. Der String wird von links nach rechts gelesen. Sie können mithilfe eines Bindestrichs (-) einen Zeichenbereich angeben. Nur die Benutzerinteraktion ist beschränkt; ein Skript kann jeden Text in das Textfeld einfügen. Diese Eigenschaft wird nicht an die Optionen unter „Schriftarten einbetten“ im Eigenschafteninspektor angeglichen.
Wenn der String mit dem Einfügezeichen (^) beginnt, werden anfänglich alle Zeichen akzeptiert, aber nachfolgende Zeichen im String werden nicht in die Liste der zulässigen Zeichen aufgenommen. Wenn der String nicht mit dem Einfügezeichen (^) beginnt, werden anfänglich keine Zeichen akzeptiert, aber nachfolgende Zeichen im String werden in die Liste der zulässigen Zeichen aufgenommen.
Im folgenden Beispiel können nur Großbuchstaben, Leerzeichen und Zahlen in das Textfeld eingegeben werden:
my_txt.restrict = "A-Z 0-9";
Im folgenden Beispiel werden alle Zeichen bis auf Kleinbuchstaben akzeptiert:
my_txt.restrict = "^a-z";
Wenn Sie „^“ bzw. „-“ als normale Zeichen verwenden möchten, müssen Sie ihnen einen umgekehrten Schrägstrich (\) voranstellen. Zulässige Backslash-Folgen: \-, \^ oder \\. Der umgekehrte Schrägstrich muss ein echtes Zeichen im String sein; in ActionScript muss der umgekehrte Schrägstrich also doppelt eingegeben werden. Im folgenden Beispiel werden nur der Bindestrich (-) und das Einfügezeichen (^) zugelassen:
my_txt.restrict = "\\-\\^";
Das Einfügezeichen (^) kann an jeder beliebigen Stelle im String verwendet werden, um Zeichen ein- oder auszuschließen. Im folgenden Beispiel werden alle Großbuchstaben außer Q akzeptiert:
my_txt.restrict = "A-Z^Q";
Sie können die Escape-Sequenz \u verwenden, um restrict-Strings zu konstruieren. Im folgenden Beispiel werden nur die Zeichen zwischen ASCII 32 (Leerzeichen) und ASCII 126 (Tilde) akzeptiert:
my_txt.restrict = "\u0020-\u007E";
Implementierung
public function get restrict():String public function set restrict(value:String):voidselectable | Eigenschaft |
selectable:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann. Bei true kann der Text ausgewählt werden. Die Eigenschaft selectable steuert, ob ein Textfeld ausgewählt werden kann, und nicht, ob es bearbeitet werden kann. Ein dynamisches Textfeld kann auswählbar sein, ohne dass es bearbeitet werden kann. Wenn ein dynamisches Textfeld nicht auswählbar ist, kann der enthaltene Text nicht ausgewählt werden.
Wenn selectable auf false gesetzt ist, kann der Text im Textfeld nicht über die Maus oder Tastatur mit den Auswahlbefehlen ausgewählt und daher nicht mit dem Befehl „Kopieren“ kopiert werden. Wenn selectable auf true gesetzt ist, kann der Text im Textfeld über die Maus oder Tastatur mit den Auswahlbefehlen ausgewählt und daher mit dem Befehl „Kopieren“ kopiert werden. In diesem Feld können Sie Text auch dann auswählen, wenn es sich um ein dynamisches Textfeld und nicht um ein Eingabetextfeld handelt.
Implementierung
public function get selectable():Boolean public function set selectable(value:Boolean):voidselectionActivePosition | Eigenschaft |
selectionActivePosition:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Die aktive oder zuletzt angeklickte Position der Auswahl. Wenn die Implementierung keine Auswahlverankerung unterstützt, ist dies das letzte Zeichen der Auswahl.
Implementierung
public function get selectionActivePosition():intselectionAnchorPosition | Eigenschaft |
selectionAnchorPosition:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Der Anker oder die zuerst angeklickte Position der Auswahl. Wenn die Implementierung keine Auswahlverankerung unterstützt, ist dies das erste Zeichen der Auswahl.
Implementierung
public function get selectionAnchorPosition():inttabIndex | Eigenschaft |
tabIndex:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. Die Eigenschaft tabIndex hat standardmäßig den Wert -1, d. h., für das Objekt ist kein Tabulatorindex gesetzt.
Wenn eines der gegenwärtig in der SWF-Datei angezeigten Objekte die tabIndex-Eigenschaft aufweist, wird die automatische Tabulatorreihenfolge deaktiviert und die Tabulatorreihenfolge anhand der tabIndex-Eigenschaften der Objekte in der SWF-Datei ermittelt. Bei der benutzerdefinierten Tabulatorreihenfolge werden nur Objekte berücksichtigt, die über die tabIndex-Eigenschaft verfügen.
Die tabIndex-Eigenschaft kann eine positive Ganzzahl sein. Die Objekte werden entsprechend den tabIndex-Eigenschaften in aufsteigender Reihenfolge angeordnet. Dabei liegt ein Objekt mit einem tabIndex-Wert von 1 in der Reihenfolge vor einem Objekt mit einem tabIndex-Wert von 2. Derselbe tabIndex-Wert darf nicht für mehrere Objekte verwendet werden.
Die durch die tabIndex-Eigenschaft festgelegte benutzerdefinierte Tabulatorreihenfolge ist flat. Das heißt, die hierarchischen Beziehungen zwischen Objekten in der SWF-Datei bleiben unberücksichtigt. Alle Objekte in der SWF-Datei, die die tabIndex-Eigenschaften aufweisen, werden in die Tabulatorreihenfolge eingeordnet, die wiederum durch die Reihenfolge der tabIndex-Werte bestimmt wird.
Hinweis: Um die Tabulatorreihenfolge für TLFTextField-Instanzen festzulegen, wandeln Sie das untergeordnete Anzeigeobjekt von TLFTextField in ein InteractiveObject um und legen Sie dann die tabIndex-Eigenschaft fest. Beispiel:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Um die Tabulatorreihenfolge von der Standardreihenfolge für drei Instanzen eines TLFTextField-Objekts (
tlfInstance1, tlfInstance2 und tlfInstance3) umzukehren, verwenden Sie Folgendes:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementierung
public function get tabIndex():int public function set tabIndex(value:int):voidverticalScrollPosition | Eigenschaft |
verticalScrollPosition:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Die vertikale Bildlaufposition des Texts.
Implementierung
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidappendText | () | Methode |
public function appendText(text:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Hängt den angegebenen Text an das Ende der Textkomponente an, als ob Sie am Ende geklickt und den Text eingegeben hätten.
Nach dem neuen Text wird anschließend eine Einfügemarke eingefügt. Falls nötig erfolgt ein Bildlauf des Texts, um sicherzustellen, dass die Einfügemarke sichtbar ist.
Parameter
text:String — Der anzuhängende Text.
|
insertText | () | Methode |
public function insertText(text:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Fügt den angegebenen Text in die Textkomponente ein, als ob Sie ihn eingegeben hätten.
Wurde ein Bereich ausgewählt, wird der ausgewählte Text durch den neuen Text ersetzt. Wenn eine Einfügemarke vorhanden war, wird der neue Text dort eingefügt.
Nach dem neuen Text wird anschließend eine Einfügemarke eingefügt. Falls nötig erfolgt ein Bildlauf des Texts, um sicherzustellen, dass die Einfügemarke sichtbar ist.
Parameter
text:String — Der einzufügende Text.
|
scrollToRange | () | Methode |
public function scrollToRange(anchorPosition:int, activePosition:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Bildlauf ausführen, bis der angegebene Bereich angezeigt wird.
Parameter
anchorPosition:int — Die Ankerposition des Auswahlbereichs.
| |
activePosition:int — Die aktive Position des Auswahlbereichs.
|
selectAll | () | Methode |
public function selectAll():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Wählt den gesamten Text aus.
selectRange | () | Methode |
public function selectRange(anchorIndex:int, activeIndex:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Wählt einen angegebenen Zeichenbereich aus.
Ist eine der Positionen negativ, wird die Auswahl des Textbereichs aufgehoben.
Parameter
anchorIndex:int — Die Zeichenposition, die das Ende der Auswahl angibt. Bleibt fest, wenn die Auswahl erweitert wird.
| |
activeIndex:int — Die Zeichenposition, die das Ende der Auswahl angibt. Wird verschoben, wenn die Auswahl erweitert wird.
|
setFocus | () | Methode |
public function setFocus():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Fokus in diesem Textfeld festlegen.
Tue Jun 12 2018, 10:04 AM Z