Paketflash.text
Klassepublic class TextField
VererbungTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die TextField-Klasse dient zum Erstellen von Anzeigeobjekten für die Texteingabe und -anzeige. Alle dynamischen Textfelder und Eingabetextfelder in einer SWF-Datei sind Instanzen der TextField-Klasse. Sie können einem Textfeld im Eigenschafteninspektor einen Instanznamen zuweisen und es mit den Methoden und Eigenschaften der TextField-Klasse per ActionScript bearbeiten. TextField-Instanznamen erscheinen im Film-Explorer und im Dialogfeld "Zielpfad einfügen" des Bedienfelds "Aktionen".

Verwenden Sie zur dynamischen Erstellung eines Textfelds den Konstruktor TextField().

Mit den Methoden der TextField-Klasse können Sie Text in dynamischen Textfeldern oder Eingabetextfeldern, die Sie beim Authoring oder zur Laufzeit erstellen, festlegen, auswählen und ändern.

ActionScript bietet mehrere Möglichkeiten, Text zur Laufzeit zu formatieren. Mit der TextFormat-Klasse können Sie die Zeichen- und Absatzformatierung für TextField-Objekte festlegen. Sie können mit der Eigenschaft TextField.styleSheet und der StyleSheet-Klasse Cascading Style Sheets (CSS)-Stile auf Textfelder anwenden. Über CSS können integrierte HTML-Tags geändert, neue Formatierungstags definiert oder Stile angewendet werden. Sie können HTML-Text, der optional CSS-Stile verwenden kann, direkt einem Textfeld zuweisen. HTML-Text, den Sie einem Textfeld zuweisen, kann eingebettete Medien (Movieclips, SWF-, GIF-, PNG- und JPEG-Dateien) enthalten. Der Text umgibt die eingebetteten Medien. Dies ist mit der Art vergleichbar, in der Text in einem Webbrowser die in einem HTML-Dokument eingebetteten Medien umgibt.

Flash Player unterstützt einige HTML-Tags zum Formatieren von Text. Eine Liste der unterstützten HTML-Tags finden Sie in der Beschreibung der Eigenschaft htmlText.

Beispiele anzeigen

Siehe auch

flash.text.TextFormat
flash.text.StyleSheet
Hauptanzeigeklassen
Grundlagen der Textverarbeitung


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaccessibilityProperties : AccessibilityProperties
Die aktuellen Eingabehilfenoptionen für dieses Anzeigeobjekt.
DisplayObject
 Inheritedalpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an.
DisplayObject
  alwaysShowSelection : Boolean
Wenn sich das Textfeld bei Einstellung "true" nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in grau.
TextField
  antiAliasType : String
Der für dieses Textfeld verwendete Anti-Aliasing-Typ.
TextField
  autoSize : String
Steuert die automatische Größenänderung und Ausrichtung von Textfeldern.
TextField
  background : Boolean
Gibt an, ob das Textfeld einen gefüllten Hintergrund aufweist.
TextField
  backgroundColor : uint
Gibt die Hintergrundfarbe des Textfelds an.
TextField
 InheritedblendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.
DisplayObject
  border : Boolean
Gibt an, ob das Textfeld umrahmt ist.
TextField
  borderColor : uint
Gibt die Farbe des Textfeldrahmens an.
TextField
  bottomScrollV : int
[read-only] Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt.
TextField
 InheritedcacheAsBitmap : Boolean
Wird diese Eigenschaft auf "true" gesetzt, speichert Flash Player eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.
DisplayObject
  caretIndex : int
[read-only] Der Index der Position der Einfügemarke.
TextField
  condenseWhite : Boolean
Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) in einem HTML-Textfeld entfernt werden sollen.
TextField
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcontextMenu : ContextMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an.
InteractiveObject
  defaultTextFormat : TextFormat
Gibt das Format für neu eingefügten Text an, z. B. mit der replaceSelectedText()-Methode eingefügten oder vom Benutzer eingegebenen Text.
TextField
  displayAsPassword : Boolean
Gibt an, ob es sich um ein Kennworttextfeld handelt.
TextField
 InheriteddoubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt.
InteractiveObject
  embedFonts : Boolean
Gibt an, ob bei der Wiedergabe eingebettete Schriftkonturen verwendet werden sollen.
TextField
 Inheritedfilters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.
DisplayObject
 InheritedfocusRect : Object
Gibt an, ob für dieses Objekt ein Fokus-Rechteck angezeigt wird.
InteractiveObject
  gridFitType : String
Die für dieses Textfeld verwendete Art der Rasteranpassung.
TextField
 Inheritedheight : Number
Gibt die Höhe des Anzeigeobjekts in Pixel an.
DisplayObject
  htmlText : String
Enthält die HTML-Darstellung des Inhalts des Textfelds.
TextField
  length : int
[read-only] Die Anzahl der Zeichen in einem Textfeld.
TextField
 InheritedloaderInfo : LoaderInfo
[read-only] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.
DisplayObject
 Inheritedmask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.
DisplayObject
  maxChars : int
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann.
TextField
  maxScrollH : int
[read-only] Der maximale Wert der Eigenschaft "scrollH".
TextField
  maxScrollV : int
[read-only] Der maximale Wert der Eigenschaft "scrollV".
TextField
 InheritedmouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus empfängt.
InteractiveObject
  mouseWheelEnabled : Boolean
Ein boolescher Wert, der angibt, ob bei mehrzeiligen Textfeldern automatisch ein Bildlauf durchgeführt werden soll, wenn der Benutzer in ein Textfeld klickt und das Mausrad dreht.
TextField
 InheritedmouseX : Number
[read-only] Gibt die x-Koordinate der Mausposition in Pixel an.
DisplayObject
 InheritedmouseY : Number
[read-only] Gibt die y-Koordinate der Mausposition in Pixel an.
DisplayObject
  multiline : Boolean
Gibt an, ob es sich um ein mehrzeiliges Textfeld handelt.
TextField
 Inheritedname : String
Gibt den Instanznamen des Anzeigeobjekts an.
DisplayObject
  numLines : int
[read-only] Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an.
TextField
 InheritedopaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.
DisplayObject
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  restrict : String
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann.
TextField
 Inheritedroot : DisplayObject
[read-only] 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.
DisplayObject
 Inheritedrotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.
DisplayObject
 Inheritedscale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster.
DisplayObject
 InheritedscaleX : Number
Gibt die horizontale Skalierung (percentage) des Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
 InheritedscaleY : Number
Gibt die vertikale Skalierung (percentage) eines Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
  scrollH : int
Die aktuelle horizontale Bildlaufposition.
TextField
 InheritedscrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt.
DisplayObject
  scrollV : int
Die vertikale Textposition in einem Textfeld.
TextField
  selectable : Boolean
Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann.
TextField
  selectionBeginIndex : int
[read-only] Der auf null basierende Indexwert des ersten Zeichens in der aktuellen Auswahl.
TextField
  selectionEndIndex : int
[read-only] Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl.
TextField
  sharpness : Number
Die Schärfe der Glyphenkanten in diesem Textfeld.
TextField
 Inheritedstage : Stage
[read-only] Die Bühne des Anzeigeobjekts.
DisplayObject
  styleSheet : StyleSheet
Fügt ein Stylesheet an das Textfeld an.
TextField
 InheritedtabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet.
InteractiveObject
 InheritedtabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an.
InteractiveObject
  text : String
Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt.
TextField
  textColor : uint
Die Farbe des Textes in einem Textfeld (im Hexadezimalformat).
TextField
  textHeight : Number
[read-only] Die Höhe des Texts in Pixel.
TextField
  textWidth : Number
[read-only] Die Breite des Texts in Pixel.
TextField
  thickness : Number
Die Stärke der Glyphenkanten in diesem Textfeld.
TextField
 Inheritedtransform : Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.
DisplayObject
  type : String
Der Typ des Textfelds.
TextField
  useRichTextClipboard : Boolean
Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird.
TextField
 Inheritedvisible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht.
DisplayObject
 Inheritedwidth : Number
Gibt die Breite des Anzeigeobjekts in Pixel an.
DisplayObject
  wordWrap : Boolean
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird.
TextField
 Inheritedx : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
 Inheritedy : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine neue TextField-Instanz.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
Hängt den vom Parameter "newText" angegebenen String an das Ende des Texts im Textfeld an.
TextField
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.
DisplayObject
  
Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt.
TextField
  
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.
TextField
  
Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück.
TextField
  
Gibt bei einem Bild bzw. einer SWF-Datei, das/die einem HTML-formatierten Textfeld mit dem Tag <img> hinzugefügt wurde, einen DisplayObject-Verweis für die angegebene ID zurück.
TextField
  
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.
TextField
  
Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom Parameter "charIndex" angegebene Zeichen enthält.
TextField
  
getLineLength(lineIndex:int):int
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.
TextField
  
Gibt metrische Informationen zu einer bestimmten Textzeile zurück.
TextField
  
getLineOffset(lineIndex:int):int
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter "lineIndex" angegebenen Zeile zurück.
TextField
  
getLineText(lineIndex:int):String
Gibt den Text der durch den Parameter "lineIndex" angegebenen Zeile zurück.
TextField
  
Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
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.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):TextFormat
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter "beginIndex" und "endIndex" angegebenen Textbereich zurück.
TextField
 Inherited
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.
DisplayObject
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wertet das Anzeigeobjekt aus, um festzustellen, ob es das Anzeigeobjekt "obj" überdeckt oder schneidet.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter "x" und "y" festgelegten Punkt überdeckt oder schneidet.
DisplayObject
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.
DisplayObject
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters "value".
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Ersetzt den Zeichenbereich, der durch die Parameter "beginIndex" und "endIndex" angegeben wird, durch den Inhalt des Parameters "newText".
TextField
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter "beginIndex" und "endIndex") angegebenen Text als ausgewählt fest.
TextField
  
setTextFormat(format:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter "format" angegebene Textformatierung zu.
TextField
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.DisplayObject
 Inherited Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
   Wird ausgelöst, nachdem der Wert eines Steuerelements geändert wurde.TextField
 Inherited Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt.InteractiveObject
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts "true" lautet.InteractiveObject
 Inherited Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.DisplayObject
 Inherited Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat.InteractiveObject
 Inherited Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer eine Taste drückt.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer eine Taste loslässt.InteractiveObject
   Wird ausgelöst, wenn ein Benutzer auf einen Hyperlink in einem HTML-fähigen Textfeld klickt und die URL-Adresse mit "event:" beginnt.TextField
 Inherited Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz gedrückt wird.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 Inherited Wird ausgelöst, wenn das Zeigegerät im Flash Player-Fenster über eine InteractiveObject-Instanz bewegt wird.InteractiveObject
 Inherited Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz losgelassen wird.InteractiveObject
 Inherited Wird ausgelöst, wenn ein Mausrad im Flash Player-Fenster über einer InteractiveObject-Instanz betätigt wird.InteractiveObject
 Inherited Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.DisplayObject
 Inherited Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
 Inherited Wird ausgelöst, wenn die Anzeigeliste aktualisiert und neu gezeichnet werden soll.DisplayObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.InteractiveObject
   Von einem TextField-Objekt ausgelöst, nachdem der Benutzer einen Bildlauf durchgeführt hat.TextField
 Inherited Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert.InteractiveObject
 Inherited Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert.InteractiveObject
 Inherited Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert.InteractiveObject
   Flash Player löst das textInput-Ereignis aus, wenn ein Benutzer ein oder mehr Textzeichen eingibt.TextField
Eigenschaftsdetail
alwaysShowSelectionEigenschaft
alwaysShowSelection:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet false.


Implementierung
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

Siehe auch


Beispiel

Kompilieren Sie die folgende Datei, und führen Sie sie aus. Wenn Sie die Datei ausführen, ziehen Sie den Text in beide Textfelder, um ihn auszuwählen. Achten Sie auf den Unterschied bei der Markierung der Auswahl, wenn Sie Text in den beiden Textfeldern auswählen (und damit den Fokus ändern):

    package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_alwaysShowSelection extends Sprite {
        public function TextField_alwaysShowSelection() {
            var label1:TextField = createTextField(0, 20, 200, 20);
            label1.text = "This text is selected.";
            label1.setSelection(0, 9);
            label1.alwaysShowSelection = true;

            var label2:TextField = createTextField(0, 50, 200, 20);
            label2.text = "Drag to select some of this text.";
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x; result.y = y;
            result.width = width; result.height = height;
            addChild(result);
            return result;
        }
    }
}
antiAliasTypeEigenschaft 
antiAliasType:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 lautet flash.text.AntiAliasType.NORMAL.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden String-Werte:

