| Paket | flash.text |
| Klasse | public final class StageText |
| Vererbung | StageText  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Diese Klasse ermöglicht mobilen Anwendungen, Benutzereingaben mithilfe nativer Texteingabesteuerungen auf mobilen Geräten zu sammeln. Eingabesteuerelemente auf mobilen Geräten haben häufig umfangreiche Benutzeroberflächen und Verhalten, die auf dem Desktop nicht verfügbar sind. Viele mobile Geräte unterstützen zum Beispiel die folgenden Texteingabefunktionen:
- Autovervollständigen
- Autokorrektur
- berührungsbasierte Textauswahl
- anpassbare Bildschirmtastaturen
Das zu Grunde liegende Betriebssystem (oder eine Komponentenbibliothek, die mit dem Betriebssystem gebündelt ist) zeichnet native Texteingabefelder. Native Texteingabefelder bieten allen Benutzern, die schon mit anderen Anwendungen auf demselben Gerät gearbeitet haben, ein vertrautes Benutzererlebnis. Da die Texteingabefelder vom Betriebssystem, nicht vom Player, gezeichnet werden, können Sie keine eingebetteten Schriftarten verwenden.
Unterstützung von AIR-Profilen: Diese Funktion wird auf iOS- und Android-Plattformen unterstützt. StageText verwendet auf Android- und iOS-Mobilgeräten native Texteingabefelder. Auf anderen Plattformen verwendet StageText das Flash Runtime TextField.
Wenn native Eingaben verwendet werden, sind StageText-Objekte keine Anzeigeobjekte und können nicht zur Flash-Anzeigeliste hinzugefügt werden. Stattdessen zeigen Sie ein StageText-Objekt an, indem Sie es mithilfe der stage-Eigenschaft direkt an die Bühne anhängen. Die an die Bühne angehängte StageText-Instanz wird über allen ggf. vorhandenen Flash-Anzeigeobjekten angezeigt. Sie steuern die Größe und Position des Renderingbereichs mit der viewPort-Eigenschaft. Es gibt keine Möglichkeit, die Tiefenreihenfolge verschiedener StageText-Objekte zu steuern. Das Überlappen von zwei Instanzen wird nicht empfohlen.
Wenn ein StageText-Objekt den Fokus hat, kann es als Erstes Tastatureingaben verarbeiten. Die Bühne, an die das StageText-Objekt angehängt ist, setzt keine Tastatureingabeereignisse ab
Da die StageText-Klasse auf jeder Plattform ein anderes natives Steuerelement umhüllt, werden ihre Funktionen auf den einzelnen Plattformen in unterschiedlichem Maße unterstützt. Außerdem können sich unterstützte Funktionen auf verschiedenen Plattformen auch unterschiedlich verhalten. Wenn Sie eine bestimmte Funktion auf einer bestimmten Plattform verwenden möchten, sollten Sie ihr Verhalten deshalb testen. Nur auf Desktopplattformen, auf denen native Steuerelemente nicht verwendet werden, ist das StageText-Verhalten dem Textverhalten der Flash-Laufzeitumgebung ähnlich.
StageText auf Apple TV erhält den Fokus automatisch. Um den Fokus zwischen verschiedenen Objekten in Ihrer Anwendung zu kontrollieren, beachten Sie folgende Punkte:
- Um den Standardfokus von StageText außer Kraft zu setzen oder einem anderen Anzeigeobjekt zuzuweisen, verwenden Sie stage.focus
- Um den Fokus StageText zuzuweisen, verwenden Sie stageText.assignFocus()
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| autoCapitalize : String
Steuert, wie ein Gerät die automatische Großschreibung auf die Benutzereingabe anwendet. | StageText | ||
| autoCorrect : Boolean
Gibt an, ob ein Gerät die Autokorrektur für Rechtschreib- und Zeichensetzungsfehler bei Benutzereingaben ausführt. | StageText | ||
| clearButtonMode : String [Nur Schreiben]
Der Modus von clearButton für das aktuelle StageText-Objekt. | StageText | ||
| color : uint
Gibt die Textfarbe an. | StageText | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| displayAsPassword : Boolean
Gibt an, ob es sich um ein mehrzeiliges Kennworttextfeld handelt. | StageText | ||
| editable : Boolean
Gibt an, ob der Benutzer das Textfeld bearbeiten kann. | StageText | ||
| fontFamily : String
Gibt den Namen der aktuellen Schriftfamilie an. | StageText | ||
| fontPosture : String
Legt die Schriftlage mithilfe von Konstanten fest, die in der FontPosture-Klasse definiert sind. | StageText | ||
| fontSize : int
Die Größe in Pixeln für die aktuelle Schriftfamilie. | StageText | ||
| fontWeight : String
Legt die Schriftstärke mithilfe von Konstanten fest, die in der FontWeight-Klasse definiert sind. | StageText | ||
| locale : String
Gibt das Gebietsschema des Textes an. | StageText | ||
| maxChars : int
Gibt die maximale Anzahl Zeichen an, die ein Benutzer in das Textfeld eingeben kann. | StageText | ||
| multiline : Boolean [schreibgeschützt]
Gibt an, ob das StageText-Objekt mehrere Zeilen Text anzeigen kann. | StageText | ||
| restrict : String
Schränkt die Gruppe der Zeichen ein, die ein Benutzer in das Textfeld eingeben kann. | StageText | ||
| returnKeyLabel : String
Gibt für Geräte mit Bildschirmtastatur die Beschriftung für die Eingabetaste an. | StageText | ||
| selectionActiveIndex : int [schreibgeschützt]
Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. | StageText | ||
| selectionAnchorIndex : int [schreibgeschützt]
Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl. | StageText | ||
| softKeyboardType : String
Steuert das Erscheinungsbild der Bildschirmtastatur. | StageText | ||
| stage : Stage
Die Bühne, auf der dieses StageText-Objekt angezeigt wird. | StageText | ||
| text : String
Der aktuelle Text im Textfeld. | StageText | ||
| textAlign : String
Gibt die Absatzausrichtung an. | StageText | ||
| viewPort : Rectangle
Der Bereich auf der Bühne, in dem das StageText-Objekt angezeigt wird. | StageText | ||
| visible : Boolean
Gibt an, ob das StageText-Objekt sichtbar ist. | StageText | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt ein StageText-Objekt. | StageText | ||
| 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 | |
Weist dem StageText-Objekt den Fokus zu. | StageText | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Entfernt das StageText-Objekt. | StageText | ||
Zeichnet den StageWeb-Viewport in eine Bitmap. | StageText | ||
|
Ü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 | |
|
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 | |
Wählt den Text aus, der von den Indexwerten des ersten und letzten Zeichens angegeben wird. | StageText | ||
|
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 | |
|
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 | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird abgesetzt, nachdem der Textinhalt geändert wurde. | StageText | |||
| Wird abgesetzt, nachdem „stage“ als nicht null und „viewPort“ als nicht leer festgelegt wurden. | StageText | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird abgesetzt, wenn der Benutzer Text bearbeitet und das Steuerelement den Tastaturfokus hat. | StageText | |||
| Wird abgesetzt, wenn der Benutzer keinen Text mehr bearbeitet und das Steuerelement nicht mehr den Tastaturfokus hat. | StageText | |||
| Wird ausgelöst, wenn der Benutzer eine Taste drückt. | StageText | |||
| Wird ausgelöst, wenn der Benutzer eine Taste loslässt. | StageText | |||
| Wird abgesetzt, nachdem die Bildschirmtastatur aktiviert wurde, weil das StageText-Objekt den Fokus erhalten hat. | StageText | |||
| Wird abgesetzt, bevor die Bildschirmtastatur aktiviert wird, weil das StageText-Objekt den Fokus erhält. | StageText | |||
| Wird abgesetzt, nachdem die Bildschirmtastatur deaktiviert wurde, weil das StageText-Objekt nicht länger den Fokus hat. | StageText | |||
autoCapitalize | Eigenschaft |
autoCapitalize:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Steuert, wie ein Gerät die automatische Großschreibung auf die Benutzereingabe anwendet. Gültige Werte sind als Konstanten in der AutoCapitalize-Klasse definiert:
- "none"
- "word"
- "sentence"
- "all"
Diese Eigenschaft ist nur ein Hinweis für die zu Grunde liegende Plattform, da nicht alle Geräte und Betriebssysteme diese Funktion unterstützen.
Hinweis: Wenn Sie autoCapitalize aktivieren, während Text bearbeitet wird oder während er im Fokus ist, wird das aktualisierte Verhalten nicht angewendet, bis der Fokus aufgehoben und wiederhergestellt ist.
Der Standardwert ist AutoCapitalize.NONE.
Implementierung
public function get autoCapitalize():String public function set autoCapitalize(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von AutoCapitalize ist
|
Verwandte API-Elemente
autoCorrect | Eigenschaft |
autoCorrect:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt an, ob ein Gerät die Autokorrektur für Rechtschreib- und Zeichensetzungsfehler bei Benutzereingaben ausführt.
Diese Eigenschaft ist nur ein Hinweis für die zu Grunde liegende Plattform, da nicht alle Geräte und Betriebssysteme diese Funktion unterstützen.
Hinweis: Wenn Sie autoCorrect aktivieren, während Text bearbeitet wird oder während er im Fokus ist, wird das aktualisierte Verhalten nicht angewendet, bis der Fokus aufgehoben und wiederhergestellt ist.
Der Standardwert ist false.
Implementierung
public function get autoCorrect():Boolean public function set autoCorrect(value:Boolean):void clearButtonMode | Eigenschaft |
clearButtonMode:String [Nur Schreiben] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 23 |
Der Modus von clearButton für das aktuelle StageText-Objekt. Es gibt vier Modi, die dieser Eigenschaft zugeordnet sind:
-
clearButton während der Bearbeitung anzeigen:
StageTextClearButtonMode.WHILE_EDITING -
clearButton nie anzeigen:
StageTextClearButtonMode.NEVER -
clearButton immer anzeigen:
StageTextClearButtonMode.ALWAYS -
clearButton außer bei der Bearbeitung immer anzeigen:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode der Wert StageTextClearButtonMode.WHILE_EDITING ausgewählt.
Hinweis: Diese Eigenschaft wird nur für iOS unterstützt.
Implementierung
public function set clearButtonMode(value:String):void color | Eigenschaft |
color:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt die Textfarbe an. Sie legen die Textfarbe als eine Zahl mit drei 8-Bit-RGB-Komponenten fest. Die erste Komponente steht für Rot, die zweite für Grün, die dritte für Blau. Zum Beispiel spezifiziert 0xFF0000 Rot, 0x00FF00 Grün und 0x0000FF Blau. Die Standardtextfarbe ist Schwarz (0x000000).
Der Standardwert ist 0x000000.
Implementierung
public function get color():uint public function set color(value:uint):void displayAsPassword | Eigenschaft |
displayAsPassword:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt an, ob es sich um ein mehrzeiliges Kennworttextfeld handelt. Bei der Einstellung true verbirgt das Textfeld die eingegebenen Zeichen, indem es sie durch ein anderes Zeichen ersetzt (zum Beispiel ein Sternchen).
Hinweis: Wenn Sie displayAsPassword aktivieren, während Text bearbeitet wird oder während er im Fokus ist, wird das aktualisierte Verhalten nicht angewendet, bis der Fokus aufgehoben und wiederhergestellt ist.
Wichtig: Unter iOS zeigt ein mehrzeiliges StageText-Objekt keine Ersatzeichen an, auch wenn diese Eigenschaft den Wert true hat.
Der Standardwert ist false.
Implementierung
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):void editable | Eigenschaft |
fontFamily | Eigenschaft |
fontFamily:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt den Namen der aktuellen Schriftfamilie an. Der Wert null zeigt den Systemstandard an. Um die verfügbaren Schriftarten aufzuzählen, verwenden Sie flash.text.Font.enumerateFonts(). Wenn die Schriftfamilie unbekannt ist, wird ebenfalls die Standardschriftfamilie verwendet.
Der Standardwert ist null.
Implementierung
public function get fontFamily():String public function set fontFamily(value:String):void fontPosture | Eigenschaft |
fontPosture:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Legt die Schriftlage mithilfe von Konstanten fest, die in der FontPosture-Klasse definiert sind.
Der Standardwert ist FontPosture.NORMAL.
Implementierung
public function get fontPosture():String public function set fontPosture(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von FontPosture ist
|
Verwandte API-Elemente
fontSize | Eigenschaft |
fontWeight | Eigenschaft |
fontWeight:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Legt die Schriftstärke mithilfe von Konstanten fest, die in der FontWeight-Klasse definiert sind.
Der Standardwert ist FontWeight.NORMAL.
Implementierung
public function get fontWeight():String public function set fontWeight(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von FontWeight ist
|
Verwandte API-Elemente
locale | Eigenschaft |
locale:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt das Gebietsschema des Textes an. StageText verwendet die standardmäßigen Gebietsschemakennungen. Beispiel: „en“, „en_US“ und „en-US“ stehen für Englisch; „ja“ für Japanisch. Eine Liste der Gebietsschemacodes finden Sie unter iso639-2 code list.
Der Standardwert ist en.
Implementierung
public function get locale():String public function set locale(value:String):void maxChars | Eigenschaft |
maxChars:int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt die maximale Anzahl Zeichen an, die ein Benutzer in das Textfeld eingeben kann. Ein Skript kann mehr Text einfügen als durch maxChars zulässig. Wenn maxChars null entspricht, kann ein Benutzer eine unbegrenzte Textmenge in das Textfeld eingeben.
Der Standardwert ist 0.
Implementierung
public function get maxChars():int public function set maxChars(value:int):void multiline | Eigenschaft |
multiline:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt an, ob das StageText-Objekt mehrere Zeilen Text anzeigen kann. Schreibgeschützt. Dieser Wert entspricht dem der multiline-Eigenschaft im StageTextInitOptions-Objekt während der Konstruktion.
Implementierung
public function get multiline():BooleanVerwandte API-Elemente
restrict | Eigenschaft |
restrict:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Schränkt die Gruppe der Zeichen ein, die ein Benutzer in das Textfeld eingeben kann. Das System liest den restrict-String von links nach rechts.
Der Wert von restrict gibt die folgenden einschränkenden Regeln für die Texteingabe an:
- Wenn der Wert
nullist, kann ein Benutzer beliebige Zeichen eingeben. - Wenn der Wert ein leerer String ist, kann ein Benutzer keine Zeichen eingeben.
- Wenn der Wert eine Folge von Zeichen ist, kann der Benutzer nur die in diesem String aufgeführten Zeichen eingeben.
- Wenn der Wert ein Caretzeichen (^) enthält, kann der Benutzer keines der Zeichen eingeben, die nach dem Caretzeichen stehen.
- Der Wert kann einen Bereich zulässiger Eingabezeichen mithilfe eines Bindestrichs (-) festlegen.
- Der Wert kann die Escapesequenz
\uverwenden, um einenrestrict-String zu konstruieren.
Sonderzeichen:
Verwenden Sie einen umgekehrten Schrägstrich, um ein Caretzeichen (^) oder ein Bindestrichzeichen (-) einzugeben, das als solches gemeint ist. Zulässige Backslash-Folgen sind \-, \^ und \\. Der umgekehrte Schrägstrich muss ein tatsächliches Zeichen im String sein. Wenn Sie einen umgekehrten Schrägstrich in ActionScript angeben, verwenden Sie einen doppelten umgekehrten Schrägstrich.
Beispiel für Einstellungen der restrict-Eigenschaft:
Im folgenden Beispiel darf der Benutzer nur den Bindestrich (-) und das Caretzeichen (^) eingeben:
my_txt.restrict = "\\-\\^";
Im folgenden Beispiel darf der Benutzer nur Großbuchstaben, Leerzeichen und Zahlen eingeben:
my_txt.restrict = "A-Z 0-9";
Im folgenden Beispiel sind nur Kleinbuchstaben unzulässig:
my_txt.restrict = "^a-z";
Im folgenden Beispiel darf der Benutzer nur Großbuchstaben eingeben, allerdings nicht den Großbuchstaben Q:
my_txt.restrict = "A-Z^Q";
Im folgenden Beispiel darf der Benutzer nur die Zeichen von ASCII 32 (Leerzeichen) bis ASCII 126 (Tilde) eingeben.
my_txt.restrict = "\u0020-\u007E";
Hinweis: Einschränkungen gelten nur für die Benutzereingabe; ein Skript kann beliebige Zeichen in das Textfeld eingeben.
Der Standardwert ist null.
Implementierung
public function get restrict():String public function set restrict(value:String):void returnKeyLabel | Eigenschaft |
returnKeyLabel:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt für Geräte mit Bildschirmtastatur die Beschriftung für die Eingabetaste an. Die verfügbaren Werte sind Konstanten, die in der ReturnKeyLabel-Klasse definiert sind:
- "default"
- "done"
- "go"
- "next"
- "search"
Diese Eigenschaft ist nur ein Hinweis für die zu Grunde liegende Plattform, da nicht alle Geräte und Betriebssysteme diese Werte unterstützen. Bei Geräten ohne Bildschirmtastatur hat diese Eigenschaft keine Auswirkungen.
Der Standardwert ist ReturnKeyLabel.DEFAULT.
Implementierung
public function get returnKeyLabel():String public function set returnKeyLabel(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von ReturnKeyLabel ist
|
Verwandte API-Elemente
selectionActiveIndex | Eigenschaft |
selectionActiveIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. Das erste Zeichen ist beispielsweise 0, das zweite Zeichen 1 usw.
Wenn kein Text ausgewählt ist, gibt diese Methode die Einfügemarke zurück. Wenn die StageText-Instanz keinen Fokus hat, gibt diese Methode –1 zurück.
Unter iOS wird diese Eigenschaft für nicht mehrzeilige StageText-Objekte nicht unterstützt und gibt –1 zurück.
Implementierung
public function get selectionActiveIndex():intVerwandte API-Elemente
selectionAnchorIndex | Eigenschaft |
selectionAnchorIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Der auf null basierende Indexwert des ersten Zeichens in der aktuellen Auswahl. Das erste Zeichen ist beispielsweise 0, das zweite Zeichen 1 usw.
Wenn kein Text ausgewählt ist, gibt diese Methode die Einfügemarke zurück. Wenn die StageText-Instanz keinen Fokus hat, gibt diese Methode –1 zurück.
Unter iOS wird diese Eigenschaft für nicht mehrzeilige StageText-Objekte nicht unterstützt und gibt –1 zurück.
Implementierung
public function get selectionAnchorIndex():intVerwandte API-Elemente
softKeyboardType | Eigenschaft |
softKeyboardType:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Steuert das Erscheinungsbild der Bildschirmtastatur.
Geräte mit Bildschirmtastatur können die Tasten der Tastatur anpassen, damit sie zu der erwarteten Eingabe passen. Wenn zum Beispiel eine numerische Eingabe erwartet wird, kann ein Gerät SoftKeyboardType.NUMBER verwenden, um nur Ziffern auf der Bildschirmtastatur anzuzeigen. Gültige Werte sind als Konstanten in der SoftKeyboardType-Klasse definiert:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Diese Werte dienen als Hinweise, damit ein Gerät die Tastatur anzeigen kann, die für den aktuellen Vorgang am besten geeignet ist.
Der Standardwert ist SoftKeyboardType.DEFAULT.
Implementierung
public function get softKeyboardType():String public function set softKeyboardType(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von SoftKeyboardType ist
|
Verwandte API-Elemente
stage | Eigenschaft |
stage:Stage| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Die Bühne, auf der dieses StageText-Objekt angezeigt wird.
Stellen Sie stage auf null ein, um dieses StageText-Objekt auszublenden.
Der Standardwert ist null.
Implementierung
public function get stage():Stage public function set stage(value:Stage):void text | Eigenschaft |
text:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Der aktuelle Text im Textfeld. Das Wagenrücklaufzeichen ('\r', ASCII 13) trennt Textzeilen. In dieser Eigenschaft enthaltener Text ist unformatiert (er hat keine Formatierungstags).
Der Standardwert ist null.
Implementierung
public function get text():String public function set text(value:String):void textAlign | Eigenschaft |
textAlign:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt die Absatzausrichtung an. Gültige Werte sind als Konstanten in der TextFormatAlign-Klasse definiert:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Nicht alle Plattformen unterstützen alle Werte von textAlign. Bei nicht unterstützten textAlign-Werten verwenden Plattformen den Standardwert (TextFormatAlign.START).
Der Standardwert ist TextFormatAlign.START.
Implementierung
public function get textAlign():String public function set textAlign(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von TextFormatAlign ist
|
Verwandte API-Elemente
viewPort | Eigenschaft |
viewPort:Rectangle| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Der Bereich auf der Bühne, in dem das StageText-Objekt angezeigt wird. Die Standardeinstellung ist das Null-Rechteck.
Implementierung
public function get viewPort():Rectangle public function set viewPort(value:Rectangle):voidAuslöser
RangeError — Der Rectangle-Wert ist nicht gültig.
|
visible | Eigenschaft |
StageText | () | Konstruktor |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Erstellt ein StageText-Objekt.
Das StageText-Objekt ist unsichtbar, bis es an eine Bühne angehängt wird und der die viewPort-Eigenschaft festgelegt wurde.
initOptions:flash.text:StageTextInitOptions (default = null) |
assignFocus | () | Methode |
public function assignFocus():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Weist dem StageText-Objekt den Fokus zu. Bei nicht bearbeitbaren Objekten hat assignFocus keine Auswirkungen.
dispose | () | Methode |
public function dispose():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Entfernt das StageText-Objekt.
Der Aufruf von dispose() ist optional. Wenn Sie keinen Verweis auf diese StageText-Instanz behalten, wird sie bei der automatischen Speicherbereinigung entfernt. Mit dem Aufruf von dispose() kann die Speicherbereinigung eher erfolgen oder zu einer passenderen Zeit.
drawViewPortToBitmapData | () | Methode |
public function drawViewPortToBitmapData(bitmap:BitmapData):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3.0 |
Zeichnet den StageWeb-Viewport in eine Bitmap.
Erfassen Sie die Bitmap und setzen Sie die Bühne auf null, um den Inhalt über dem StageText-Objekt anzuzeigen.
Die Bitmap weist normalerweise dieselbe Breite und Höhe auf wie der Viewport. In AIR 15.0 oder höher können die Breite und Höhe der Bitmap optional das contentsScaleFactor-Fache des Viewports betragen, wenn der Player auf HiDPI-Displays angezeigt wird. So hat contentsScaleFactor beispielsweise auf einem Mac Retina-Display den Wert 2, da die Pixelauflösung der Bühne verdoppelt ist. Die Bitmap kann dementsprechend zweimal so groß sein wie der Viewport.
Wenn Sie diese Methode vor dem Event.COMPLETE-Ereignis aufrufen, zeichnet die Methode den Viewport möglicherweise nicht korrekt.
Parameter
bitmap:BitmapData — Das BitmapData-Objekt, in dem der sichtbare Teil des StageText-Viewport gezeichnet werden soll.
|
Auslöser
ArgumentError — Die Breite oder Höhe der Bitmap unterscheidet sich von der Breite oder Höhe des Viewports.
| |
Error — Die Bitmap hat den Wert null.
|
selectRange | () | Methode |
public function selectRange(anchorIndex:int, activeIndex:int):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wählt den Text aus, der von den Indexwerten des ersten und letzten Zeichens angegeben wird. Sie geben das erste und das letzte Zeichen der Auswahl in den Parametern anchorIndex und activeIndex an. Wenn die beiden Parameterwerte identisch sind, legt diese Methode den Einfügepunkt fest.
Unter iOS wird diese Funktion für nicht mehrzeilige StageText-Objekte nicht unterstützt und gibt immer -1 zurück. Wenn Sie diese Methode beim Auswählen des ganzen Textstrings aufrufen, wird die gesamte Auswahl angezeigt. Wenn Sie diese Methode jedoch beim Auswählen einer Untergruppe des Textstrings aufrufen, wird die Auswahl nicht angezeigt.
Bei einigen Geräten oder Betriebssystemen ist die Auswahl möglicherweise nur sichtbar, wenn das StageText-Objekt den Fokus hat.
Parameter
anchorIndex:int — Der nullbasierte Indexwert für das erste Zeichen der Auswahl (der Indexwert des ersten Zeichens ist 0).
| |
activeIndex:int — Der auf null basierende Indexwert des letzten Zeichens in der Auswahl.
|
Verwandte API-Elemente
change | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.CHANGE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, nachdem der Textinhalt geändert wurde. Dieses Ereignis kann bei jeder Änderung abgesetzt werden oder erst, wenn ein Satz Änderungen abgeschlossen ist.
DieEvent.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Wert geändert wurde. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
complete | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.COMPLETE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, nachdem „stage“ als nicht null und „viewPort“ als nicht leer festgelegt wurden. Gibt an, dass die Implementierung mit dem Layout des StageText-Objekts fertig ist und Sie nun die drawViewPortToBitmapData-Methode aufrufen können. Je nach Plattform kann dieses Ereignis synchron oder asynchron mit der Einstellung von stage, viewPort oder beidem abgesetzt werden.
Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
focusIn | Ereignis |
flash.events.FocusEventEigenschaft FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, wenn der Benutzer Text bearbeitet und das Steuerelement den Tastaturfokus hat.
Definiert den Wert der Eigenschafttype eines focusIn-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | 0; gilt nur für keyFocusChange-Ereignisse. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | false; gilt nur für keyFocusChange-Ereignisse. |
target | Die InteractiveObject-Instanz, die gerade den Fokus erhalten hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
|
direction | Die Richtung, aus der der Fokus zugewiesen wurde. Diese Eigenschaft meldet den Wert des direction-Parameters der assignFocus()-Methode auf der Bühne. Wird der Fokus durch andere Mittel geändert, ist der Wert immer FocusDirection.NONE. Gilt nur für focusIn-Ereignisse. Für alle anderen focus-Ereignisse ist der Wert FocusDirection.NONE. |
focusOut | Ereignis |
flash.events.FocusEventEigenschaft FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, wenn der Benutzer keinen Text mehr bearbeitet und das Steuerelement nicht mehr den Tastaturfokus hat.
Definiert den Wert der Eigenschafttype eines focusOut-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | 0; gilt nur für keyFocusChange-Ereignisse. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | false; gilt nur für keyFocusChange-Ereignisse. |
target | Die InteractiveObject-Instanz, die gerade den Fokus verloren hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
|
keyDown | Ereignis |
flash.events.KeyboardEventEigenschaft KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird ausgelöst, wenn der Benutzer eine Taste drückt.
Zuordnungen zwischen Tasten und spezifischen Zeichen variieren zwischen verschiedenen Geräten und Betriebssystemen. Dieser Ereignistyp wird erzeugt, nachdem eine Zuordnung dieser Art stattgefunden hat, aber vor der Verarbeitung eines IME (Input Method Editor, Eingabemethodeneditor). IMEs sind hilfreich, um Zeichen einzugeben, für die die standardmäßige QWERTZ-Tastatur nicht gut geeignet ist (zum Beispiel chinesische Schriftzeichen).
Dieses Ereignis tritt vor dem keyUp-Ereignis ein.
Dieses Ereignis wird nicht für alle Tasten abgesetzt. Welche Tasten das Absetzen dieses Ereignisses auslösen, unterscheidet sich auf den verschiedenen Plattformen.
Wenn Sie in AIR dieses Ereignis abbrechen, wird verhindert, dass das Zeichen in ein Textfeld eingegeben wird.
DieKeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | Wert true in AIR, Wert false in Flash Player; in AIR wird durch Abbrechen dieses Ereignisses verhindert, dass das Zeichen in ein Textfeld eingegeben wird. |
charCode | Der Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
keyUp | Ereignis |
flash.events.KeyboardEventEigenschaft KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird ausgelöst, wenn der Benutzer eine Taste loslässt.
Zuordnungen zwischen Tasten und spezifischen Zeichen variieren zwischen verschiedenen Geräten und Betriebssystemen. Dieser Ereignistyp wird erzeugt, nachdem eine Zuordnung dieser Art stattgefunden hat, aber vor der Verarbeitung eines IME (Input Method Editor, Eingabemethodeneditor). IMEs werden verwendet, um Zeichen einzugeben, für die die standardmäßige QWERTZ-Tastatur nicht gut geeignet ist (zum Beispiel chinesische Schriftzeichen).
Dieses Ereignis tritt nach einem keyDown-Ereignis auf.
Dieses Ereignis wird nicht für alle Tasten abgesetzt. Welche Tasten das Absetzen dieses Ereignisses auslösen, unterscheidet sich auf den verschiedenen Plattformen.
DieKeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
charCode | Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true unter Windows, falls die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
softKeyboardActivate | Ereignis |
flash.events.SoftKeyboardEventEigenschaft SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, nachdem die Bildschirmtastatur aktiviert wurde, weil das StageText-Objekt den Fokus erhalten hat.
DieSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, wenn eine Softwaretastatur angezeigt wird. Für dieses Ereignis gilt: cancellable = false.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
relatedObjectVal | Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. |
triggerTypeVal | Gibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
softKeyboardActivating | Ereignis |
flash.events.SoftKeyboardEventEigenschaft SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, bevor die Bildschirmtastatur aktiviert wird, weil das StageText-Objekt den Fokus erhält.
DieSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts unmittelbar vor der Anzeige einer Softwaretastatur. Für dieses Ereignis gilt: cancellable = true.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true, sofern das Ereignis nicht von einem StageText-Objekt abgesetzt wird. Für StageText-Objekte kann das Ereignis nicht abgebrochen werden. |
relatedObjectVal | Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. |
triggerTypeVal | Gibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
softKeyboardDeactivate | Ereignis |
flash.events.SoftKeyboardEventEigenschaft SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Wird abgesetzt, nachdem die Bildschirmtastatur deaktiviert wurde, weil das StageText-Objekt nicht länger den Fokus hat.
DieSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE-Konstante definiert den Wert des SoftKeyboardEvent-Objekts der type-Eigenschaft, wenn eine Bildschirmtastatur ausgeblendet wird. Für dieses Ereignis gilt: cancellable = false.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
relatedObjectVal | Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. |
triggerTypeVal | Gibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
Tue Jun 12 2018, 10:04 AM Z