| Paket | mx.core |
| Schnittstelle | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
| Umsetzer | UIFTETextField, UITextField |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | IFlexDisplayObject | |
| alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | IFlexDisplayObject | |
| alwaysShowSelection : Boolean
Wenn sich das Textfeld bei Einstellung „true“ nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in grau. | IUITextField | ||
| antiAliasType : String
Der für dieses Textfeld verwendete Anti-Aliasing-Typ. | IUITextField | ||
| autoSize : String
Steuert die automatische Größenänderung und Ausrichtung von Textfeldern. | IUITextField | ||
| background : Boolean
Gibt an, ob das Textfeld einen gefüllten Hintergrund aufweist. | IUITextField | ||
| backgroundColor : uint
Gibt die Hintergrundfarbe des Textfelds an. | IUITextField | ||
| baselinePosition : Number [schreibgeschützt]
Die y-Koordinate der Grundlinie der ersten Textzeile der Komponente. | IUIComponent | |
| blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | IFlexDisplayObject | |
| border : Boolean
Gibt an, ob das Textfeld umrahmt ist. | IUITextField | ||
| borderColor : uint
Gibt die Farbe des Textfeldrahmens an. | IUITextField | ||
| bottomScrollV : int [schreibgeschützt]
Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt. | IUITextField | ||
| cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | IFlexDisplayObject | |
| caretIndex : int [schreibgeschützt]
Der Index der Position der Einfügemarke. | IUITextField | ||
| condenseWhite : Boolean
Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text entfernt werden sollen. | IUITextField | ||
| defaultTextFormat : flash.text:TextFormat
Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()-Methode eingefügt wird) angewendet wird. | IUITextField | ||
| displayAsPassword : Boolean
Gibt an, ob es sich um ein Kennworttextfeld handelt. | IUITextField | ||
| document : Object
Ein Verweis auf das Dokumentobjekt, das mit dieser Komponente verknüpft ist. | IUIComponent | |
| doubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt. | IUITextField | ||
| embedFonts : Boolean
Gibt an, ob bei der Wiedergabe eingebettete Schriftkonturen verwendet werden sollen. | IUITextField | ||
| enabled : Boolean
Legt fest, ob die Komponente Benutzereingaben akzeptieren kann. | IUIComponent | |
| enableIME : Boolean [schreibgeschützt]
Gibt an, ob der IME (Eingabemethodeneditor) aktiviert werden soll, wenn diese Komponente den Fokus hat. | IIMESupport | |
| explicitHeight : Number
Die explizit festgelegte Höhe für die Komponente in Pixeln als Koordinaten der Komponente. | IUIComponent | |
| explicitMaxHeight : Number [schreibgeschützt]
Eine Zahl, die die maximale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMaxWidth : Number [schreibgeschützt]
Eine Zahl, die die maximale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMinHeight : Number [schreibgeschützt]
Eine Zahl, die die minimale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMinWidth : Number [schreibgeschützt]
Eine Zahl, die die minimale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitWidth : Number
Die explizit festgelegte Breite für die Komponente in Pixeln als Koordinaten der Komponente. | IUIComponent | |
| filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | IFlexDisplayObject | |
| focusPane : Sprite
Ein einzelnes Sprite-Objekt, das von Komponenten gemeinsam und als Überlagerung für das Zeichnen der Fokusanzeige verwendet wird. | IUIComponent | |
| focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | IUITextField | ||
| gridFitType : String
Die für dieses Textfeld verwendete Art der Rasteranpassung. | IUITextField | ||
| height : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | IFlexDisplayObject | |
| htmlText : String
Enthält die HTML-Darstellung des Inhalts des Textfelds. | IUITextField | ||
| ignorePadding : Boolean
Wenn „true“, fügen die Stile paddingLeft und paddingRight keinen Platz um den Text der Komponente herum ein. | IUITextField | ||
| imeMode : String
Der IME-Modus der Komponente. | IIMESupport | |
| includeInLayout : Boolean
Gibt an, ob diese Komponente im Layout des übergeordneten Containers enthalten ist. | IUIComponent | |
| inheritingStyles : Object
Der Beginn der Vererbungsstilkette für dieses UITextField. | IUITextField | ||
| isPopUp : Boolean
Wird vom PopUpManager auf „true“ gesetzt, um anzugeben, dass für die Komponente ein Popup eingeblendet wird. | IUIComponent | |
| length : int [schreibgeschützt]
Die Anzahl der Zeichen in einem Textfeld. | IUITextField | ||
| loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | IFlexDisplayObject | |
| mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | IFlexDisplayObject | |
| maxChars : int
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann. | IUITextField | ||
| maxHeight : Number [schreibgeschützt]
Eine Zahl, die die maximale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| maxScrollH : int [schreibgeschützt]
Der maximale Wert der Eigenschaft „scrollH“. | IUITextField | ||
| maxScrollV : int [schreibgeschützt]
Der maximale Wert der Eigenschaft „scrollV“. | IUITextField | ||
| maxWidth : Number [schreibgeschützt]
Eine Zahl, die die maximale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| measuredHeight : Number [schreibgeschützt]
Die gemessene Höhe dieses Objekts. | IFlexDisplayObject | |
| measuredMinHeight : Number
Die standardmäßige Mindesthöhe der Komponente in Pixeln. | IUIComponent | |
| measuredMinWidth : Number
Die standardmäßige Mindestbreite der Komponente in Pixeln. | IUIComponent | |
| measuredWidth : Number [schreibgeschützt]
Die gemessene Breite dieses Objekts. | IFlexDisplayObject | |
| minHeight : Number [schreibgeschützt]
Eine Zahl, die die minimale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| minWidth : Number [schreibgeschützt]
Eine Zahl, die die minimale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | IUITextField | ||
| mouseWheelEnabled : Boolean
Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht. | IUITextField | ||
| mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | IFlexDisplayObject | |
| mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | IFlexDisplayObject | |
| multiline : Boolean
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. | IUITextField | ||
| name : String
Gibt den Instanznamen des Anzeigeobjekts an. | IFlexDisplayObject | |
| nestLevel : int
Die Tiefe dieses Objekts in der enthaltenden Hierarchie. | IUITextField | ||
| nonInheritingStyles : Object
Der Beginn der Kette nicht vererbter Stile für dieses UITextField. | IUITextField | ||
| nonZeroTextHeight : Number [schreibgeschützt]
Im Unterschied zu textHeight gibt diese Methode einen Wert zurück, der nicht null ist, selbst wenn der Text leer ist. | IUITextField | ||
| numLines : int [schreibgeschützt]
Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an. | IUITextField | ||
| opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | IFlexDisplayObject | |
| owner : DisplayObjectContainer
Der Eigentümer dieses IVisualElement-Objekts. | IUIComponent | |
| parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | IFlexDisplayObject | |
| percentHeight : Number
Eine Zahl, die die Höhe einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts festlegt. | IUIComponent | |
| percentWidth : Number
Eine Zahl, die die Breite einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts festlegt. | IUIComponent | |
| restrict : String
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. | IUITextField | ||
| root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | IFlexDisplayObject | |
| rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | IFlexDisplayObject | |
| scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | IFlexDisplayObject | |
| scaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an. | IFlexDisplayObject | |
| scaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | IFlexDisplayObject | |
| scrollH : int
Die aktuelle horizontale Bildlaufposition. | IUITextField | ||
| scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | IFlexDisplayObject | |
| scrollV : int
Die vertikale Textposition in einem Textfeld. | IUITextField | ||
| selectable : Boolean
Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann. | IUITextField | ||
| selectionBeginIndex : int [schreibgeschützt]
Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl. | IUITextField | ||
| selectionEndIndex : int [schreibgeschützt]
Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. | IUITextField | ||
| sharpness : Number
Die Schärfe der Glyphenkanten in diesem Textfeld. | IUITextField | ||
| stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | IFlexDisplayObject | |
| styleName : Object
Die Quelle der Stilwerte dieses Objekts. | ISimpleStyleClient | |
| styleSheet : StyleSheet
Fügt ein Stylesheet an das Textfeld an. | IUITextField | ||
| systemManager : ISystemManager
Ein Verweis auf das SystemManager-Objekt für diese Komponente. | IUIComponent | |
| tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | IUITextField | ||
| tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | IUITextField | ||
| text : String
Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt. | IUITextField | ||
| textColor : uint
Die Farbe des Textes in einem Textfeld (im Hexadezimalformat). | IUITextField | ||
| textHeight : Number [schreibgeschützt]
Die Höhe des Texts in Pixel. | IUITextField | ||
| textWidth : Number [schreibgeschützt]
Die Breite des Texts in Pixel. | IUITextField | ||
| thickness : Number
Die Stärke der Glyphenkanten in diesem Textfeld. | IUITextField | ||
| toolTip : String
Der Text der QuickInfo dieser Komponente. | IToolTipManagerClient | |
| transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | IFlexDisplayObject | |
| tweeningProperties : Array
Vom EffectManager verwendet. | IUIComponent | |
| type : String
Der Typ des Textfelds. | IUITextField | ||
| useRichTextClipboard : Boolean
Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird. | IUITextField | ||
| visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | IFlexDisplayObject | |
| width : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an. | IFlexDisplayObject | |
| wordWrap : Boolean
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird. | IUITextField | ||
| x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IFlexDisplayObject | |
| y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IFlexDisplayObject | |
| 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 vom Parameter „newText“ angegebenen String an das Ende des Texts im Textfeld an. | IUITextField | ||
|
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | |
|
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | IFlexDisplayObject | |
Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt. | IUITextField | ||
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück. | IUITextField | ||
|
Eine bequeme Methode, um anzugeben, ob die explizite oder gemessene Höhe verwendet werden soll
| IUIComponent | |
|
Eine bequeme Methode, um anzugeben, ob die explizite oder gemessene Breite verwendet werden soll
| IUIComponent | |
Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück. | IUITextField | ||
Gibt einen DisplayObject-Verweis für die jeweilige ID, ein Bild oder eine SWF-Datei zurück, die bzw. das einem HTML-formatierten Textfeld über ein <img>-Tag hinzugefügt wurde. | IUITextField | ||
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück. | IUITextField | ||
Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom Parameter „charIndex“ angegebene Zeichen enthält. | IUITextField | ||
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück. | IUITextField | ||
Gibt metrische Informationen zu einer bestimmten Textzeile zurück. | IUITextField | ||
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter „lineIndex“ angegebenen Zeile zurück. | IUITextField | ||
Gibt den Text der durch den Parameter „lineIndex“ angegebenen Zeile zurück. | IUITextField | ||
Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück. | IUITextField | ||
|
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | IFlexDisplayObject | |
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist. | IUITextField | ||
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter „beginIndex“ und „endIndex“ angegebenen Textbereich zurück. | IUITextField | ||
Gibt ein UITextFormat-Objekt zurück, das Formatierungsinformationen für diese Komponente enthält. | IUITextField | ||
|
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | IFlexDisplayObject | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | |
|
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | IFlexDisplayObject | |
|
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | IFlexDisplayObject | |
|
Initialisiert das Objekt. | IUIComponent | |
|
Der Aufruf dieser Methode bewirkt einen Aufruf der validateDisplayList()-Methode der Komponente, bevor die Anzeigeliste wiedergegeben wird. | IInvalidating | |
|
Der Aufruf dieser Methode bewirkt einen Aufruf der validateProperties()-Methode der Komponente, bevor die Anzeigeliste wiedergegeben wird. | IInvalidating | |
|
Der Aufruf dieser Methode bewirkt einen Aufruf der validateSize()-Methode der Komponente, bevor die Anzeigeliste wiedergegeben wird. | IInvalidating | |
|
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | IFlexDisplayObject | |
|
Verschiebt dieses Objekt an die angegebenen x- und y-Koordinaten. | IFlexDisplayObject | |
|
Gibt „true“ zurück, wenn die Kette von „owner“-Eigenschaften von „child“ auf diese UIComponent verweist. | IUIComponent | |
|
Wird von Flex aufgerufen, wenn ein UIComponent-Objekt einem übergeordneten Element hinzugefügt oder daraus entfernt wird. | IUIComponent | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | |
Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters „value“. | IUITextField | ||
Ersetzt den Zeichenbereich, der durch die Parameter „beginIndex“ und „endIndex“ angegeben wird, durch den Inhalt des Parameters „newText“. | IUITextField | ||
|
Legt die tatsächliche Größe dieses Objekts fest. | IFlexDisplayObject | |
Legt die Schriftfarbe des Texts fest. | IUITextField | ||
Legt den Fokus auf diese Komponente. | IUITextField | ||
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter „beginIndex und „endIndex“) angegebenen Text als ausgewählt fest. | IUITextField | ||
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter „format“ angegebene Textformatierung zu. | IUITextField | ||
|
Wird aufgerufen, wenn sich die visible-Eigenschaft ändert. | IUIComponent | |
|
Wird ausgelöst, wenn der Wert einer Stileigenschaft geändert wird. | ISimpleStyleClient | |
Kürzt den Text so, dass er horizontal in den für dieses Steuerelement definierten Bereich passt, und hängt an das Ende des gekürzten Texts drei Punkte (...) an. | IUITextField | ||
|
Überprüft und aktualisiert die Eigenschaften und das Layout dieses Objekts, indem erforderlichenfalls unverzüglich validateProperties(), validateSize() und validateDisplayList() aufgerufen wird. | IInvalidating | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher | |
alwaysShowSelection | Eigenschaft |
alwaysShowSelection:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn sich das Textfeld bei Einstellung true nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in grau. Wenn sich das Textfeld bei Einstellung false nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld nicht.
Implementierung
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidantiAliasType | Eigenschaft |
antiAliasType:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der für dieses Textfeld verwendete Anti-Aliasing-Typ. Verwenden Sie flash.text.AntiAliasType-Konstanten für diese Eigenschaft. Sie können diese Einstellung nur dann steuern, wenn die Schriftart eingebettet ist (die Eigenschaft embedFonts ist auf true gesetzt). Die Standardeinstellung ist flash.text.AntiAliasType.NORMAL.
Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:
| Stringwert | Beschreibung |
|---|---|
flash.text.AntiAliasType.NORMAL | Wendet das normale Text-Anti-Aliasing an. Dieser Wert entspricht dem Anti-Aliasing-Typ, den Flash Player 7 und frühere Versionen verwendeten. |
flash.text.AntiAliasType.ADVANCED | Wendet erweitertes Anti-Aliasing an, sodass der Text besser lesbar ist. (Diese Funktion ist seit Flash Player 8 verfügbar.) Erweitertes Anti-Aliasing ermöglicht die hochwertige Wiedergabe von kleinen Schriftarten. Es eignet sich am besten für Anwendungen mit sehr viel kleinem Text. Das erweiterte Anti-Aliasing bietet sich hingegen nicht für große Schriften (über 48 Punkte) an. |
Implementierung
public function get antiAliasType():String public function set antiAliasType(value:String):voidautoSize | Eigenschaft |
autoSize:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Steuert die automatische Größenänderung und Ausrichtung von Textfeldern. Zulässige Werte für die TextFieldAutoSize-Konstanten: TextFieldAutoSize.NONE (Standard), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT und TextFieldAutoSize.CENTER.
Wurde autoSize auf den Standardwert TextFieldAutoSize.NONE gesetzt, erfolgt keine Größenänderung.
Wurde autoSize auf TextFieldAutoSize.LEFT gesetzt, wird der Text als linksbündiger Text behandelt, d. h., die linke Seite des Textfelds bleibt fixiert, und Größenänderungen eines einzeiligen Textfelds werden auf der rechten Seite vorgenommen. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die rechte Seite bleibt dagegen unverändert.
Wurde autoSize auf TextFieldAutoSize.RIGHT gesetzt, wird der Text als rechtsbündiger Text behandelt, d. h., die rechte Seite des Textfelds bleibt fixiert, und Größenänderungen eines einzeiligen Textfelds werden auf der linken Seite vorgenommen. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die linke Seite bleibt dagegen unverändert.
Wurde autoSize auf TextFieldAutoSize.CENTER gesetzt, wird der Text als zentriert behandelt, d. h., eine Änderung der Größe eines einzeiligen Textfelds wird gleichmäßig auf den rechten und linken Rand verteilt. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die linke und rechte Seite bleiben dagegen unverändert.
Implementierung
public function get autoSize():String public function set autoSize(value:String):voidbackground | Eigenschaft |
background:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob das Textfeld einen gefüllten Hintergrund aufweist. Bei true weist das Textfeld einen gefüllten Hintergrund auf. Bei false weist das Textfeld keinen gefüllten Hintergrund auf. Mit der Eigenschaft backgroundColor legen Sie die Hintergrundfarbe eines Textfelds fest.
Implementierung
public function get background():Boolean public function set background(value:Boolean):voidbackgroundColor | Eigenschaft |
backgroundColor:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Hintergrundfarbe des Textfelds an. Der Standardwert ist 0xFFFFFF (weiß). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Hintergrund verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft background des Textfelds true ist.
Implementierung
public function get backgroundColor():uint public function set backgroundColor(value:uint):voidborder | Eigenschaft |
border:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob das Textfeld umrahmt ist. Bei true ist das Textfeld umrahmt. Bei false weist das Textfeld keinen Rahmen auf. Mit der Eigenschaft borderColor können Sie die Rahmenfarbe festlegen.
Implementierung
public function get border():Boolean public function set border(value:Boolean):voidborderColor | Eigenschaft |
borderColor:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Farbe des Textfeldrahmens an. Der Standardwert ist 0x000000 (schwarz). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Rahmen verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft border des Textfelds true ist.
Implementierung
public function get borderColor():uint public function set borderColor(value:uint):voidbottomScrollV | Eigenschaft |
bottomScrollV:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt. Das Textfeld kann als Fenster zur Anzeige eines Textblocks betrachtet werden. Die Eigenschaft scrollV ist der auf eins basierende Index der obersten sichtbaren Zeile im Fenster.
Der gesamte Text zwischen den durch scrollV und bottomScrollV begrenzten Zeilen ist zurzeit im Textfeld sichtbar.
Implementierung
public function get bottomScrollV():intcaretIndex | Eigenschaft |
caretIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Index der Position der Einfügemarke. Wenn keine Einfügemarke angezeigt wird, ergibt sich der Wert aus der Position, die die Einfügemarke erhält, wenn das Feld den Fokus zurückerlangt (normalerweise die Stelle, an der sich die Einfügemarke zuvor befunden hat, oder 0, wenn das Feld bislang nicht den Fokus hatte).
Indizes für Auswahlbereiche haben die Basis null (d. h. die erste Position ist 0, die zweite Position 1 usw.).
Implementierung
public function get caretIndex():intcondenseWhite | Eigenschaft |
condenseWhite:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text entfernt werden sollen. Der Standardwert ist false. Die Eigenschaft condenseWhite betrifft nur Text mit der Eigenschaft htmlText, nicht mit der Eigenschaft text. Wenn Sie Text mit der Eigenschaft text festlegen, wird condenseWhite ignoriert.
Wenn condenseWhite auf true gesetzt ist, verwenden Sie HTML-Standardbefehle wie <BR> und <P>, um in das Textfeld Zeilenumbrüche einzufügen.
Legen Sie die Eigenschaft condenseWhite fest, bevor Sie die Eigenschaft htmlText festlegen.
Implementierung
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voiddefaultTextFormat | Eigenschaft |
defaultTextFormat:flash.text:TextFormat| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()-Methode eingefügt wird) angewendet wird.
Hinweis: Wenn Zeichen ausgewählt werden, die mit setSelection() und replaceSelectedText() ersetzt werden sollen, wird das defaultTextFormat nur angewendet, wenn der Text bis zu und einschließlich dem letzten Zeichen ausgewählt wurde. Hier ist ein Beispiel:
var my_txt:TextField new TextField();
my_txt.text = "Flash Macintosh version";
var my_fmt:TextFormat = new TextFormat();
my_fmt.color = 0xFF0000;
my_txt.defaultTextFormat = my_fmt;
my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
my_txt.replaceSelectedText("Windows version");
Bei Aufruf der Eigenschaft defaultTextFormat sind alle Eigenschaften des zurückgegebenen TextFormat-Objekts definiert. Keine Eigenschaft besitzt den Wert null.
Hinweis: Diese Eigenschaft kann nicht festgelegt werden, wenn ein Stylesheet auf das Textfeld angewendet wird.
Implementierung
public function get defaultTextFormat():flash.text:TextFormat public function set defaultTextFormat(value:flash.text:TextFormat):voiddisplayAsPassword | Eigenschaft |
displayAsPassword:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voiddoubleClickEnabled | Eigenschaft |
doubleClickEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob dieses Objekt doubleClick-Ereignisse empfängt. Der Standardwert ist false. Das heißt, dass eine InteractiveObject-Instanz standardmäßig keine doubleClick-Ereignisse erhält. Ist die doubleClickEnabled-Eigenschaft auf true gesetzt, empfängt die Instanz doubleClick-Ereignisse innerhalb ihrer Grenzen. Die mouseEnabled-Eigenschaft der InteractiveObject-Instanz muss ebenfalls auf true gesetzt werden, damit das Objekt doubleClick-Ereignisse empfängt.
Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Sie müssen die addEventListener()-Methode verwenden, um einen Ereignis-Listener für das doubleClick-Ereignis hinzuzufügen.
Implementierung
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidembedFonts | Eigenschaft |
embedFonts:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob bei der Wiedergabe eingebettete Schriftkonturen verwendet werden sollen. Bei false wird das Textfeld mit Geräteschriftarten dargestellt.
Wenn Sie die Eigenschaft embedFonts für ein Textfeld auf true setzen, müssen Sie für diesen Text mit der Eigenschaft font eines auf das Textfeld angewendeten TextFormat-Objekts eine Schriftart angeben. Wenn die angegebene Schriftart nicht in der SWF-Datei eingebettet ist, wird der Text nicht angezeigt.
Implementierung
public function get embedFonts():Boolean public function set embedFonts(value:Boolean):voidfocusRect | Eigenschaft |
focusRect:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. Es sind drei Werte möglich: true, false oder null. Die Werte true und false geben an, ob ein Fokusrechteck angezeigt wird oder nicht. Der Wert null gibt an, dass dieses Objekt der stageFocusRect-Eigenschaft der Bühne unterliegt.
Implementierung
public function get focusRect():Object public function set focusRect(value:Object):voidgridFitType | Eigenschaft |
gridFitType:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die für dieses Textfeld verwendete Art der Rasteranpassung. Diese Eigenschaft gilt nur dann, wenn die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt ist.
Anhand der verwendeten Art der Rasteranpassung wird bestimmt, ob Flash Player breite horizontale und vertikale Linien an ein Pixel- oder Subpixelraster anpasst.
Für die Eigenschaft flash.text.GridFitType können Sie die folgenden Stringwerte verwenden:
| Stringwert | Beschreibung |
|---|---|
flash.text.GridFitType.NONE | Definiert keine Rasteranpassung. Horizontale und vertikale Linien in den Glyphen werden nicht am Pixelraster ausgerichtet. Diese Einstellung wird für Animationen und große Schriftgrade empfohlen. |
flash.text.GridFitType.PIXEL | Definiert die Anpassung breiter horizontaler und vertikaler Linien an das Pixelraster. Diese Einstellung funktioniert nur für linksbündig ausgerichtete Textfelder. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.display.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Diese Einstellung bietet im Allgemeinen die beste Lesbarkeit für linksbündigen Text. |
flash.text.GridFitType.SUBPIXEL | Breite horizontale und vertikale Linien werden an das Sub-Pixelraster auf LCD-Displays angepasst. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Die Einstellung flash.text.GridFitType.SUBPIXEL eignet sich oft für rechtsbündigen oder zentrierten dynamischen Text und ist manchmal eine praktische Alternative, wenn zwischen Animations- und Textqualität abzuwägen ist. |
Implementierung
public function get gridFitType():String public function set gridFitType(value:String):voidhtmlText | Eigenschaft |
htmlText:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Enthält die HTML-Darstellung des Inhalts des Textfelds.
Flash Player unterstützt die folgenden HTML-Tags:
| Tag | Beschreibung |
|---|---|
| Anker-Tag |
Mit dem Tag <a> wird ein Hyperlink erstellt. Das Tag unterstützt die folgenden Attribute:
|
| Fettdruck-Tag |
Mit dem Tag <b> wird Text fett dargestellt. Für die verwendete Schriftart muss ein fettes Schriftbild vorhanden sein.
|
| Zeilenumbruch-Tag |
Das Tag <br> fügt einen Zeilenumbruch in das Textfeld ein. Definieren Sie das Textfeld als mehrzeiliges Textfeld, um dieses Tag zu verwenden.
|
| Schriftart-Tag |
Mit dem Tag <font> legen Sie fest, welche Schriftarten für die Textanzeige verwendet werden. Die folgenden Attribute werden vom font-Tag unterstützt::
|
| Bild-Tag |
Mit dem Tag <img> können Sie externe Bilddateien (JPEG, GIF, PNG), SWF-Dateien und Movieclips in Textfelder einbetten. Text fließt automatisch um in Textfelder eingebettete Bilder herum. Sie müssen das Textfeld als mehrzeilig definieren, um Text um ein Bild fließen zu lassen.
Die folgenden Attribute werden vom
Medieninhalte, die in Textfelder eingebettet sind, werden in voller Größe angezeigt. Um die Abmessung der Medien anzugeben, die Sie einbetten, verwenden Sie das Im Allgemeinen wird ein in ein Textfeld eingebettetes Bild in der Zeile nach dem Tag Wenn sich in der Sicherheitssandbox der Anwendung AIR-Inhalt befindet, ignoriert AIR |
| Kursiv-Tag |
Mit dem <i>-Tag markierter Text wird kursiv angezeigt. Für die verwendete Schriftart muss ein kursives Schriftbild vorhanden sein.
|
| Listenelement-Tag |
Das Tag <li> sorgt dafür, dass vor dem Text, der vom Tag umschlossen ist, ein Aufzählungszeichen platziert wird. Hinweis: Dae Flash Player und AIR sortierte und unsortierte Listen-Tags (<ol> und <ul> nicht erkennen, ändern sie nicht, wie Ihre Liste wiedergegeben wird. Alle Listen werden unsortiert und mit Aufzählungszeichen vor jedem einzelnen Element angezeigt.
|
| Absatz-Tag |
Mit dem Tag <p> wird ein neuer Absatz erstellt. Das Textfeld muss als mehrzeiliges Textfeld definiert werden, um dieses Tag zu verwenden. Die folgenden Attribute werden vom <p>-Tag unterstützt:
|
| Bereichs-Tag |
Das Tag <span> ist nur im Einsatz mit CSS-Textstilen verfügbar. Das folgende Attribut wird dabei unterstützt:
|
| Textformat-Tag |
Mit dem Tag Die folgenden Attribute werden vom Tag
|
| Unterstreichungs-Tag |
Mit dem <u>-Tag markierter Text wird unterstrichen angezeigt.
|
Flash Player und AIR unterstützen die folgenden HTML-Entitäten:
| Entität | Beschreibung |
|---|---|
| < | < (kleiner als) |
| > | > (größer als) |
| & | & (Und-Zeichen) |
| " | " (doppelte Anführungszeichen) |
| ' | ' (Apostroph, einfaches Anführungszeichen) |
Flash Player und AIR unterstützen auch explizite Zeichencodes wie z. B. & (Und-Zeichen, ASCII) und € ( €-Symbol, Unicode).
Implementierung
public function get htmlText():String public function set htmlText(value:String):voidignorePadding | Eigenschaft |
ignorePadding:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn true, fügen die Stile paddingLeft und paddingRight keinen Platz um den Text der Komponente herum ein.
Implementierung
public function get ignorePadding():Boolean public function set ignorePadding(value:Boolean):voidinheritingStyles | Eigenschaft |
inheritingStyles:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Beginn der Vererbungsstilkette für dieses UITextField. Die getStyle()-Methode greift auf inheritingStyles[styleName] zu, um die vollständige, mit dem Entwurf verknüpfte Kette zu durchsuchen. Dieses Objekt wird durch die initProtoChain()-Methode eingerichtet. Unter normalen Umständen brauchen Sie auf diese Eigenschaft nie direkt zuzugreifen.
Implementierung
public function get inheritingStyles():Object public function set inheritingStyles(value:Object):voidlength | Eigenschaft |
maxChars | Eigenschaft |
maxChars:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voidmaxScrollH | Eigenschaft |
maxScrollV | Eigenschaft |
mouseEnabled | Eigenschaft |
mouseEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. Der Standardwert ist true, d. h., dass standardmäßig jede InteractiveObject-Instanz, die sich in der Anzeigeliste befindet, Mausereignisse oder andere Benutzereingabeereignisse erhält. Wenn mouseEnabled auf false eingestellt ist, empfängt die Instanz keine Mausereignisse (oder andere Benutzereingabeereignisse wie Tastaturereignisse). Untergeordnete Elemente dieser Instanz in der Anzeigeliste sind nicht betroffen. Wenn Sie das mouseEnabled-Verhalten für alle Objekte ändern möchten, die einem Objekt in der Anzeigeliste untergeordnet sind, verwenden Sie flash.display.DisplayObjectContainer.mouseChildren.
Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Um interaktive Funktionalität zu erzielen, müssen Sie die addEventListener()-Methode verwenden.
Implementierung
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidmouseWheelEnabled | Eigenschaft |
mouseWheelEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht. Der Standardwert ist true. Diese Eigenschaft ist nützlich, wenn Sie verhindern möchten, dass in Textfeldern ein Bildlauf mit dem Mausrad durchgeführt wird oder wenn Sie Ihre eigene Bildlaufeigenschaften für Textfelder erstellen möchten.
Implementierung
public function get mouseWheelEnabled():Boolean public function set mouseWheelEnabled(value:Boolean):voidmultiline | Eigenschaft |
multiline:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voidnestLevel | Eigenschaft |
nestLevel:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Tiefe dieses Objekts in der enthaltenden Hierarchie. Diese Zahl wird vom Messungs- und Layoutcode verwendet. Der Wert ist 0, wenn diese Komponente nicht in der DisplayList enthalten ist.
Implementierung
public function get nestLevel():int public function set nestLevel(value:int):voidnonInheritingStyles | Eigenschaft |
nonInheritingStyles:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Beginn der Kette nicht vererbter Stile für dieses UITextField. Die getStyle()-Methode greift auf nonInheritingStyles[styleName] zu, um die vollständige, mit dem Entwurf verknüpfte Kette zu durchsuchen. Dieses Objekt wird durch die initProtoChain()-Methode eingerichtet. Unter normalen Umständen brauchen Sie auf diese Eigenschaft nie direkt zuzugreifen.
Implementierung
public function get nonInheritingStyles():Object public function set nonInheritingStyles(value:Object):voidnonZeroTextHeight | Eigenschaft |
nonZeroTextHeight:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Im Unterschied zu textHeight gibt diese Methode einen Wert zurück, der nicht null ist, selbst wenn der Text leer ist. In diesem Fall gibt die Methode den Wert zurück, den textHeight hätte, wenn der Text nicht leer wäre.
Implementierung
public function get nonZeroTextHeight():NumbernumLines | Eigenschaft |
numLines:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an. Falls die Eigenschaft wordWrap auf true gesetzt ist, erhöht sich die Zeilenzahl beim Textumbruch.
Implementierung
public function get numLines():intrestrict | Eigenschaft |
restrict:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voidscrollH | Eigenschaft |
scrollH:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die aktuelle horizontale Bildlaufposition. Ist die Eigenschaft scrollH auf 0 gesetzt, erfolgt kein horizontaler Bildlauf. Bei diesem Eigenschaftswert handelt es sich um eine Ganzzahl, die die horizontale Position in Pixeln angibt.
Die Maßeinheit für den horizontalen Bildlauf sind Pixel, die Maßeinheit für den vertikalen Bildlauf Zeilen. Der horizontale Bildlauf wird in Pixeln gemessen, da die am häufigsten verwendeten Schriftarten normalerweise Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Hierbei kommt es nicht darauf an, ob eine Zeile mehrere Schriftarten enthält, da die Höhe der Zeile immer an die größte verwendete Schriftart angepasst wird.
Hinweis: Die Eigenschaft scrollH basiert auf 0, nicht auf 1 wie die Eigenschaft scrollV für den vertikalen Bildlauf.
Implementierung
public function get scrollH():int public function set scrollH(value:int):voidscrollV | Eigenschaft |
scrollV:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die vertikale Textposition in einem Textfeld. Die Eigenschaft scrollV ist besonders nützlich, wenn Benutzer auf einen bestimmten Abschnitt in einem längeren Text hingewiesen werden sollen, und bietet sich auch zum Erstellen von Textfeldern an, in denen ein Bildlauf durchgeführt werden kann.
Die Maßeinheit für den vertikalen Bildlauf sind Zeilen, die Maßeinheit für den horizontalen Bildlauf Pixel. Wenn die erste angezeigte Zeile auch die erste Zeile im Textfeld ist, hat „scrollV“ den Wert 1 (nicht 0). Der horizontale Bildlauf wird in Pixeln gemessen, da die meisten Schriftarten Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Selbst wenn eine Zeile mehrere Schriftarten enthält, wird die Höhe der Zeile an die größte verwendete Schriftart angepasst.
Implementierung
public function get scrollV():int public function set scrollV(value:int):voidselectable | Eigenschaft |
selectable:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voidselectionBeginIndex | Eigenschaft |
selectionBeginIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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, hat diese Eigenschaft den Wert caretIndex.
Implementierung
public function get selectionBeginIndex():intselectionEndIndex | Eigenschaft |
selectionEndIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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, hat diese Eigenschaft den Wert caretIndex.
Implementierung
public function get selectionEndIndex():intsharpness | Eigenschaft |
sharpness:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Schärfe der Glyphenkanten in diesem Textfeld. Diese Eigenschaft gilt nur dann, wenn die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt ist. Der Wert für sharpness kann aus dem Bereich von -400 bis 400 gewählt werden. Wenn Sie versuchen, sharpness auf einen Wert außerhalb dieses Bereichs zu setzen, setzt Flash die Eigenschaft auf den nächstgelegenen Wert im Bereich (-400 oder 400).
Implementierung
public function get sharpness():Number public function set sharpness(value:Number):voidstyleSheet | Eigenschaft |
styleSheet:StyleSheet| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fügt ein Stylesheet an das Textfeld an. Informationen zum Erstellen von Stylesheets finden Sie im Eintrag zur StyleSheet-Klasse und im ActionScript 3.0 Entwicklerhandbuch.
Sie können das mit einem Textfeld verknüpfte Stylesheet jederzeit ändern. Bei Änderung des verwendeten Stylesheets wird das Textfeld mit dem neuen Stylesheet neu gezeichnet. Wenn Sie das Stylesheet entfernen möchten, setzen Sie es auf null oder undefined. Wenn Sie das verwendete Stylesheet entfernen, wird das Textfeld ohne Stylesheet neu gezeichnet.
Hinweis: Wenn das Stylesheet entfernt wird, wird der Inhalt von TextField.text und TextField.htmlText in der vorher vom Stylesheet angewendeten Formatierung angezeigt. Um den ursprünglichen Inhalt von TextField.htmlText ohne Formatierung zu bewahren, speichern Sie den Wert in einer Variablen, bevor Sie das Stylesheet entfernen.
Implementierung
public function get styleSheet():StyleSheet public function set styleSheet(value:StyleSheet):voidtabEnabled | Eigenschaft |
tabEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. Liegt dieses Objekt in der Tabulatorreihenfolge vor, ist der Wert true, andernfalls false. Der Standardwert ist false, mit folgender Ausnahme:
- Bei einem SimpleButton-Objekt lautet der Wert
true. - Bei einem TextField-Objekt mit
type = "input"lautet der Werttrue. - Bei einem Sprite-Objekt oder MovieClip-Objekt mit
buttonMode = truelautet der Werttrue.
Implementierung
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | Eigenschaft |
tabIndex:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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):voidtext | Eigenschaft |
text:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt. Zeilen sind durch das Wagenrücklaufzeichen ('\r', ASCII 13) getrennt. Diese Eigenschaft enthält unformatierten Text im Textfeld (ohne HTML-Tags).
Verwenden Sie die Eigenschaft htmlText, um den Text in das HTML-Format zu konvertieren.
Hinweis: Wenn ein Stylesheet auf das Textfeld angewendet wird, wird der Inhalt der text-Eigenschaft als HTML interpretiert.
Implementierung
public function get text():String public function set text(value:String):voidtextColor | Eigenschaft |
textColor:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Farbe des Textes in einem Textfeld (im Hexadezimalformat). Das Hexadezimalfarbsystem stellt Farbwerte anhand von sechs Ziffern dar. Jede Ziffer hat 16 mögliche Werte oder Zeichen. Die Zeichen reichen von 0-9 und dann A-F. Schwarz ist beispielsweise 0x000000; weiß ist 0xFFFFFF.
Implementierung
public function get textColor():uint public function set textColor(value:uint):voidtextHeight | Eigenschaft |
textWidth | Eigenschaft |
thickness | Eigenschaft |
thickness:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Stärke der Glyphenkanten in diesem Textfeld. Diese Eigenschaft gilt nur dann, wenn flash.text.AntiAliasType auf flash.text.AntiAliasType.ADVANCED gesetzt ist.
Der Wert für thickness kann aus dem Bereich von -200 bis 200 gewählt werden. Wenn Sie versuchen, thickness auf einen Wert außerhalb dieses Bereichs zu setzen, wird die Eigenschaft auf den nächstgelegenen Wert im Bereich gesetzt (-200 oder 200).
Implementierung
public function get thickness():Number public function set thickness(value:Number):voidtype | Eigenschaft |
type:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Typ des Textfelds. Eine der folgenden TextFieldType-Konstanten: TextFieldType.DYNAMIC zur Angabe eines dynamischen Textfelds, das nicht von den Benutzern bearbeitet werden kann, oder TextFieldType.INPUT zur Angabe eines Eingabefelds, das von den Benutzern bearbeitet werden kann.
Implementierung
public function get type():String public function set type(value:String):voiduseRichTextClipboard | Eigenschaft |
useRichTextClipboard:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird. Wenn dieses Objekt auf true gesetzt ist, kopiert Flash Player Formatierungen (wie z. B. Ausrichtung, fett und kursiv) und fügt diese ein, wenn Sie zwischen Textfeldern kopieren und einfügen. Sowohl im Ausgangs- als auch im Zieltextfeld des Kopier- und Einfügevorgangs muss useRichTextClipboard auf true gesetzt sein. Der Standardwert ist false.
Implementierung
public function get useRichTextClipboard():Boolean public function set useRichTextClipboard(value:Boolean):voidwordWrap | Eigenschaft |
wordWrap:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird. Wenn die Eigenschaft wordWrap auf true gesetzt ist, findet im Textfeld ein Zeilenumbruch statt. Wenn der Wert false ist, findet im Textfeld kein Zeilenumbruch statt. Der Standardwert ist false.
Implementierung
public function get wordWrap():Boolean public function set wordWrap(value:Boolean):voidappendText | () | Methode |
public function appendText(newText:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Hängt den vom Parameter newText angegebenen String an das Ende des Texts im Textfeld an. Diese Methode ist effizienter als eine Additionszuweisung (+=) bei einer text-Eigenschaft (wie z. B. someTextField.text += moreText), insbesondere bei Textfeldern mit erheblichem Inhalt.
Parameter
newText:String — Der an den vorhandenen Text anzuhängende String.
|
getCharBoundaries | () | Methode |
public function getCharBoundaries(charIndex:int):Rectangle| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.).
|
Rectangle — Ein Rechteck mit Mindest- und Höchstwerten für x und y, mit dem die Begrenzungsbox für das Zeichen definiert wird.
|
getCharIndexAtPoint | () | Methode |
public function getCharIndexAtPoint(x:Number, y:Number):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.
Parameter
x:Number — Die x-Koordinate des Zeichens.
| |
y:Number — Die y-Koordinate des Zeichens.
|
int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einem Zeichen.
|
getFirstCharInParagraph | () | Methode |
public function getFirstCharInParagraph(charIndex:int):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Der auf null basierende Indexwert des ersten Zeichens im gleichen Absatz.
|
getImageReference | () | Methode |
public function getImageReference(id:String):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt einen DisplayObject-Verweis für die angegebene id zurück, bei einem Bild bzw. einer SWF-Datei, das/die einem HTML-formatierten Textfeld mit dem Tag <img> hinzugefügt wurde. Das Tag <img> liegt im folgenden Format vor:
<img src = 'filename.jpg' id = 'instanceName' >Parameter
id:String — Die id, für die eine Entsprechung vorliegen muss (im Attribut id des Tags <img>).
|
DisplayObject — Das Anzeigeobjekt, das dem Bild bzw. der SWF-Datei mit dem passenden id-Attribut im Tag <img> des Textfelds entspricht. Bei Medien von einer externen Quelle handelt es sich um ein Loader-Objekt. Sobald das Medienobjekt geladen ist, handelt es sich um ein untergeordnetes Objekt dieses Loader-Objekts. Für in die SWF-Datei eingebetteten Medien ist dies das geladene Objekt. Wenn kein <img>-Tag mit der übereinstimmenden id existiert, gibt die Methode null zurück.
|
getLineIndexAtPoint | () | Methode |
public function getLineIndexAtPoint(x:Number, y:Number):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den auf null basierenden Indexwert der Zeile an dem von den Parametern x und y angegebenen Punkt zurück.
Parameter
x:Number — Die x-Koordinate der Zeile.
| |
y:Number — Die y-Koordinate der Zeile.
|
int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einer Zeile.
|
getLineIndexOfChar | () | Methode |
public function getLineIndexOfChar(charIndex:int):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom charIndex-Parameter angegebene Zeichen enthält.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Der auf null basierende Indexwert der Zeile.
|
getLineLength | () | Methode |
public function getLineLength(lineIndex:int):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.
Parameter
lineIndex:int — Die Nummer der Zeile, deren Länge Sie ermitteln möchten.
|
int — Die Anzahl der Zeichen in der Zeile.
|
getLineMetrics | () | Methode |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt metrische Informationen zu einer bestimmten Textzeile zurück.
Parameter
lineIndex:int — Die Nummer der Zeile, für die Sie metrische Informationen ermitteln möchten.
|
flash.text:TextLineMetrics — Ein TextLineMetrics-Objekt.
|
getLineOffset | () | Methode |
public function getLineOffset(lineIndex:int):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter lineIndex angegebenen Zeile zurück.
Parameter
lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).
|
int — Der auf null basierende Indexwert des ersten Zeichens in der Zeile.
|
getLineText | () | Methode |
public function getLineText(lineIndex:int):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den Text der durch den Parameter lineIndex angegebenen Zeile zurück.
Parameter
lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).
|
String — Der in der angegebenen Zeile enthaltene Textstring.
|
getParagraphLength | () | Methode |
public function getParagraphLength(charIndex:int):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück. Die Länge wird relativ zum ersten Zeichen im Absatz (wie von getFirstCharInParagraph() zurückgegeben) und nicht zum vorliegenden Zeichenindex angegeben.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Gibt die Anzahl der Zeichen im Absatz zurück.
|
getStyle | () | Methode |
public function getStyle(styleProp:String):*| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.
Mit dieser Methode wird eine beliebige Stileigenschaft abgerufen. Es kann also ein boolescher Wert, ein String, eine Zahl, eine Ganzzahl, eine vorzeichenlose Ganzzahl (für eine RGB-Farbe), eine Klasse (für eine Skin) oder ein beliebiges Objekt zurückgegeben werden. Deshalb wird als Rückgabetyp einfach nur * angegeben.
Wenn Sie eine bestimmte Stileigenschaft abrufen, kennen Sie ihren Typ und möchten das Ergebnis häufig in einer Variable dieses Typs speichern. Es ist keine Umwandlung von * in diesen Typ erforderlich.
var backgroundColor:uint = getStyle("backgroundColor");
Wenn die Stileigenschaft in der Stilsuchkette nicht festgelegt wurde, lautet der Rückgabewert der getStyle()-Methode undefined. Beachten Sie, dass es sich bei undefined um einen speziellen Wert handelt, der sich von false, "", NaN, 0 und null unterscheidet. Ein gültiger Stilwert kann niemals undefined sein. Mit der Methode StyleManager2.isValidStyleValue() können Sie überprüfen, ob der Wert festgelegt wurde.
Parameter
styleProp:String — Name der style-Eigenschaft.
|
* — Der Stilwert.
|
getTextFormat | () | Methode |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter beginIndex und endIndex angegebenen Textbereich zurück. Nur Eigenschaften, die für den gesamten Text gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null gesetzt.
Wenn Sie keine Werte für diese Parameter angeben, wird diese Methode auf den gesamten Text im Textfeld angewendet.
In der folgenden Tabelle sind drei Verwendungsmöglichkeiten aufgeführt:
| Verwendung | Beschreibung |
|---|---|
my_textField.getTextFormat() | Gibt ein TextFormat-Objekt mit den Formatierungsinformationen für den gesamten Text in einem Textfeld zurück. Nur Eigenschaften, die für den gesamten Text im Textfeld gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null gesetzt. |
my_textField.getTextFormat(beginIndex:Number) | Gibt ein TextFormat-Objekt mit einer Kopie des Textformats an der durch beginIndex gekennzeichneten Position zurück. |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den Textbereich zwischen beginIndex und endIndex-1 zurück. Nur Eigenschaften, die für den gesamten Text im angegebenen Textbereich gelten, sind im resultierenden TextFormat-Objekt eingestellt. Alle „gemischten“ Eigenschaften (mixed), die an unterschiedlichen Stellen im Textbereich unterschiedliche Werte aufweisen, besitzen den Wert null. |
Parameter
beginIndex:int (default = -1) | |
endIndex:int (default = -1)beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 gelesen.
|
flash.text:TextFormat — Das TextFormat-Objekt, das die Formatierungseigenschaften des angegebenen Texts wiedergibt.
|
getUITextFormat | () | Methode |
public function getUITextFormat():mx.core:UITextFormat| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein UITextFormat-Objekt zurück, das Formatierungsinformationen für diese Komponente enthält. Diese Methode ähnelt der getTextFormat()-Methode der flash.text.TextField-Klasse, sie gibt jedoch ein UITextFormat-Objekt statt eines TextFormat-Objekts zurück.
Die UITextFormat-Klasse erweitert die TextFormat-Klasse zum Hinzufügen der Textmessungsmethoden measureText() und measureHTMLText().
mx.core:UITextFormat — Ein Objekt mit Formatierungsinformationen für diese Komponente.
|
replaceSelectedText | () | Methode |
public function replaceSelectedText(value:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters value. Der Text wird an der Stelle eingefügt, an der sich die aktuelle Auswahl befindet; es werden das Standardzeichenformat und das Standardabsatzformat verwendet. Der Text wird nicht als HTML behandelt.
Mit der replaceSelectedText()-Methode können Sie Text einfügen und löschen, ohne die Zeichen- und Absatzformatierung des übrigen Textes zu beeinflussen.
Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.
Parameter
value:String — Der String, mit dem der aktuell ausgewählte Text ersetzt wird.
|
replaceText | () | Methode |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ersetzt den Zeichenbereich, der durch die Parameter beginIndex und endIndex angegeben wird, durch den Inhalt des Parameters newText. Wie geplant wird der Text ab beginIndex bis endIndex-1 ersetzt.
Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.
Parameter
beginIndex:int — Der auf Null basierende Indexwert für die Startposition des Ersetzungsbereichs.
| |
endIndex:int — Die auf null basierende Indexposition des ersten Zeichens nach dem gewünschten Textabschnitt.
| |
newText:String — Der Text, durch den der angegebene Zeichenbereich ersetzt werden soll.
|
setColor | () | Methode |
setFocus | () | Methode |
public function setFocus():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt den Fokus auf diese Komponente. Die Komponente kann den Fokus wiederum an eine Unterkomponente übergeben.
Hinweis: Wenn der Fokus mit dieser Methode festgelegt wird, werden nur TextInput- und TextArea-Steuerelemente hervorgehoben. Alle Steuerelemente werden hervorgehoben, wenn der Benutzer durch Drücken der Tabulatortaste zu einem Steuerelement wechselt.
setSelection | () | Methode |
public function setSelection(beginIndex:int, endIndex:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter beginIndex und endIndex) angegebenen Text als ausgewählt fest. Wenn die beiden Parameterwerte gleich sind, setzt diese Methode den Einfügepunkt (so als ob Sie die caretIndex-Eigenschaft setzen).
Parameter
beginIndex:int — Der auf null basierende Indexwert für das erste Zeichen der Auswahl (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
| |
endIndex:int — Der auf null basierende Indexwert des letzten Zeichens in der Auswahl.
|
setTextFormat | () | Methode |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter format angegebene Textformatierung zu. Der Wert des Parameters format muss ein TextFormat-Objekt mit den gewünschten Änderungen bei der Textformatierung sein. Nur die Eigenschaften von format, die nicht null lauten, werden dem Textfeld zugewiesen. Eigenschaften von format, die auf null gesetzt wurden, werden nicht zugewiesen. Standardmäßig sind alle Eigenschaften eines neu erstellten TextFormat-Objekts auf null gesetzt.
Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.
Mit der Methode setTextFormat() wird das Textformat geändert, das auf einen Zeichenbereich oder den gesamten Text in einem Textfeld angewendet wird. Geben Sie keine Werte für beginIndex und endIndex an, wenn die Eigenschaften des Formats auf den kompletten Text im Textfeld angewendet werden sollen. Wenn Sie die Eigenschaften des Formats auf einen Textbereich anwenden möchten, geben Sie Werte für die Parameter beginIndex und endIndex an. Mit der Eigenschaft length können Sie die Indexwerte bestimmen.
Die beiden Arten von Formatierungsinformationen in einem TextFormat-Objekt sind Formatierungen auf Zeichen- und auf Absatzebene. Jedes Zeichen in einem Textfeld kann seine eigenen Zeichenformatierungseinstellungen (z. B. Schriftname, Schriftgrad, fett und kursiv) haben.
Bei Absätzen wird das erste Zeichen im Absatz auf die für den gesamten Absatz geltenden Absatzformatierungseinstellungen überprüft. Es gibt unter anderem folgende Absatzformatierungseinstellungen: linker Rand, rechter Rand und Einzug.
Jeder Text, der manuell vom Benutzer eingefügt oder durch die replaceSelectedText()-Methode ersetzt wird, erhält die Textfeld-Standardformatierung für neuen Text und nicht die Formatierung, die für den Texteinfügepunkt angegeben ist. Um die Standardformatierung für neuen Text festzulegen, verwenden Sie defaultTextFormat.
Parameter
format:flash.text:TextFormat — Ein TextFormat-Objekt, das sowohl Zeichen- als auch Absatzformatierungsinformationen enthält.
| |||||||||
beginIndex:int (default = -1) | |||||||||
endIndex:int (default = -1)beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 aktualisiert.
Beachten Sie, dass manuell vom Benutzer eingefügter oder mit der |
truncateToFit | () | Methode |
public function truncateToFit(truncationIndicator:String = null):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Kürzt den Text so, dass er horizontal in den für dieses Steuerelement definierten Bereich passt, und hängt an das Ende des gekürzten Texts drei Punkte (...) an.
Parameter
truncationIndicator:String (default = null)null übergeben wird, wird ein lokalisierbarer String wie "..." verwendet.
|
Boolean — true, wenn der Text gekürzt werden musste.
|
Tue Jun 12 2018, 10:04 AM Z