StringwertBeschreibung
flash.text.AntiAliasType.NORMALWendet das normale Text-Anti-Aliasing an. Dies entspricht dem Anti-Aliasing aus Flash Player 7 und früheren Versionen.
flash.text.AntiAliasType.ADVANCEDWendet erweitertes Anti-Aliasing an, so dass 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. Sein Einsatz bietet sich vor allem bei Anwendungen mit sehr viel kleinem Text an. 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):void

Siehe auch

autoSizeEigenschaft 
autoSize:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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):void

Auslöser
ArgumentError — Der angegebene autoSize-Wert gehört nicht zu "flash.text.TextFieldAutoSize".

Siehe auch

backgroundEigenschaft 
background:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet false.


Implementierung
    public function get background():Boolean
    public function set background(value:Boolean):void

Siehe auch

backgroundColorEigenschaft 
backgroundColor:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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


Implementierung
    public function get backgroundColor():uint
    public function set backgroundColor(value:uint):void

Siehe auch

borderEigenschaft 
border:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet false.


Implementierung
    public function get border():Boolean
    public function set border(value:Boolean):void

Siehe auch

borderColorEigenschaft 
borderColor:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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


Implementierung
    public function get borderColor():uint
    public function set borderColor(value:uint):void

Siehe auch

bottomScrollVEigenschaft 
bottomScrollV:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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():int

Siehe auch

caretIndexEigenschaft 
caretIndex:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 (in der Regel 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():int

Siehe auch


Beispiel

In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die Methode printCursorPosition aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft caretIndex.


package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
condenseWhiteEigenschaft 
condenseWhite:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) in einem HTML-Textfeld entfernt werden sollen. Der Standardwert lautet 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 Sie condenseWhite auf true setzen, müssen Sie HTML-Standardbefehle wie <BR> und <P> verwenden, um im 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):void

Siehe auch


Beispiel

Aus dem folgenden Beispiel geht der Unterschied zwischen der Einstellung false und true für condenseWhite hervor:

package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_condenseWhite extends Sprite {
        public function TextField_condenseWhite() {
            var tf1:TextField = createTextField(0, 0, 200, 50);
            tf1.condenseWhite = false;
            tf1.htmlText = "keep    on\n\ttruckin'";
            
            var tf2:TextField = createTextField(0, 120, 200, 50);
            tf2.condenseWhite = true;
            tf2.htmlText = "keep    on\n\ttruckin'";
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}
defaultTextFormatEigenschaft 
defaultTextFormat:TextFormat  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt das Format für neu eingefügten Text an, wie z. B. mit der Methode replaceSelectedText() eingefügten oder vom Benutzer eingegebenen Text.

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():TextFormat
    public function set defaultTextFormat(value:TextFormat):void

Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Siehe auch

displayAsPasswordEigenschaft 
displayAsPassword:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet false.


Implementierung
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void
embedFontsEigenschaft 
embedFonts:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet false.


Implementierung
    public function get embedFonts():Boolean
    public function set embedFonts(value:Boolean):void

Siehe auch

gridFitTypeEigenschaft 
gridFitType:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 String-Werte verwenden:

StringwertBeschreibung
flash.text.GridFitType.NONEDefiniert keine Rasteranpassung. Horizontale und vertikale Linien in den Glyphen werden nicht am Pixelraster ausgerichtet. Diese Einstellung eignet sich oft für Animationen oder für große Schriften.
flash.text.GridFitType.PIXELDefiniert 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.SUBPIXELBreite 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.

Der Standardwert lautet pixel.


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

Siehe auch

htmlTextEigenschaft 
htmlText:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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:
  • target: Gibt den Namen des Zielfensters an, in das die Seite geladen werden soll. Folgende Optionen stehen zur Verfügung: _self, _blank, _parent und _top. Mit der Option _self wird der aktuelle Frame im aktuellen Fenster angegeben, mit _blank ein neues Fenster, mit _parent der dem aktuellen Frame übergeordnete Frame und mit _top der Frame der obersten Stufe im aktuellen Fenster.
  • href: Legt eine URL oder ein ActionScript link-Ereignis fest. Die URL kann ein absoluter oder relativer Pfad zum Speicherort der SWF-Datei sein, von der die Seite geladen wird. Ein Beispiel für einen absoluten Verweis auf eine URL ist http://www.adobe.com, während /index.html ein relativer Verweis ist. Absolute URLs müssen das Präfix http:// enthalten, ansonsten werden sie von Flash wie relative URLs behandelt. Sie können mit dem Ereignis link festlegen, dass der Link eine ActionScript-Funktion in einer SWF-Datei ausführt, anstatt eine URL zu öffnen. Um ein link-Ereignis anzugeben, verwenden Sie das Ereignisschema anstelle des http-Schemas im href-Attribut. Ein Beispiel ist href="event:myText" anstelle von href="http://myURL"; wenn der Benutzer auf einen Hypertext-Link klickt, der das Ereignisschema enthält, löst das Textfeld ein link TextEvent aus, dessen text-Eigenschaft den Wert "myText" aufweist. Sie können dann eine ActionScript-Funktion erstellen, die ausgeführt wird, wann immer das link-TextEvent ausgelöst wird. Sie können auch mit Stylesheets die Stile a:link, a:hover und a:active für Anker-Tags definieren.
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. Dieses Tag können Sie nur einsetzen, wenn das Textfeld als mehrzeilig definiert ist.
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::
  • color: Es werden nur hexadezimale Farbwerte (#FFFFFF) unterstützt.
  • face: Gibt den Namen der zu verwendenden Schriftart an. Sie können wie im folgenden Beispiel dargestellt eine durch Kommata getrennte Liste von Schriftartnamen angeben. In diesem Fall wählt Flash Player die erste verfügbare Schriftart. Ist die angegebene Schriftart nicht auf dem Computer des Benutzers installiert oder in der SWF-Datei eingebettet, wird von Flash Player eine Ersatzschriftart gewählt.
  • size: Gibt die Größe der Schriftart an. Sie können absolute Pixelgrößen wie 16 oder 18 oder relative Punktgrößen wie +2 und -4 verwenden.
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. Um dieses Tag verwenden zu können, müssen Sie das Textfeld als mehrzeilig definieren und Zeilenumbrüche aktivieren.

Die folgenden Attribute werden vom <img>-Tag unterstützt:

  • src: Definiert die URL zu einer Bild- oder SWF-Datei bzw. den Verknüpfungsbezeichner eines Movieclip-Symbols in der Bibliothek. Dieses Attribut ist erforderlich. Alle anderen sind optional. Externe Dateien (JPEG, GIF, PNG und SWF) werden erst dann angezeigt, wenn sie komplett heruntergeladen worden sind.
  • width: Die Breite des einzufügenden Bilds, der SWF-Datei oder des Movieclips in Pixel.
  • height: Die Höhe des einzufügenden Bilds, der SWF-Datei oder des Movieclips in Pixel.
  • align: Legt die horizontale Ausrichtung des eingebetteten Bilds im Textfeld fest. Gültige Werte sind left und right. Der Standardwert ist left.
  • hspace: Legt die Größe des horizontalen Bereichs um das Bild fest, in dem kein Text zu sehen ist. Der Standardwert ist 8.
  • vspace: Legt die Größe des vertikalen Bereichs um das Bild fest, in dem kein Text zu sehen ist. Der Standardwert ist 8.
  • id: Definiert den Namen der Movieclip-Instanz (von Flash Player erstellt), die die eingebettete Bild- oder SWF-Datei bzw. den Movieclip enthält. Dies ist nützlich, wenn Sie den eingebetteten Inhalt mit ActionScript steuern möchten.
  • checkPolicyFile: Gibt an, dass Flash Player auf dem mit der Domäne des Bilds verknüpften Server nach einer domänenübergreifenden Richtliniendatei sucht. Wenn eine domänenübergreifende Richtliniendatei vorhanden ist, können SWF-Dateien aus den in der Datei aufgeführten Domäne auf die Daten des geladenen Bilds zugreifen, z. B., indem sie die Methode BitmapData.draw() mit diesem Bild als source-Parameter aufrufen. Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.

Medieninhalte, die in Textfelder eingebettet sind, werden in voller Größe angezeigt. Zum Festlegen der Abmessungen von einzubettenden Medien verwenden Sie die Attribute des <img>-Tags height und width.

Im Allgemeinen wird ein in ein Textfeld eingebettetes Bild in der Zeile nach dem Tag <img> angezeigt. Ist jedoch das <img>-Tag das erste Zeichen im Textfeld, erscheint das Bild dort in der ersten Zeile.

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: Da Flash Player die Tags von sortierten und nicht sortierten Listen (<ol> und <ul>) nicht erkennt, ändert sich die Darstellung der Liste nicht. Alle Listen werden unsortiert und mit Aufzählungszeichen vor jedem einzelnen Element angezeigt.
Absatz-Tag Mit dem Tag <p> wird ein neuer Absatz erstellt. Dieses Tag können Sie nur einsetzen, wenn das Textfeld als mehrzeilig definiert ist. Die folgenden Attribute werden vom <p>-Tag unterstützt:
  • align: Gibt die Ausrichtung des Texts innerhalb des Absatzes an. Gültige Werte sind left, right, justify und center.
  • class: Legt eine von einem flash.text.StyleSheet-Objekt definierte CSS-Stilklasse fest.
Bereichs-Tag Das Tag <span> ist nur im Einsatz mit CSS-Textstilen verfügbar. Das folgende Attribut wird dabei unterstützt:
  • class: Legt eine von einem flash.text.StyleSheet-Objekt definierte CSS-Stilklasse fest.
Textformat-Tag

Mit dem Tag <textformat> können Sie einige Eigenschaften der TextFormat-Klasse zur Absatzformatierung in Textfeldern nutzen. Dazu zählen Zeilenabstand, Einzug, Ränder und Tabstopps. Sie können das Tag <textformat> mit den integrierten HTML-Tags kombinieren.

Die folgenden Attribute werden vom Tag <textformat> unterstützt:

  • blockindent: Legt den Blockeinzug in Punkten fest; entspricht TextFormat.blockIndent.
  • indent: Legt den Einzug vom linken Rand bis zum ersten Zeichen im Absatz fest; entspricht TextFormat.indent. Es können positive und negative Werte verwendet werden.
  • leading: Legt den Zeilenabstand (vertikal) fest; entspricht TextFormat.leading. Es können positive und negative Werte verwendet werden.
  • leftmargin: Legt den linken Rand im Absatz in Punkten fest; entspricht TextFormat.leftMargin.
  • rightmargin: Legt den rechten Rand im Absatz in Punkten fest; entspricht TextFormat.rightMargin.
  • tabstops: Gibt benutzerdefinierte Tabstopps als Array aus nicht negativen Ganzzahlen an; entspricht TextFormat.tabStops.
Unterstreichungs-Tag Mit dem <u>-Tag markierter Text wird unterstrichen angezeigt.

Flash Player unterstützt die folgenden HTML-Entitäten:

Einheit Beschreibung
< < (kleiner als)
> > (größer als)
& & (Und-Zeichen)
" " (doppelte Anführungszeichen)
' ' (Apostroph, einfaches Anführungszeichen)

Flash unterstützt außerdem explizite Zeichencodes wie & (Und-Zeichen in ASCII) und € (€-Zeichen in Unicode).


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

Siehe auch


Beispiel

Im folgenden Beispiel wird ein TextField-Objekt mit der Bezeichnung tf1 erstellt, und der Eigenschaft text wird ein String im HTML-Format zugewiesen. Wenn die Eigenschaft htmlText nachverfolgt wird, wird der String im HTML-Format mit zusätzlichen Tags (z. B. <P> und <FONT>) automatisch von Flash Player hinzugefügt. Wenn der Wert der Eigenschaft text nachverfolgt wird, wird der unformatierte String ohne HTML-Tags angezeigt.

Zum Vergleich werden die gleichen Schritte mit einem weiteren TextField-Objekt mit der Bezeichnung tf2. Zusätzlich wird der Eigenschaft styleSheet von tf2 ein StyleSheet-Objekt zugewiesen, bevor die Eigenschaft htmlText festgelegt wird. In diesem Fall enthält die Eigenschaft htmlText, wenn sie nachverfolgt wird, nur den genauen HTML-Text, der ursprünglich der Eigenschaft htmlText zugewiesen war. Es wurden keine zusätzlichen Tags von Flash Player eingefügt.


package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;

    public class TextField_text extends Sprite {
        public function TextField_text() {
            var tf1:TextField = createTextField(10, 10, 400, 22);
            tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";

            // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P>
            trace("htmlText: " + tf1.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf1.text);
            
            var tf2:TextField = createTextField(10, 50, 400, 22);
            tf2.styleSheet = new StyleSheet();
            tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";
            // htmlText: <b>Lorem ipsum dolor sit amet.</b>
            trace("htmlText: " + tf2.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf2.text);
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
lengthEigenschaft 
length:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Anzahl der Zeichen in einem Textfeld. Ein Steuerzeichen wie Tab (\t) zählt als ein Zeichen.


Implementierung
    public function get length():int
maxCharsEigenschaft 
maxChars:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 lautet, können die Benutzer unbegrenzt viel Text eingeben.

Der Standardwert lautet 0.


Implementierung
    public function get maxChars():int
    public function set maxChars(value:int):void
maxScrollHEigenschaft 
maxScrollH:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der maximale Wert der Eigenschaft scrollH.


Implementierung
    public function get maxScrollH():int

Siehe auch

maxScrollVEigenschaft 
maxScrollV:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der maximale Wert der Eigenschaft scrollV.


Implementierung
    public function get maxScrollV():int

Siehe auch

mouseWheelEnabledEigenschaft 
mouseWheelEnabled:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein boolescher Wert, der angibt, ob bei mehrzeiligen Textfeldern automatisch ein Bildlauf durchgeführt werden soll, wenn der Benutzer in ein Textfeld klickt 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):void
multilineEigenschaft 
multiline:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob es sich um ein mehrzeiliges Textfeld handelt. Bei true ist das Textfeld mehrzeilig, bei false ist es einzeilig.

Der Standardwert lautet false.


Implementierung
    public function get multiline():Boolean
    public function set multiline(value:Boolean):void

Siehe auch

numLinesEigenschaft 
numLines:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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():int

Siehe auch

restrictEigenschaft 
restrict:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. Wenn die Eigenschaft restrict auf null gesetzt ist, kann jedes beliebige Zeichen eingegeben werden. Wenn die Eigenschaft restrict einen leeren String enthält, kann kein 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. Mit dieser Eigenschaft werden nur Benutzereingaben eingeschränkt. Mit einem Skript kann jeder beliebige Text in das Textfeld gestellt werden. Diese Eigenschaft wird nicht an die Optionen unter "Schriftarten einbetten" im Eigenschafteninspektor angeglichen.

Wenn der String mit dem Zeichen "^" 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 "^" 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 (Backslash, "\") vorausstellen. 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 = "\\-\\^";
  

"^" kann an beliebiger Stelle im String verwendet werden, um zwischen dem Ein- und Ausschluss von Zeichen hin und her zu wechseln. Im folgenden Beispiel werden alle Großbuchstaben außer Q akzeptiert:

  my_txt.restrict = "A-Z^Q";
  

Sie können die Escape-Sequenz u zum Erstellen von restrict-Strings verwenden. Im folgenden Beispiel werden nur die Zeichen zwischen ASCII 32 (Leerzeichen) und ASCII 126 (Tilde) akzeptiert:

     my_txt.restrict = "\u0020-\u007E";
  

Der Standardwert lautet null.


Implementierung
    public function get restrict():String
    public function set restrict(value:String):void
scrollHEigenschaft 
scrollH:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 Pixel 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 Pixel gemessen, da die am häufigsten verwendeten Schriftarten in der Regel 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):void

Siehe auch

scrollVEigenschaft 
scrollV:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 Pixel 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):void

Siehe auch

selectableEigenschaft 
selectable:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet true.


Implementierung
    public function get selectable():Boolean
    public function set selectable(value:Boolean):void

Siehe auch

selectionBeginIndexEigenschaft 
selectionBeginIndex:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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():int

Siehe auch


Beispiel

In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die Methode printCursorPosition aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft caretIndex.


package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
selectionEndIndexEigenschaft 
selectionEndIndex:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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():int

Siehe auch


Beispiel

In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die Methode printCursorPosition aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft caretIndex.


package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
sharpnessEigenschaft 
sharpness:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Der Standardwert lautet 0.


Implementierung
    public function get sharpness():Number
    public function set sharpness(value:Number):void

Siehe auch

styleSheetEigenschaft 
styleSheet:StyleSheet  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Fügt ein Stylesheet an das Textfeld an. Informationen zum Erstellen von Stylesheets finden Sie im Eintrag zur StyleSheet-Klasse und im Handbuch Programmieren mit ActionScript 3.0.

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):void

Siehe auch

textEigenschaft 
text:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.


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

Siehe auch


Beispiel

Im folgenden Beispiel wird ein TextField-Objekt mit der Bezeichnung tf1 erstellt, und der Eigenschaft text wird ein String im HTML-Format zugewiesen. Wenn die Eigenschaft htmlText nachverfolgt wird, wird der String im HTML-Format mit zusätzlichen Tags (z. B. <P> und <FONT>) automatisch von Flash Player hinzugefügt. Wenn der Wert der Eigenschaft text nachverfolgt wird, wird der unformatierte String ohne HTML-Tags angezeigt.

Zum Vergleich werden die gleichen Schritte mit einem weiteren TextField-Objekt mit der Bezeichnung tf2. Zusätzlich wird der Eigenschaft styleSheet von tf2 ein StyleSheet-Objekt zugewiesen, bevor die Eigenschaft htmlText festgelegt wird. In diesem Fall enthält die Eigenschaft htmlText, wenn sie nachverfolgt wird, nur den genauen HTML-Text, der ursprünglich der Eigenschaft htmlText zugewiesen war. Es wurden keine zusätzlichen Tags von Flash Player eingefügt.


package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;

    public class TextField_text extends Sprite {
        public function TextField_text() {
            var tf1:TextField = createTextField(10, 10, 400, 22);
            tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";

            // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P>
            trace("htmlText: " + tf1.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf1.text);
            
            var tf2:TextField = createTextField(10, 50, 400, 22);
            tf2.styleSheet = new StyleSheet();
            tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";
            // htmlText: <b>Lorem ipsum dolor sit amet.</b>
            trace("htmlText: " + tf2.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf2.text);
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
textColorEigenschaft 
textColor:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 bzw. Zeichen. Hierbei handelt es sich um die Zeichen 0 bis 9 und A bis F. Schwarz hat beispielsweise den Code 0x000000 und Weiß 0xFFFFFF.

Der Standardwert lautet 0 (0x000000).


Implementierung
    public function get textColor():uint
    public function set textColor(value:uint):void

Beispiel

Mit dem folgenden ActionScript wird ein TextField-Objekt erstellt und die Eigenschaft textColor in Rot (0xFF0000) geändert.

package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textColor extends Sprite {
        public function TextField_textColor() {
            var tf:TextField = createTextField(10, 10, 100, 300);
            tf.text = "This will be red text";
            tf.textColor = 0xFF0000;            
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}
textHeightEigenschaft 
textHeight:Number  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Höhe des Texts in Pixel.


Implementierung
    public function get textHeight():Number

Siehe auch


Beispiel

Im folgenden Beispiel wird ein TextField-Objekt erstellt. Anschließend wird dem Objekt Text zugewiesen. Mit den trace-Anweisungen werden die Werte der Eigenschaften textWidth und textHeight aufgerufen. Zum Vergleich werden auch die Eigenschaften width und height angezeigt. (Beachten Sie, dass die Werte für textHeight und textWidth von der auf Ihrem Computer verwendeten Schriftart abhängen).

package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textHeight extends Sprite {
        public function TextField_textHeight() {
            var tf:TextField = createTextField(10, 10, 100, 150);
            tf.text = "Sample text";
            
            trace("textWidth: " + tf.textWidth); // textWidth: 55.75
            trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001
            trace("width: " + tf.width); // width: 100
            trace("height: " + tf.height); // height: 150
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            result.background = true;
            addChild(result);
            return result;
        }
    }
}
textWidthEigenschaft 
textWidth:Number  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Breite des Texts in Pixel.


Implementierung
    public function get textWidth():Number

Siehe auch


Beispiel

Im folgenden Beispiel wird ein TextField-Objekt erstellt. Anschließend wird dem Objekt Text zugewiesen. Mit den trace-Anweisungen werden die Werte der Eigenschaften textWidth und textHeight aufgerufen. Zum Vergleich werden auch die Eigenschaften width und height angezeigt. (Beachten Sie, dass die Werte für textHeight und textWidth von der auf Ihrem Computer verwendeten Schriftart abhängen).

package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textHeight extends Sprite {
        public function TextField_textHeight() {
            var tf:TextField = createTextField(10, 10, 100, 150);
            tf.text = "Sample text";
            
            trace("textWidth: " + tf.textWidth); // textWidth: 55.75
            trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001
            trace("width: " + tf.width); // width: 100
            trace("height: " + tf.height); // height: 150
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            result.background = true;
            addChild(result);
            return result;
        }
    }
}
thicknessEigenschaft 
thickness:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Der Standardwert lautet 0.


Implementierung
    public function get thickness():Number
    public function set thickness(value:Number):void

Siehe auch

typeEigenschaft 
type:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Der Standardwert lautet dynamic.


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

Auslöser
ArgumentError — Der angegebene type-Wert gehört nicht zu "flash.text.TextFieldType".

Siehe auch


Beispiel

Im folgenden Beispiel werden zwei Textfelder erstellt: tfDynamic und tfInput. In beide Felder wird Text eingegeben. Für tfDynamic wird die type-Eigenschaft jedoch auf TextFieldType.DYNAMIC gesetzt wohingegen die type-Eigenschaft von tfInput auf TextFieldType.INPUT gesetzt wird. Daher kann der Benutzer den Text bei tfInput bearbeiten, während er bei tfDynamic keine Änderungen am Text vornehmen kann.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_type extends Sprite {
        public function TextField_type() {
            var tfDynamic:TextField = createTextField(10, 10, 100, 20);
            tfDynamic.type = TextFieldType.DYNAMIC;
            tfDynamic.text = "hello";

            var tfInput:TextField = createTextField(10, 45, 100, 20);
            tfInput.type = TextFieldType.INPUT;
            tfInput.text = "world";
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.background = true;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}
useRichTextClipboardEigenschaft 
useRichTextClipboard:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird. Bei der Einstellung true kopiert Flash Player neben dem Text auch die Formatierung (z. B. Ausrichtung, Fett- und Kursivformatierung) zwischen den Textfeldern. Sowohl im Ausgangs- als auch im Zieltextfeld des Kopier- und Einfügevorgangs muss useRichTextClipboard auf true gesetzt sein. Der Standardwert lautet false.


Implementierung
    public function get useRichTextClipboard():Boolean
    public function set useRichTextClipboard(value:Boolean):void
wordWrapEigenschaft 
wordWrap:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 lautet, findet im Textfeld kein Zeilenumbruch statt. Der Standardwert lautet false.


Implementierung
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

Beispiel

Aus dem folgenden Beispiel geht der Unterschied zwischen der Einstellung true und false für wordWrap hervor: Es werden zwei TextField-Instanzen erstellt, deren Inhalt zu groß für die Breite der Textfelder ist. Die Eigenschaft wordWrap der ersten Instanz (tfWrap) wird auf true gesetzt, die der zweiten Instanz (tfNoWrap) auf false.

package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_wordWrap extends Sprite {
        public function TextField_wordWrap() {
            var tfWrap:TextField = createTextField(10, 10, 100, 100);
            tfWrap.wordWrap = true;
            tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field";

            var tfNoWrap:TextField = createTextField(10, 150, 100, 100);
            tfNoWrap.wordWrap = false;
            tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field";
        }

        private function createTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.background = true;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}
Konstruktordetail
TextField()Konstruktor
public function TextField()

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt eine neue TextField-Instanz. Rufen Sie nach der Erstellung der TextField-Instanz die Methode addChild() bzw. addChildAt() des übergeordneten DisplayObjectContainer-Objekts auf, um die TextField-Instanz der Anzeigeliste hinzuzufügen.

Die Standardgröße für ein Textfeld beträgt 100 x 100 Pixel.

Methodendetail
appendText()Methode
public function appendText(newText:String):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.


Beispiel

Im folgenden Beispiel wird die Uhrzeit angezeigt, falls nicht gerade Wochenende ist. Am Wochenende wird dagegen der Text "It's the weekend" angezeigt. Außerdem werden bis zu einer bestimmten Position die Anzahl der Zeichen und die Anzahl der Zeilen im Textfeld gezählt.

Das Textfeld outputText wird so eingestellt, dass es sich automatisch an den Text anpasst und dass der Text links ausgerichtet ist. Dazu wird die Eigenschaft autoSize verwendet. Die outputText.text-Eigenschaft schreibt die erste Zeile des Inhalts, und die Methode appendText() hängt den Rest des Inhalts an. (Es ist nicht erforderlich, mit der text-Eigenschaft zu beginnen. Die appendText()-Methode könnte auch verwendet werden, um Text von außerhalb des Rahmens anzuhängen.) Wenn die text-Eigenschaft ein zweites Mals gesetzt wird, wird der ursprüngliche Text überschrieben. Verwenden Sie den +=-Operator, um Inhalt mit der text-Eigenschaft anzuhängen.

Die if-Anweisung überprüft, ob es sich beim Datum um Samstag (6) oder Sonntag (0) handelt. Ist dies nicht der Fall, gibt die toLocaleTimeString()-Methode die Ortszeit zurück, die an den Inhalt des Textfelds angehängt wird.

Die length-Eigenschaft des Textfelds wird verwendet, um die Anzahl der Zeichen bis direkt vor dem Aufrufen der Funktion zu lesen, und die pnumLines-Eigenschaft zählt die Zeilen im Textfeld. Beachten Sie, dass die leeren Zeilen sowie die Leerräume und Zeilenumbrüche (\n) mitgezählt werden, um die Länge des Inhalts zu bestimmen.

  package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
 
    public class TextField_appendTextExample extends Sprite {
         
        public function TextField_appendTextExample() {
            var outputText:TextField = new TextField();
            var today:Date = new Date();
                
            outputText.x = 10;
            outputText.y = 10;
            outputText.background = true;
            outputText.autoSize = TextFieldAutoSize.LEFT;
 
            outputText.text = "WHAT TIME IS IT?" + "\n\n";
 
            if((today.day == 0) || (today.day == 6)) {
                outputText.appendText("It's the weekend.");
                outputText.appendText("\n\n");
           
            } else {
                outputText.appendText("The time is: ");
                outputText.appendText(today.toLocaleTimeString() + ".\n\n");  
            }

            outputText.appendText("Number of characters including line breaks and spaces so far: ");
            outputText.appendText(outputText.length.toString() + "\n");
            outputText.appendText("Number of lines in the outputText: ");
            outputText.appendText(outputText.numLines.toString());   

            this.addChild(outputText);
        }
    }
}
getCharBoundaries()Methode 
public function getCharBoundaries(charIndex:int):Rectangle

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
Rectangle — Ein Rechteck mit Mindest- und Höchstwerten für x und y, mit dem die Begrenzungsbox für das Zeichen definiert wird.

Siehe auch


Beispiel

Im folgenden Beispiel wird ein vom Benutzer ausgewähltes Zeichen mithilfe der getCharBoundaries()-Methode markiert (hervorgehoben).

Die Klasse definiert das Shape-Objekt spotlight, das ein Rechteck um jedes ausgewählte Zeichen zeichnet. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode ruft die getCharIndexAtPoint()-Methode den Index des ausgewählten Zeichens basierend auf den localX- und localY-Koordinaten des Mausklicks ab, der relativ zum Sprite-Objekt, in dem er sich befindet, ist. Die getCharIndexAtPoint()-Methode gibt -1 zurück, wenn der Punkt (der Mausklick) sich auf keinem Zeichen befindet. Da das Textfeld größer sein kann als der Text, wird die zurückgegebene Ganzzahl (index) überprüft, um sicherzustellen, dass der Benutzer auf ein Zeichen geklickt hat. Die Ganzzahl index wird auch von getCharBoundaries() verwendet, um ein Rectangle-Objekt abzurufen, das die Grenzen des Zeichens enthält. Die clear()-Methode löscht alle zuvor angezeigten spotlight-Shape-Objekte. An der Position des Zeichens (ausgehend von den Koordinaten (10, 10)) wird mithilfe der zurückgegebenen x- und y-Koordinaten des frame-Rechtecks ein neues Rechteck in der Größe der Breite- und Höhe-Werte des Zeichens gezeichnet. Um das Zeichen hervorzuheben, wird das Shape-Objekt spotlight mit Gelb gefüllt und die Deckkraft wird auf 35 Prozent gesetzt, sodass das Zeichen zu erkennen ist. Beachten Sie, dass Leerzeichen auch als Zeichen behandelt werden.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.geom.Rectangle;
    import flash.events.MouseEvent;
    import flash.text.TextFieldAutoSize;
    import flash.display.Shape;

    public class TextField_getCharBoundariesExample extends Sprite
    {
        private var myTextField:TextField = new TextField();    
        private var spotlight:Shape = new Shape();
        
        public function TextField_getCharBoundariesExample() {
            
            myTextField.x = 10;
            myTextField.y = 10; 
            myTextField.border = true;
            myTextField.selectable = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            myTextField.text = "Selected a character from this text by clicking on it."

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            this.addChild(myTextField);    
            this.addChild(spotlight);
         }

        private function clickHandler (e:MouseEvent):void {
            var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
 
            if (index != -1) {
                 var frame:Rectangle = myTextField.getCharBoundaries(index);

                spotlight.graphics.clear();    
                spotlight.graphics.beginFill(0xFFFF00, .35);
                spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height);            
                spotlight.graphics.endFill();
            }
        } 
    }
}
getCharIndexAtPoint()Methode 
public function getCharIndexAtPoint(x:Number, y:Number):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Rückgabewerte
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.

Beispiel

Im folgenden Beispiel wird das Zeichen in ein anderes Textfeld über dem Text kopiert, wenn der Benutzer auf ein Zeichen klickt.

Das erste Textfeld enthält dann den Text, den der Benutzer auswählt. Um sicherzustellen, dass nur auf den Text geklickt, dieser aber nicht ausgewählt wird, wird die selectable-Eigenschaft auf "false" gesetzt. Wenn der Benutzer auf das Textfeld firstTextField klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Da das Textfeld größer sein kann als der Text, wird die zurückgegebene Ganzzahl (index) überprüft, um sicherzustellen, dass der Benutzer auf ein Zeichen geklickt hat. Die getCharIndexAtPoint()-Methode gibt -1 zurück, wenn der Punkt (der Mausklick) sich nicht auf einem Zeichen befindet. Anhand der Mauskoordinaten werden die Koordinaten des neuen Textfelds, in dem die kopierten Zeichen angezeigt werden, festgelegt. Die Farbe der Zeichen im zweiten Textfeld wird auf "rot" gesetzt. Zum Schluss wird der Text des zweiten Feldes auf das ausgewählte Zeichen festgelegt, das mit der charAt()-Methode abgerufen wird. Beachten Sie, dass bei Verwendung der text-Eigenschaft anstelle der appendText()-Methode das Zeichen im zweiten Feld überschrieben wird, anstatt das Zeichen anzuhängen.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.geom.Rectangle;
    import flash.events.MouseEvent;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_getCharIndexAtPointExample extends Sprite {
        private var firstTextField:TextField = new TextField();    
        private var secondTextField:TextField = new TextField();
        
        public function TextField_getCharIndexAtPointExample() {

            firstTextField.x = 100;
            firstTextField.y = 100; 
            firstTextField.width = 260;
            firstTextField.height = 20;
            firstTextField.border = true;
            firstTextField.background = true;
            firstTextField.selectable = false;
            
            firstTextField.text = "Selected a character from this text by clicking on it."

            firstTextField.addEventListener(MouseEvent.CLICK, clickHandler);

            this.addChild(firstTextField);    
            this.addChild(secondTextField);
         }

        private function clickHandler (e:MouseEvent):void {
            var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY);

            if (index != -1) {
                secondTextField.x = mouseX;
                secondTextField.y =  70;
                secondTextField.border = true;
                secondTextField.selectable = false;
                secondTextField.background = true;
                secondTextField.textColor = 0xFF0000;
                secondTextField.autoSize = TextFieldAutoSize.LEFT;
                secondTextField.text = firstTextField.text.charAt(index);    
            }
        } 
    }
}
getFirstCharInParagraph()Methode 
public function getFirstCharInParagraph(charIndex:int):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
int — Der auf null basierende Indexwert des ersten Zeichens im gleichen Absatz.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im Bereich.

Beispiel

Im folgenden Beispiel wird eine Absatzformatierung auf den Inhalt des Textfelds angewendet. Wenn der Benutzer auf einen Absatz klickt, wird der Text des Absatzes rechts ausgerichtet; klickt der Benutzer erneut auf den Absatz, wird das ursprüngliche (Standard-)Format, Ausrichtung links, angewendet.

Im Konstruktor wird das Textfeld myTextField für den Zeilenumbruch eingerichtet. Die getTextFormat-Methode gibt das ursprüngliche Format des ersten Zeichens des Textfeldinhalts zurück, das in das TextFormat-Objekt originalFormat platziert wird. Ein neues TextFormat-Objekt (newFormat) wird definiert, dessen align-Eigenschaft auf die Ausrichtung rechts gesetzt wird. Wenn der Benutzer auf das Textfeld klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Die erste if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Unter Verwendung der clickIndex-Ganzzahl, die von der getCharIndexAtPoint()-Methode zurückgegeben wird, gibt die getFirstCharInParagraph()-Methode den Index des ersten Zeichens in dem Absatz, auf den der Benutzer geklickt hat, zurück. Der Index des letzten Zeichens im Absatz wird bestimmt, indem die Länge des Absatzes (mithilfe der getParagraphLength()-Methode) zum Index des ersten Zeichens im Absatz hinzugefügt wird, abzüglich des letzten Zeichens (\n). Die zweite if-Anweisung überprüft das Format des ersten Zeichens im Absatz. Wenn dessen Ausrichtung mit der des ursprünglichen Formats (Linksausrichtung) übereinstimmt, wird das neue Format auf alle Zeichen im Absatz angewendet. Andernfalls wird das Format des Absatzes auf das ursprüngliche Format zurückgesetzt. Die Ausrichtung ist genau wie Einzug, Aufzählungszeichen, Tabulator, linker und rechter Rand eine Formatierung, die für Absätze gilt. Beachten Sie, dass bei Verwendung eines Zeilenumbruchs die Formatierung nur auf die erste Zeile des Absatzes angewendet wird, wenn das Argument endIndex für die setTextFormat()-Methode nicht definiert ist.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;
    import flash.text.TextFormat;
    import flash.text.TextFormatAlign;

    public class TextField_getFirstCharInParagraphExample extends Sprite
    {
        private var myTextField:TextField = new TextField();
        private var originalFormat:TextFormat = new TextFormat();
        private var newFormat:TextFormat = new TextFormat(); 
        
        public function TextField_getFirstCharInParagraphExample() {
            myTextField.x = 10;
            myTextField.y = 10; 
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.width = 300;
            myTextField.height = 300; 
            myTextField.background = true;
             
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file " 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                        + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                        + "Target Path dialog box in the Actions panel.\n\n"  
                        + "To create a text field dynamically, use the TextField constructor.\n\n"
                        + "The methods of the TextField class let you set, select, and manipulate "  
                        + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n");

            originalFormat = myTextField.getTextFormat(0);

            newFormat.align = TextFormatAlign.RIGHT;

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
  
            this.addChild(myTextField);
        }

        private function clickHandler(e:MouseEvent):void {
            var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
                  
            if(clickIndex != -1) {
                var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex);
                var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1));
            
                if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) {
                     myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex);
                }else {
                     myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex);
                }
            } 
        }
    }
}
 
getImageReference()Methode 
public function getImageReference(id:String):DisplayObject

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
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. Bei in die SWF-Datei eingebetteten Medien ist dies das geladene Objekt. Falls es kein <img>-Tag mit passender id gibt, wird mit der Methode null zurückgegeben.

Siehe auch


Beispiel

Im folgenden Beispiel wird das Bild im Feld beim Klicken auf das Textfeld auf eine Deckkraft von 25 Prozent gesetzt und um 90 Grad gedreht. Mit jedem folgenden Mausklick wird das Bild erneut um 90 Grad gedreht.

Das Bild (image.jpg) wird über HTML eingeschlossen. (Hier wird davon ausgegangen, dass sich die Bilddatei im selben Verzeichnis wie die SWF-Datei befindet). Ein id-Attribut muss für das img-Tag definiert werden, damit mit der getImageReference()-Methode auf das Bild zugegriffen werden kann. Die htmlText-Eigenschaft wird verwendet, um HTML-formatierte Stringinhalte einzuschließen. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode gibt die getImageReference()-Methode einen Verweis auf das Bild als DisplayObject zurück. Mit diesem Verweis kann das Bild wie jedes DisplayObject-Objekt bearbeitet werden. Hier werden die Eigenschaften alpha (Transparenz) und rotation festgelegt. Die transform-Eigenschaft kann verwendet werden, um auf die Matrix, die Farbtransformation und die Pixelbegrenzungen des Anzeigeobjekts zuzugreifen. Beachten Sie auch, dass flash.display.DisplayObject importiert werden muss.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.Event;
    import flash.events.MouseEvent;
    import flash.display.DisplayObject;
    
    import flash.text.TextFieldAutoSize;
    
    public class TextField_getImageReferenceExample extends Sprite
    {
        private var myTextField:TextField = new TextField();
        
        public function TextField_getImageReferenceExample()
        {
            var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>";

            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 250;
            myTextField.height = 250;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.border = true;
            myTextField.multiline = true;

            myTextField.htmlText = myText1;
            
            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            this.addChild(myTextField);
        }
 
        private function clickHandler(e:MouseEvent):void {
            var imageRef:DisplayObject = myTextField.getImageReference("testimage");
 
            imageRef.rotation += 90;
            imageRef.x = 125;
            imageRef.y = 125;
            imageRef.alpha = 0.25;      
        }
    }
}
getLineIndexAtPoint()Methode 
public function getLineIndexAtPoint(x:Number, y:Number):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Rückgabewerte
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.

Beispiel

Im folgenden Beispiel wird eine Zeile aus einem Shakespeare-Sonett in eines neues Textfeld kopiert, wenn der Benutzer auf die Zeile klickt.

Im Konstruktor wird das Textfeld poem so festgelegt, dass kein Zeilenumbruch verwendet wird (da es sich um ein Gedicht handelt). Die autoSize-Eigenschaft wird verwendet, um den Text automatisch anzupassen und ggf. seine Größe als links ausgerichteter Text zu ändern. Das Textfeld poemCopy wird unter dem Textfeld poem platziert. Wenn der Benutzer auf eine Zeile des Gedichts klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getLineIndexAtPoint()-Methode den Zeilenindex der Zeile zurück, auf die der Benutzer geklickt hat, basierend auf den localX- und localY-Koordinaten des Mausklicks. (Da das Originalgedicht in das Textfeld passt, ist es hier nicht erforderlich, zu überprüfen, ob der Text außerhalb des Bereichs liegt (RangeError, von der getCharIndexAtPoint()-Methode ausgegeben.) Der Zeilenindex wird verwendet, um den Inhalt der Zeile mit der getLineText()-Methode als String abzurufen, der dann an den Inhalt des Textfelds poemCopy angehängt wird. Das Kopieren kann kontinuierlich fortgeführt werden, ab einem bestimmten Punkt befindet sich der Text jedoch außerhalb des sichtbaren Bereichs des Textfelds poemCopy.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;
    import flash.text.TextFormat;
    import flash.text.TextFieldAutoSize;

    public class TextField_getLineIndexAtPointExample extends Sprite {
        private var poem:TextField = new TextField();
        private var poemCopy:TextField = new TextField();
        
        public function TextField_getLineIndexAtPointExample() {
            poem.border = true;
            poem.autoSize = TextFieldAutoSize.LEFT;
            poem.x = 10;
            poem.wordWrap = false;

            poemCopy.height = 250;
            poemCopy.width = 270;
            poemCopy.y = 230;
            poemCopy.x = 10;
            poemCopy.background = true;
            poemCopy.border = true;
            poemCopy.wordWrap = false;
            
            poem.appendText("Let me not to the marriage of true minds\n"
                              + "Admit impediments. love is not love\n"
                              + "Which alters when it alteration finds\n"
                              + "Or bends with the remover to remove:\n"
                              + "O no! it is an ever-fixed mark\n" 
                              + "That looks on tempests and is never shaken;\n"
                              + "It is the star to every wandering bark,\n"
                              + "Whose worth's unknown, although his height be taken.\n"
                              + "Love's not Time's fool, though rosy lips and cheeks\n"
                              + "Within his bending sickle's compass come:\n"
                              + "Love alters not with his brief hours and weeks,\n"
                              + "But bears it out even to the edge of doom.\n"
                              + "If this be error and upon me proved,\n"
                              + "I never writ, nor no man ever loved.");

           poem.addEventListener(MouseEvent.CLICK, clickHandler); 

           this.addChild(poem); 
           this.addChild(poemCopy);
        }
    
        private function clickHandler(e:MouseEvent):void {
                var index:int = poem.getLineIndexAtPoint(e.localX, e.localY);
                var s:String;

                s = poem.getLineText(index);
                poemCopy.appendText(s + "\n");
        }
    }
}
getLineIndexOfChar()Methode 
public function getLineIndexOfChar(charIndex:int):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom Parameter charIndex 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.).

Rückgabewerte
int — Der auf null basierende Indexwert der Zeile.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im Bereich.

Beispiel

Im folgenden Beispiel gibt die getLineIndexOfChar()-Methode die Zeilennummern für das 100. und 500. Zeichen im Textfeld zurück.

Das Textfeld myTextField wurde mit Zeilenumbruch und als links ausgerichteter Text definiert. Die getLineIndexOfChar()-Methode gibt den Zeilenindex für die angegebenen Zeichenindizes (100 und 500) zurück. Diese Informationen werden dann an den Absatz angehängt. Beachten Sie, dass der Zeilenindex (index) um 1 erhöht wird, um die Zeilennummer zu erhalten, da der Zeilenindex mit 0 beginnt. Wenn die Anzeigegröße geändert wird, kann sich die Zeilennummer zwar ändern, die Informationen hier bleiben jedoch unverändert, da die Methode nur ein Mal aufgerufen wird.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class TextField_getLineIndexOfCharExample extends Sprite 
    {
        public function TextField_getLineIndexOfCharExample()
        {
            var myTextField:TextField = new TextField();
            
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 200;
            myTextField.background = true;  
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.autoSize = TextFieldAutoSize.LEFT;

            myTextField.appendText("The TextField class is used to create display objects for "
                + "text display and input. All dynamic and input text fields in a SWF file" 
                + "are instances of the TextField class. You can use the TextField class "
                + "to perform low-level text rendering. However, in Flex, you typically use "
                + "the Label, Text, TextArea, and TextInput controls to process text. "  
                + "You can give a text field an instance name in the Property inspector "
                + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                + "Target Path dialog box in the Actions panel.\n\n");

            var index:int = myTextField.getLineIndexOfChar(100);
            myTextField.appendText("100th character is in line: " +  (index + 1) + "\n");
            index = myTextField.getLineIndexOfChar(500);
            myTextField.appendText("500th character is in line: " + (index + 1));

            this.addChild(myTextField);
        }
    }
}
getLineLength()Methode 
public function getLineLength(lineIndex:int):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.

Parameter

lineIndex:int — Die Nummer der Zeile, deren Länge Sie ermitteln möchten.

Rückgabewerte
int — Die Anzahl der Zeichen in der Zeile.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel

Im folgenden Beispiel wird die Zeilenlänge (Anzahl der Zeichen) einer Zeile in einem separaten Feld angezeigt, wenn der Benutzer auf die Zeile klickt.

Zur Veranschaulichung wird das Textfeld myTextField, in dem der zu zählende Text angezeigt wird, auf INPUT gesetzt, sodass der Benutzer die Zeilen ändern oder zwischen den Zeilen bzw. am Ende Zeilen hinzufügen kann. (Am Ende der letzten Zeile wird mithilfe eines Zeilenumbruchs (\n) eine leere Zeile erstellt.) Das Textfeld countLines, in dem das Ergebnis der Zeilenlängenermittlung angezeigt wird, wird unter dem Textfeld myTextField platziert, der Text in diesem Feld kann nicht ausgewählt werden. Wenn der Benutzer auf eine Zeile im Textfeld myTextField klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode gibt die getLineIndexAtPoint()-Methode den Zeilenindex der Zeile zurück, auf die der Benutzer geklickt hat. Dazu werden die localX- und localY-Koordinaten des Mausklicks verwendet. Die if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Ist dies der Fall, gibt die getLineLength()-Methode unter Verwendung des Zeilenindex die Anzahl der Zeichen in der Zeile zurück. Beachten Sie, dass die leeren Zeilen zwischen den Zeilen das zweite Zeilenumbruchzeichen (\n) enthalten und eine Zählung von 1 Zeichen aufweisen, während die Zeile nach der letzten Zeile eine Zählung von 0 aufweist. Leerzeichen zählen ebenfalls als ein Zeichen. Der Benutzer kann eine neue Zeile schreiben oder eine Zeile ändern und die Zeichenzählung der Zeile erhalten, indem er auf die Zeile klickt. Wenn Zeilenumbrüche verwendet werden und die Bildschirmgröße geändert wird, könnte sich der Zeilenindex ändern.

 package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.events.Event;
    import flash.events.MouseEvent;

    public class TextField_getLineLengthExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countLines:TextField = new TextField();  

        public function TextField_getLineLengthExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 350;
            myTextField.height = 150;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.type = TextFieldType.INPUT;
            
            myTextField.appendText("Click on the lines to count its number of characters:\n\n");
            myTextField.appendText("This is a short line.\n");
            myTextField.appendText("This is a longer line than the last line.\n\n");
            myTextField.appendText("This one is even longer than the one before. It has two sentences.\n");

            this.addChild(myTextField);

            countLines.border = true;
            countLines.x = 10;
            countLines.y = 180;
            countLines.height = 30;
            countLines.width = 200;
            countLines.background = true;
            countLines.selectable = false;

           this.addChild(countLines);    

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
        }

        private function clickHandler(e:MouseEvent):void {
            var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY);
        
            if (index != -1) {
            var lenght:int = myTextField.getLineLength(index);

            countLines.text = "Number of characters in the line is: " + lenght.toString();
            }
        }
    }
}
getLineMetrics()Methode 
public function getLineMetrics(lineIndex:int):TextLineMetrics

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Rückgabewerte
TextLineMetrics — Ein TextLineMetrics-Objekt.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Siehe auch


Beispiel

Im folgenden Beispiel werden einige metrische Zeilenwerte für zwei unterschiedlich formatierte Textzeilen angezeigt.

Der angehängte Text befindet sich zwei Zeilen unter dem Gedicht Song of Myself von Walt Whitman. Mit einem neuen TextFormat-Objekt (newFormat) wird das Format der zweiten Zeile festgelegt. Die erste Zeile enthält das Standardformat. Die getLineMetrics()-Methode gibt ein TextLineMetrics-Objekt für eine bestimmte Zeile zurück. (Der Zeilenindex beginnt mit 0.) Mit den TextLineMetrics-Objekten metrics1 und metrics2 für die erste und zweite Zeile werden jeweils die Werte für die Oberlänge (ascent), Unterlänge (descent), Höhe (height) und Strichstärke (weight) der Zeile abgerufen und angezeigt. Die resultierenden Zahlen werden in Strings konvertiert, jedoch nicht gerundet. Beachten Sie, dass dieser Wert für die Zeile und nicht für ein bestimmtes Zeichen gilt. Er spiegelt den Bereich der Zeichen für eine Zeile wieder. Wenn in einer Zeile zum Beispiel Zeichen mit unterschiedlichen Höhen vorkommen, bestimmt das Zeichen mit dem höchsten Wert für die Höhe den Wert. Dies bedeutet auch, dass sich einige metrische Werte ändern können, wenn das Format eines Zeichens geändert wird.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextLineMetrics;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.TextFormat;
 
    public class TextField_getLineMetricsExample extends Sprite {

        public function TextField_getLineMetricsExample() {
            var myTextField:TextField = new TextField();
            var newFormat:TextFormat = new TextFormat(); 

            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.wordWrap = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n");
            myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n");

            newFormat.size = 14;
            newFormat.font = "Arial";
            newFormat.italic = true;
            myTextField.setTextFormat(newFormat, 67, 139);
               
            var metrics1:TextLineMetrics = myTextField.getLineMetrics(0);
             
            myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n");
            myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n");
            myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); 
            myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n");

            var metrics2:TextLineMetrics = myTextField.getLineMetrics(1);
             
            myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n");
            myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n");
            myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); 
            myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n");

            addChild(myTextField);
        }
    }
}
getLineOffset()Methode 
public function getLineOffset(lineIndex:int):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
int — Der auf null basierende Indexwert des ersten Zeichens in der Zeile.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel

Im folgenden Beispiel wird das erste Zeichen in Zeile 4 überprüft, welches sich ändert, wenn die Größe des Bildschirms (und des Textfelds) geändert wird.

Für das Textfeld myTextField wird der Zeilenumbruch festgelegt. Im Textfeld countField wird das erste Zeichen der Zeile 4 angezeigt. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die Methode clickHandler() aufgerufen.

In der clickHandler()-Methode gibt die getLineOffset()-Methode den Index des ersten Zeichens bei Zeilenindex 3, also in der vierten Zeile des Textes, zurück. (Die erste Zeile hat den Index 0.) Die charAt()-Methode wird verwendet, um das Zeichen mithilfe des Index des ersten Zeichens der vierten Zeile abzurufen. Der Inhalt des Textfelds countField wird mit diesen Informationen aktualisiert; dazu wird die text-Eigenschaft des Textfelds countField verwendet. Die Verwendung der countField.text-Eigenschaft bedeutet, dass nach jedem Klick der Inhalt des Textfelds countField überschrieben wird. Wenn der Benutzer die Größe der Anzeige ändert, wird für den Inhalt ein Zeilenumbruch ausgeführt, und das erste Zeichen der Zeile 4 könnte sich ändern. Durch erneutes Klicken auf das Textfeld myTextField wird der Inhalt des Textfelds countField mit dem neuen ersten Zeichen der vierten Zeile aktualisiert.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;

    public class TextField_getLineOffsetExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countField:TextField = new TextField();
        
        public function TextField_getLineOffsetExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 150;
            myTextField.height = 300;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.wordWrap = true;

            countField.height = 20;
            countField.width = 200;
            countField.x = 10;
            countField.y = 320;
            countField.selectable = false;
            
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file " 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript.");

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
        
            this.addChild(myTextField);
            this.addChild(countField);
        }
    
            private function clickHandler(e:MouseEvent):void {
                var c:String;
                var index:int;
                
                index = myTextField.getLineOffset(3);
                c = myTextField.text.charAt(index);
                countField.text = "The first character of line 4 is: " + c;
            }
    }
}
getLineText()Methode 
public function getLineText(lineIndex:int):String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
String — Der in der angegebenen Zeile enthaltene Textstring.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel

Im folgenden Beispiel werden die Zeilennummern aller Vorkommnisse des Wortes "love" im Shakespeare-Sonett gesucht und angezeigt.

Das Textfeld poem wird so eingerichtet, dass es sich an den Text anpasst und links ausgerichteten Text anzeigt. Die wordWrap-Eigenschaft wird auf false gesetzt, sodass für die Zeilen des Gedichts kein Zeilenumbruch ausgeführt wird, obwohl dies normalerweise kein Problem sein sollte, wenn die autoSize-Eigenschaft verwendet wird. Die for-Schleife durchläuft die Zeilen des Sonetts mithilfe der numLines-Eigenschaft des Textfelds. Die getLineText()-Methode gibt den Inhalt der Zeile als String zurück. (Beachten Sie, dass die numLines-Eigenschaft die Anzahl der Zeilen ab 1 zurückgibt, während bei der getLineText()-Methode die Zeilennummern bei 0 anfangen.) Unter Verwendung des regulären Ausdrucks (/love/i) sucht die if-Anweisung nach Teilstrings des Worts und Groß- oder Kleinschreibung. Wenn der Ausdruck gefunden wird, gibt die search-Methode den Index des ersten übereinstimmenden Teilstrings zurück, andernfalls wird -1 zurückgegeben (wenn kein Treffer gefunden wird). Die Nummer der Zeile, in der "love" gefunden wurde ((i + 1)), wird dann in den String lineResult platziert. Die string-Methode konvertiert das number-Argument ((i + 1)) in einen String, sofern es ein anderes Argument gibt, das ein String ist (" "). Das Zeilenergebnis der Suche schließt Zeilen mit den Wörtern "loved" oder "Love's" mit ein. Wenn der String "Love was found in lines:" ("Liebe wurde in diesen Zeilen gefunden:") der for-Schleife vorangestellt würde, wäre das Wort "Love" in dieser Zeile ebenfalls eingeschlossen worden.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.utils.Timer;
    import flash.events.TimerEvent;
 
    public class TextField_getLineTextExample extends Sprite {
           
        public function TextField_getLineTextExample() {
           var poem:TextField = new TextField();
           var lineResult:String = ""; 
           var pattern:RegExp = /love/i;

            poem.x = 10;
            poem.y = 10;
            poem.background = true;
            poem.wordWrap = false;
            poem.autoSize = TextFieldAutoSize.LEFT;
            
            poem.text = "Let me not to the marriage of true minds\n"
                              + "Admit impediments. love is not love\n"
                              + "Which alters when it alteration finds\n"
                              + "Or bends with the remover to remove:\n"
                              + "O no! it is an ever-fixed mark\n" 
                              + "That looks on tempests and is never shaken;\n"
                              + "It is the star to every wandering bark,\n"
                              + "Whose worth's unknown, although his height be taken.\n"
                              + "Love's not Time's fool, though rosy lips and cheeks\n"
                              + "Within his bending sickle's compass come:\n"
                              + "Love alters not with his brief hours and weeks,\n"
                              + "But bears it out even to the edge of doom.\n"
                              + "If this be error and upon me proved,\n"
                              + "I never writ, nor no man ever loved.\n\n";

            for (var i:int = 0; i < poem.numLines; i++) {

                var s:String = poem.getLineText(i);
                        
                if(s.search(pattern) != -1) {
                    lineResult += (i + 1) + " ";
                }
            }

            poem.appendText("Love was found in lines: " + lineResult);
             
            this.addChild(poem);                      
        }
    }
}
getParagraphLength()Methode 
public function getParagraphLength(charIndex:int):int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
int — Gibt die Anzahl der Zeichen im Absatz zurück.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im Bereich.

Siehe auch


Beispiel

Im folgenden Beispiel wird die Länge des Absatzes sowie die Anzahl des Zeichens "s" im Absatz in einem separaten Textfeld angezeigt, wenn der Benutzer eine Absatz auswählt.

Im Textfeld myTextField werden die Absätze angezeigt, die der Benutzer auswählt. Wenn der Benutzer auf das Textfeld klickt, wird das MouseEvent.CLICK-Ereignis ausgelöst und die Methode clickHandler() wird aufgerufen. Die Länge des Absatzes und die Anzahl der "s"-Zeichen wird im Textfeld countField angezeigt, das unter dem Textfeld myTextField platziert wird.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Die erste if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Die getFirstCharInParagraph()-Methode verwendet diesen Index, um den Index des ersten Zeichens im selben Absatz zurückzugeben. Die von der getParagraphLength()-Methode zurückgegebene Absatzlänge wird zusammen mit dem Index des ersten Zeichens im Absatz verwendet, um den Index für das Absatzende zu bestimmen. Eine for-Schleife durchläuft den Absatz und ermittelt die Anzahl der "s"-Zeichen.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;

    public class TextField_getParagraphLengthExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countField:TextField = new TextField();

        public function TextField_getParagraphLengthExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.width = 300;
            myTextField.height = 280;
            
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file" 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                        + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                        + "Target Path dialog box in the Actions panel.\n\n"  
                        + "To create a text field dynamically, use the TextField() constructor.\n\n"
                        + "The methods of the TextField class let you set, select, and manipulate "  
                        + "text in a dynamic or input text field that you create during authoring or at runtime.");

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            countField.x = 10;
            countField.y = 300;
            countField.height = 50;
            countField.width = 250;
            countField.background = true;
            countField.selectable = false;

            this.addChild(myTextField);
            this.addChild(countField);
        }

        private function clickHandler(e:MouseEvent):void {
            var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
            
            if(index != -1) {
                var beginParag:int = myTextField.getFirstCharInParagraph(index);
                var paragLength:int = myTextField.getParagraphLength(index);
                var endParag:int = beginParag + paragLength;
                var sCount:uint = 0;

                for (var i:int = beginParag; i <= endParag; i++) {
                    if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) {
                        sCount++; 
                    }

                countField.text = "Paragraph length is: " + paragLength.toString() + "\n" 
                        + "Number of 's' characters in the paragraph: " + sCount.toString();
                }
            }
        }
    }
}
getTextFormat()Methode 
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):TextFormat

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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:

VerwendungBeschreibung
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) — Optional; eine Ganzzahl, die den Startpunkt eines Textbereichs innerhalb des Textfelds angibt.
 
endIndex:int (default = -1) — Optional; eine Ganzzahl zur Angabe der Position des ersten Zeichens nach dem gewünschten Textbereich. Wenn Sie die Werte beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 gelesen.

Rückgabewerte
TextFormat — Das TextFormat-Objekt, das die Formatierungseigenschaften des angegebenen Texts wiedergibt.

Auslöser
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im Bereich.

Siehe auch


Beispiel
Verwendung von Beispielen
Die Verwendung der Methode getTextFormat() wird im Beispiel für die Methode getFirstCharInParagraph() oder setTextFormat() veranschaulicht.
replaceSelectedText()Methode 
public function replaceSelectedText(value:String):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Siehe auch


Beispiel

Im folgenden Beispiel löscht der Benutzer Text aus dem ersten Textfeld, indem er ihn auswählt und den ausgewählten Text im zweiten Textfeld durch den String "NEW TEXT" ersetzt.

Es werden zwei verschiedene TextField-Objekte erstellt, und für die MouseEvent.MOUSE_UP-Ereignisse werden Ereignis-Listener hinzugefügt. "Mouse up" tritt ein, wenn der Benutzer die Maustaste loslässt, ein Ereignis, das normalerweise nach der Auswahl eines Textabschnitts vorkommt. Beachten Sie, dass die Standardeinstellung eines Textfelds vorsieht, dass der darin befindliche Text ausgewählt werden kann.

Mit der mouseHandler1()-Methode wird der Text gelöscht, indem er durch einen leeren String ersetzt wird, wenn der Benutzer die Maustaste im Textfeld myTextField1 loslässt. Dies kann wiederholt werden, bis der gesamte Text gelöscht wurde. In der mouseHandler2()-Methode werden die Eigenschaften selectionBeginIndex und selectionEndIndex überprüft, um festzustellen, ob Zeichen ausgewählt wurden, wenn ein Benutzer Text im Textfeld myTextField2 auswählt. (Die Eigenschaften selectionBeginIndex und selectionEndIndex haben nicht denselben Wert, wenn Text ausgewählt wurde.) Der ausgewählte Text wird dann durch den String "NEW TEXT" ersetzt. Dies kann wiederholt werden, bis der gesamte ursprüngliche Text des zweiten Textfelds durch den String "NEW TEXT" ersetzt wurde.

package {
    import flash.display.Sprite;
    import flash.text.TextField;    
    import flash.events.MouseEvent;

    public class TextField_replaceSelectedTextExample extends Sprite {
        private var myTextField1:TextField = new TextField();
        private var myTextField2:TextField = new TextField();
        
        public function TextField_replaceSelectedTextExample() {
            myTextField1.x = 10;
            myTextField1.width = 300;
            myTextField1.height = 50; 
            myTextField1.background = true; 
            myTextField1.border = true;
            myTextField1.text = "Select the text you want to remove from the line.";
            
            myTextField2.x = 10;
            myTextField2.y = 60;
            myTextField2.width = 300;
            myTextField2.height = 50;
            myTextField2.background = true;
            myTextField2.border = true;
            myTextField2.text = "Select the text you want to replace with NEW TEXT.";
            
            myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1);
            myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2);
            
            this.addChild(myTextField1);
            this.addChild(myTextField2);
        }
        
        private function mouseHandler1(e:MouseEvent):void {
            myTextField1.replaceSelectedText("");
        }

        private function mouseHandler2(e:MouseEvent):void {
            if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) {
                myTextField2.replaceSelectedText("NEW TEXT");    
            }
        }
    }
}
replaceText()Methode 
public function replaceText(beginIndex:int, endIndex:int, newText:String):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Beispiel

Im folgenden Beispiel wird die replaceText()-Methode verwendet, um Text in einem Textfeld zu löschen, zu ersetzen und einzufügen.

Das Textfeld outputText wird so eingerichtet, dass es sich an den Text anpasst und links ausgerichteten Text anzeigt. Mit dem ersten Aufruf der replaceText()-Methode wird die erste Zeile ("This is the wrong heading") durch "THIS IS THE HEADING FOR EVERYONE" ersetzt. Mit dem zweiten Aufruf der Methode wird der Text "CORRECT" zwischen "THE" und "HEADING" eingefügt. Mit dem dritten Aufruf der Methode werden die Worte "FOR EVERYONE" gelöscht. Beachten Sie, dass mit jedem Aufruf der appendText()-Methode der Anfangs- und Endindex des Textes geändert wird. Hier wird nur der endgültige Text (nachdem alle Änderungen vorgenommen wurden) angezeigt.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_replaceTextExample extends Sprite {

        public function TextField_replaceTextExample() {
            var outputText:TextField = new TextField();

            outputText.x = 10;
            outputText.y = 10;
            outputText.background = true;
            outputText.autoSize = TextFieldAutoSize.LEFT;
            
            outputText.appendText("This is the wrong heading");
            outputText.appendText("\n\n"); 
            outputText.appendText("This is the body of the text.");

            outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE");

            outputText.replaceText(12, 12, "CORRECT ");
            
            outputText.replaceText(27, 40, "");
            
           this.addChild(outputText);
         }
    }
}
setSelection()Methode 
public function setSelection(beginIndex:int, endIndex:int):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter beginIndex und endIndex) angegebenen Text als ausgewählt fest. Wenn die beiden Parameterwerte identisch sind, wird durch diese Methode wie bei der Eigenschaft caretIndex der Einfügepunkt festgelegt.

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.

Siehe auch


Beispiel

Wenn der Benutzer im folgenden Beispiel auf eine beliebige Stelle im Textfeld klickt, wird ein vordefinierter Textbereich ausgewählt (der die Wörter "TEXT IN ALL CAPS" hervorhebt).

Zwei Ereignis-Listener für das Textfeld myTextField antworten auf das Betätigen bzw. auf das Loslassen der Maustaste durch den Benutzer. "Mouse up" tritt ein, wenn der Benutzer die Maustaste loslässt, ein Ereignis, das normalerweise nach der Auswahl eines Textabschnitts vorkommt. Beachten Sie, dass die Standardeinstellung eines Textfelds vorsieht, dass der darin befindliche Text ausgewählt werden kann. Wenn auf Text geklickt wird, wird die clickHandler()-Methode aufgerufen. Wenn Text ausgewählt wurde und die Maustaste losgelassen wird, wird die mouseUpHandler()-Methode aufgerufen.

In beiden Methoden, clickHandler() und mouseUpHandler(), legt die setSelection()-Methode nur die Zeichen zwischen den Indizes 54 und 70 (TEXT IN ALL CAPS) als ausgewählt fest.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_setSelectionExample extends Sprite
    {
        private var myTextField:TextField = new TextField();

        public function TextField_setSelectionExample() {
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected.";

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            this.addChild(myTextField);
        }

        private function clickHandler(event:MouseEvent):void {
            myTextField.setSelection(54, 70);
        }

        private function mouseUpHandler(event:MouseEvent):void {
            myTextField.setSelection(54, 70);
        }

    }
}
setTextFormat()Methode 
public function setTextFormat(format:TextFormat, beginIndex:int = -1, endIndex:int = -1):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 eigene Zeichenformatierungseinstellungen aufweisen, z. B. Schriftname, Schriftgröße, Fett- und Kursivformatierung.

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.

Manuell vom Benutzer eingefügter oder mit der Methode replaceSelectedText() ersetzter Text erhält nicht die für die Texteinfügemarke angegebene Formatierung, sondern die Standardformatierung für neuen Text des Textfelds. Wenn Sie die Standardformatierung eines Textfelds für neuen Text definieren möchten, verwenden Sie defaultTextFormat.

Parameter

format:TextFormat — Ein TextFormat-Objekt, das sowohl Zeichen- als auch Absatzformatierungsinformationen enthält.
 
beginIndex:int (default = -1) — Optional; eine Ganzzahl, die die auf null basierende Indexposition angibt, die ihrerseits das erste Zeichen im gewünschten Textbereich angibt.
 
endIndex:int (default = -1) — Optional; eine Ganzzahl zur Angabe des ersten Zeichens nach dem gewünschten Textbereich. Wenn Sie die Werte beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 aktualisiert.

VerwendungBeschreibung
my_textField.setTextFormat(textFormat:TextFormat)Wendet die Eigenschaften von textFormat auf den gesamten Text im Textfeld an.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Wendet die Eigenschaften von textFormat auf den Text an, der an der Position beginIndex beginnt.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Wendet die Eigenschaften von textFormat auf den Textbereich zwischen beginIndex und endIndex-1 an.

Beachten Sie, dass manuell vom Benutzer eingefügter oder mit der Methode replaceSelectedText() ersetzter Text nicht die für die Texteinfügemarke angegebene Formatierung erhält, sondern die Standardformatierung für neuen Text des Textfelds. Wenn Sie die Standardformatierung eines Textfelds für neuen Text definieren möchten, verwenden Sie die Eigenschaft defaultTextFormat.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.
 
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im Bereich.

Siehe auch


Beispiel

Im folgenden Beispiel wechselt beim Klicken auf den Text ein definierter Textbereich, "TEXT IN ALL CAPS" zwischen dem Standardtextformat und dem neuen Format.

Es wird ein Ereignis-Listener für das Textfeld myTextField hinzugefügt, das auf Mausklicks reagiert, indem die clickHandler()-Methode aufgerufen wird. In der clickHandler()-Methode gibt die getTextFormat()-Methode das aktuelle Format eines Zeichens (Index 55) aus dem eingerückten Bereich des Texts zurück, welches dann in das TextFormat-Objekt currentTextFormat platziert wird. Die if-Anweisung überprüft das Textformat currentTextFormat, um festzustellen, ob die Zeichen in dem Bereich das neue Format verwenden (Schriftgröße 18 Punkt). Ist dies nicht der Fall, ändert das neue Format die Größe auf 18 Punkt, die Farbe auf Rot und wendet die Formate Unterstrichen und Kursiv auf den Bereich zwischen 54 und 70 (TEXT IN ALL CAPS) an. Wenn das Zeichen in dem Bereich das neue Format verwendet, wird das Format des Bereichs auf das Standardformat (das ursprüngliche Format) des Textfelds zurückgesetzt.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFormat;  
    import flash.text.TextFieldAutoSize;  
    import flash.events.MouseEvent;

    public class TextField_setTextFormatExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var newFormat:TextFormat = new TextFormat();
        
        public function TextField_setTextFormatExample() {
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            myTextField.selectable = false;
            myTextField.background = true;
            myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format.";

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);

            newFormat.color = 0xFF0000;
            newFormat.size = 18;
            newFormat.underline = true;
            newFormat.italic = true;
                
            this.addChild(myTextField);
        }

        private function clickHandler(event:MouseEvent):void {
            var currentTextFormat:TextFormat = myTextField.getTextFormat(55);
            
            if(currentTextFormat.size != 18) {
                myTextField.setTextFormat(newFormat, 54, 70);
            }
            else {
                myTextField.setTextFormat(myTextField.defaultTextFormat);
            }    
        }    
    }
}
Ereignisdetail
change Ereignis
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.CHANGE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, nachdem der Wert eines Steuerelements geändert wurde. Vergleichen Sie dies mit dem textInput-Ereignis, das vor der Änderung des Werts ausgelöst wird. Im Gegensatz zur W3C DOM-Ereignismodell-Version des change-Ereignisses, bei der das Ereignis erst nach einem Wechsel des Fokus auf ein anderes Steuerelement ausgelöst wird, wird das Ereignis bei der ActionScript 3.0-Version des change-Ereignisses ausgelöst, sobald sich das Steuerelement ändert. Wenn ein Benutzer z. B. Text in ein Textfeld eingibt, wird ein change-Ereignis nach jedem Tastendruck ausgelöst.

Definiert den Wert der Eigenschaft type eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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.

Beispiel

Im folgenden Beispiel wird die Benutzereingabe sofort in ein anderes Textfeld mit einem anderen Textformat kopiert.

Es werden zwei Textfelder erstellt, eines für die Benutzereingabe und das andere (headingTextField) für die Kopie der Benutzereingabe. Es wird auch ein TextFormat-Objekt erstellt und dem Standardtextformat des Textfeld headingTextField zugewiesen. Wenn der Inhalt des Textfelds geändert wird, wird die changeHandler()-Methode aufgerufen, die den Text aus dem Textfeld inputTextField dem Textfeld headingTextField zuweist. (Wenn die Methode für das TextEvent.TEXT_INPUT-Ereignis und nicht für das Event.CHANGE-Ereignis aufgerufen wird, wird der Inhalt der Benutzereingabe erst kopiert, nachdem der Benutzer eine weitere Eingabe vorgenommen hat.)

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.text.TextFormat;
    import flash.text.TextFormatAlign;
    import flash.events.Event;
    
    import flash.events.TextEvent;

    public class TextField_Event_changeExample extends Sprite {
        private var inputTextField:TextField = new TextField(); 
        private var headingTextField:TextField = new TextField(); 
        private var newFormat:TextFormat = new TextFormat();
         
        public function TextField_Event_changeExample() {
            headingTextField.x = 10;
            headingTextField.y = 10;
            headingTextField.height = 30;
            headingTextField.width = 400;
            headingTextField.background = true;
            headingTextField.backgroundColor = 0xF5F5DC;
            headingTextField.selectable = false;
 
            inputTextField.x = 10;
            inputTextField.y = 70;
            inputTextField.height = 20;
            inputTextField.width = 230;
            inputTextField.background = true;
            inputTextField.border = true;
            inputTextField.maxChars = 40;
            inputTextField.wordWrap = true;
            inputTextField.type = TextFieldType.INPUT;

            inputTextField.addEventListener(Event.CHANGE, changeHandler);

            newFormat.bold = true;
            newFormat.size = 18;
            newFormat.color = 0xFF0000;
            newFormat.align = TextFormatAlign.CENTER;

            headingTextField.defaultTextFormat = newFormat;

            this.addChild(inputTextField);
            this.addChild(headingTextField);
        }

        private function changeHandler(e:Event):void {
            headingTextField.text = inputTextField.text;
        }
    }
}
link Ereignis  
Ereignisobjekttyp: flash.events.TextEvent
TextEvent.type property = flash.events.TextEvent.LINK

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn ein Benutzer auf einen Hyperlink in einem HTML-fähigen Textfeld klickt und die URL-Adresse mit "event:" beginnt. Der Rest der URL nach "event:" wird in der text-Eigenschaft des LINK-Ereignisses abgelegt.

Hinweis: Das Standardverhalten (dem Textfeld wird Text hinzugefügt) tritt nur dann ein, wenn Flash Player das Ereignis erstellt. Dies ist der Fall, wenn ein Benutzer versucht, Text einzugeben. Eine Texteingabe in ein Textfeld durch Senden von textInput-Ereignissen ist nicht möglich.

Definiert den Wert der Eigenschaft type eines link-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetEs wurde auf das Textfeld mit dem Hyperlink geklickt. 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.
textDer Rest der URL nach "event:"

Beispiel

Im folgenden Beispiel wird die Funktion playMP3() definiert. Es wird das TextField-Objekt list erstellt und mit HTML-Text gefüllt. Die Texte "Track 1" und "Track 2" sind Links innerhalb des Textfelds. Die Funktion playMP3() wird aufgerufen, wenn der Benutzer auf einen der Links klickt. Der Name der MP3-Datei nach dem String "event:" im Attribut href des HTML-Tags wird an die Methode linkHandler() als Eigenschaft text des link-Ereignisobjekts weitergeleitet.

package {
    import flash.display.Sprite;
    import flash.errors.IOError;
    import flash.events.IOErrorEvent;
    import flash.events.TextEvent;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.net.URLRequest;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class TextField_event_link extends Sprite
    {
        private var myMP3:Sound;
        public function TextField_event_link() {
            myMP3 = new Sound();
            var list:TextField = new TextField();
            list.autoSize = TextFieldAutoSize.LEFT;
            list.multiline = true;
            list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>";
            list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>";
            addEventListener(TextEvent.LINK, linkHandler);
            addChild(list);
        }
        
        private function playMP3(mp3:String):void {
            try {    
                myMP3.load(new URLRequest(mp3));
                myMP3.play();
            }
            catch(err:Error) {
                trace(err.message);
            }
            myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }
        
        private function linkHandler(linkEvent:TextEvent):void {
            playMP3(linkEvent.text);
        }
        
        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace(errorEvent.text);
        }
    }
}
scroll Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.SCROLL

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Von einem TextField-Objekt ausgelöst, nachdem der Benutzer einen Bildlauf durchgeführt hat.

Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas TextField-Objekt, für das ein Bildlauf durchgeführt 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.
textInput Ereignis  
Ereignisobjekttyp: flash.events.TextEvent
TextEvent.type property = flash.events.TextEvent.TEXT_INPUT

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Flash Player löst das Ereignis textInput aus, wenn ein Benutzer ein oder mehr Textzeichen eingibt. Dieses Ereignis kann durch eine Reihe verschiedener Texteingabemethoden ausgelöst werden, z. B. über die Standardtastatur, über Eingabemethodeneditoren (Input Method Editors, IMEs), über Spracherkennungssysteme und über das Einfügen von Text ohne Formatierungs- oder Stilinformationen.

Definiert den Wert der Eigenschaft type eines textInput-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Textfeld, in das die Zeichen eingegeben werden. Das 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.
textDas bzw. die Zeichen wird/werden vom Benutzer eingegeben.
Beispiele Verwendung von Beispielen
TextFieldExample.as

Beim folgenden Beispiel wird die Klasse TextFieldExample zur Anzeige einer Textmeldung verwendet. Dies wird in den folgenden Schritten erreicht:
  1. Es wird eine label-Eigenschaft vom Typ "TextField" erstellt.
  2. Der Klassenkonstruktor ruft die Funktion configureLabel() auf.
  3. Mit der Methode configureLabel() wird zuerst ein neues TextField-Objekt erstellt, das anschließend der Eigenschaft label zugewiesen wird. Danach werden die Parameter wie folgt eingestellt:
    • Textfeld links ausrichten.
    • Hintergrundfüllung aktivieren.
    • Rahmen aktivieren.
  4. Mit der Methode configureLabel() wird die Variable format erstellt und einer neuen TextFormat-Instanz mit den folgenden Parametern zugewiesen:
    • Schriftart = Verdana
    • Schriftfarbe = reines Rot
    • Schriftgröße = 10
    • Unterstreichung = true
  5. Die Eigenschaft defaultTextFormat des Textfelds label ist auf format gesetzt, und die label-Instanz wird der Anzeigeliste hinzugefügt. In dieser wird zuerst ein Textfeld ohne Text angezeigt.
  6. Der Konstruktor setzt den Text des label-Textfelds auf "Hello world and welcome to the show." fest, indem er die setLabel()-Methode aufruft.
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFormat;


    public class TextFieldExample extends Sprite {
        private var label:TextField;
        private var labelText:String = "Hello world and welcome to the show.";

        public function TextFieldExample() {
            configureLabel();
            setLabel(labelText);
        }

        public function setLabel(str:String):void {
            label.text = str;
        }

        private function configureLabel():void {
            label = new TextField();
            label.autoSize = TextFieldAutoSize.LEFT;
            label.background = true;
            label.border = true;

            var format:TextFormat = new TextFormat();
            format.font = "Verdana";
            format.color = 0xFF0000;
            format.size = 10;
            format.underline = true;

            label.defaultTextFormat = format;
            addChild(label);
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/text/TextField.html