Paket | flash.text |
Klasse | public class TextField |
Vererbung | TextField InteractiveObject DisplayObject EventDispatcher Object |
Unterklassen | FlexTextField |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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-formatierten Text, der optional CSS-Stile verwendet, 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
.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | DisplayObject | ||
alpha : 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 | ||
blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | DisplayObject | ||
blendShader : Shader [Nur Schreiben]
Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird. | DisplayObject | ||
border : Boolean
Gibt an, ob das Textfeld umrahmt ist. | TextField | ||
borderColor : uint
Gibt die Farbe des Textfeldrahmens an. | TextField | ||
bottomScrollV : int [schreibgeschützt]
Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt. | TextField | ||
cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist. | DisplayObject | ||
caretIndex : int [schreibgeschützt]
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) aus einem Textfeld mit HTML-Text entfernt werden sollen. | TextField | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
contextMenu : NativeMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()-Methode eingefügt wird) angewendet wird. | TextField | ||
displayAsPassword : Boolean
Gibt an, ob es sich um ein Kennworttextfeld handelt. | TextField | ||
doubleClickEnabled : 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 | ||
filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | DisplayObject | ||
focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | InteractiveObject | ||
gridFitType : String
Die für dieses Textfeld verwendete Art der Rasteranpassung. | TextField | ||
height : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | DisplayObject | ||
htmlText : String
Enthält die HTML-Darstellung des Inhalts des Textfelds. | TextField | ||
length : int [schreibgeschützt]
Die Anzahl der Zeichen in einem Textfeld. | TextField | ||
loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | ||
mask : 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 [schreibgeschützt]
Der maximale Wert der Eigenschaft „scrollH“. | TextField | ||
maxScrollV : int [schreibgeschützt]
Der maximale Wert der Eigenschaft „scrollV“. | TextField | ||
metaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden. | DisplayObject | ||
mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht. | TextField | ||
mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
multiline : Boolean
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. | TextField | ||
name : String
Gibt den Instanznamen des Anzeigeobjekts an. | DisplayObject | ||
needsSoftKeyboard : Boolean
Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält. | InteractiveObject | ||
numLines : int [schreibgeschützt]
Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an. | TextField | ||
opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | DisplayObject | ||
parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | ||
restrict : String
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. | TextField | ||
root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | DisplayObject | ||
rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | DisplayObject | ||
rotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container. | DisplayObject | ||
scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | DisplayObject | ||
scaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scrollH : int
Die aktuelle horizontale Bildlaufposition. | TextField | ||
scrollRect : 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 [schreibgeschützt]
Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl. | TextField | ||
selectionEndIndex : int [schreibgeschützt]
Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. | TextField | ||
sharpness : Number
Die Schärfe der Glyphenkanten in diesem Textfeld. | TextField | ||
softKeyboard : String
Steuert das Erscheinungsbild der Bildschirmtastatur. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar). | InteractiveObject | ||
stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | DisplayObject | ||
styleSheet : StyleSheet
Fügt ein Stylesheet an das Textfeld an. | TextField | ||
tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | InteractiveObject | ||
tabIndex : 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 [schreibgeschützt]
Die Höhe des Texts in Pixel. | TextField | ||
textInteractionMode : String [schreibgeschützt]
Die Interaktionsmodus-Eigenschaft; der Standardwert ist TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [schreibgeschützt]
Die Breite des Texts in Pixel. | TextField | ||
thickness : Number
Die Stärke der Glyphenkanten in diesem Textfeld. | TextField | ||
transform : flash.geom: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 | ||
visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | DisplayObject | ||
width : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an. | DisplayObject | ||
wordWrap : Boolean
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird. | TextField | ||
x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | ||
y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | ||
z : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an. | DisplayObject |
Methode | Definiert von | ||
---|---|---|---|
Erstellt eine neue TextField-Instanz. | TextField | ||
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 | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
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 einen DisplayObject-Verweis für die jeweilige ID, ein Bild oder eine SWF-Datei zurück, die bzw. das einem HTML-formatierten Textfeld über ein <img>-Tag hinzugefügt wurde. | 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 | ||
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück. | TextField | ||
Gibt metrische Informationen zu einer bestimmten Textzeile zurück. | TextField | ||
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter „lineIndex“ angegebenen Zeile zurück. | TextField | ||
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 | ||
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 | ||
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter „beginIndex“ und „endIndex“ angegebenen Textbereich zurück. | TextField | ||
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | DisplayObject | ||
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | DisplayObject | ||
[statisch]
Gibt „true“ zurück, wenn eine eingebettete Schriftart mit dem angegebenen fontName und fontStyle verfügbar ist, wobei Font.fontType gleich flash.text.FontType.EMBEDDED ist. | TextField | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten. | DisplayObject | ||
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | DisplayObject | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters „value“. | TextField | ||
Ersetzt den Zeichenbereich, der durch die Parameter „beginIndex“ und „endIndex“ angegeben wird, durch den Inhalt des Parameters „newText“. | TextField | ||
Blendet eine virtuelle Tastatur ein. | InteractiveObject | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter „beginIndex und „endIndex“) angegebenen Text als ausgewählt fest. | TextField | ||
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter „format“ angegebene Textformatierung zu. | TextField | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird. | DisplayObject | |||
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 ein Steuerelementwert geändert wurde (im Gegensatz zum textInput-Ereignis, das ausgelöst wird, bevor der Wert geändert wird). | TextField | |||
Wird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt. | InteractiveObject | |||
Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt. | InteractiveObject | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
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 | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht. | DisplayObject | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt. | DisplayObject | |||
Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat. | InteractiveObject | |||
Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat. | InteractiveObject | |||
[broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden. | DisplayObject | |||
Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt entlang der Kante der Touch-Oberfläche mit einer InteractiveObject-Instanz erstellt (z. B. durch Tippen entlang der Kante der Touch-Oberfläche auf Siri Remote für Apple TV). Bei einigen Geräten könnte dieser Kontakt auch als eine Kombination von verschiedenen Kontaktereignissen ausgelegt werden. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer auf zwei Kontaktpunkte über derselben InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät drückt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen zwei Finger auf ein Anzeigeobjekt drückt und wieder loslässt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen Berührungspunkt über die InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger über ein Anzeigeobjekt von links nach rechts bewegt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Drehgeste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann über einem Anzeigeobjekt dreht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Swipe-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit drei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann parallel über ein Anzeigeobjekt bewegt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt mit einer InteractiveObject-Instanz erstellt und dann auf ein berührungsempfindliches Gerät tippt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen mehrere Finger auf einem Anzeigeobjekt platziert, um ein Menü zu öffnen, und dann mit einem Finger tippt, um einen Menüpunkt auszuwählen). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Zoom-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann schnell über einem Anzeigeobjekt spreizt). | InteractiveObject | |||
Dieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstützt | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer eine Taste drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern. | InteractiveObject | |||
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 | |||
Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird. | InteractiveObject | |||
Wird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet. | InteractiveObject | |||
Wird vom InteractiveObject-Zielobjekt ausgelöst, wenn ein gezogenes Objekt darauf abgelegt wird und das Ablegen mit einem Aufruf von „DragManager.acceptDragDrop()“ akzeptiert wurde. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt. | InteractiveObject | |||
Wird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | |||
Wird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift von diesem InteractiveObject wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift direkt über dieses InteractiveObject bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von diesem InteractiveObject und seinen untergeordneten Elementen wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von außerhalb der Nachfolgerstruktur des Objekts in der Anzeigeliste über dieses InteractiveObject bewegt (und dabei innerhalb des Schwellenwerts für die Abstandserkennung auf dem Bildschirm bleibt). | InteractiveObject | |||
Wird abgesetzt, wenn ein Benutzer die Taste des Zeigegeräts loslässt, nachdem er die Taste über einer InteractiveObject-Instanz gedrückt und das Zeigegerät dann von der InteractiveObject-Instanz wegbewegt hat. | InteractiveObject | |||
Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll. | DisplayObject | |||
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 | |||
[broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden. | DisplayObject | |||
Wird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | |||
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 | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Alles auswählen“ aktiviert oder im Kontextmenü des Texts „Alles auswählen“ wählt. | InteractiveObject | |||
Wird sofort nach dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird direkt vor dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird sofort nach dem Ausblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert. | InteractiveObject | |||
Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert. | InteractiveObject | |||
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 | |||
Flash Player setzt das textInteractionModeChange-Ereignis ab, wenn ein Benutzer den Interaktionsmodus eines Textfeldes ändert. | TextField | |||
Wird abgesetzt, wenn der Benutzer ein berührungsempfindliches Gerät erstmals berührt (zum Beispiel mit dem Finger das Touchscreen eines Mobiltelefons oder Tablets berührt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät entfernt (zum Beispiel den Finger vom Touchscreen eines Mobiltelefons oder Tablets hebt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer das Gerät berührt, und zwar kontinuierlich, bis der Kontaktpunkt entfernt wird. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt zu einem anderen zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt auf einen Punkt außerhalb des Anzeigeobjekts zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt über derselben InteractiveObject-Instanz anhebt, auf der der Kontakt eingeleitet wurde (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem einzelnen Kontaktpunkt hebt). | InteractiveObject |
alwaysShowSelection | Eigenschaft |
alwaysShowSelection:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist false.
Implementierung
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(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; } } }
antiAliasType | Eigenschaft |
antiAliasType:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, 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 ist flash.text.AntiAliasType.NORMAL
.
Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:
Stringwert | Beschreibung |
---|---|
flash.text.AntiAliasType.NORMAL | Wendet das normale Text-Anti-Aliasing an. Dieser Wert entspricht dem Anti-Aliasing-Typ, den Flash Player 7 und frühere Versionen verwendeten. |
flash.text.AntiAliasType.ADVANCED | Wendet erweitertes Anti-Aliasing an, sodass der Text besser lesbar ist. (Diese Funktion ist seit Flash Player 8 verfügbar.) Erweitertes Anti-Aliasing ermöglicht die hochwertige Wiedergabe von kleinen Schriftarten. Es eignet sich am besten für Anwendungen mit sehr viel kleinem Text. Das erweiterte Anti-Aliasing bietet sich hingegen nicht für große Schriften (über 48 Punkte) an. |
Implementierung
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Verwandte API-Elemente
autoSize | Eigenschaft |
autoSize:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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“.
|
Verwandte API-Elemente
background | Eigenschaft |
background:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist false.
Implementierung
public function get background():Boolean
public function set background(value:Boolean):void
Verwandte API-Elemente
backgroundColor | Eigenschaft |
backgroundColor:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Hintergrundfarbe des Textfelds an. Der Standardwert ist 0xFFFFFF
(weiß). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Hintergrund verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft background
des Textfelds true
ist.
Implementierung
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Verwandte API-Elemente
border | Eigenschaft |
border:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist false.
Implementierung
public function get border():Boolean
public function set border(value:Boolean):void
Verwandte API-Elemente
borderColor | Eigenschaft |
borderColor:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Farbe des Textfeldrahmens an. Der Standardwert ist 0x000000
(schwarz). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Rahmen verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft border
des Textfelds true
ist.
Implementierung
public function get borderColor():uint
public function set borderColor(value:uint):void
Verwandte API-Elemente
bottomScrollV | Eigenschaft |
bottomScrollV:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
Verwandte API-Elemente
caretIndex | Eigenschaft |
caretIndex:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Der Index der Position der Einfügemarke. Wenn keine Einfügemarke angezeigt wird, ergibt sich der Wert aus der Position, die die Einfügemarke erhält, wenn das Feld den Fokus zurückerlangt (normalerweise die Stelle, an der sich die Einfügemarke zuvor befunden hat, oder 0, wenn das Feld bislang nicht den Fokus hatte).
Indizes für Auswahlbereiche haben die Basis null (d. h. die erste Position ist 0, die zweite Position 1 usw.).
Implementierung
public function get caretIndex():int
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
printCursorPosition
-Methode 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 = createCustomTextField(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 createCustomTextField(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; } } }
condenseWhite | Eigenschaft |
condenseWhite:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text entfernt werden sollen. Der Standardwert ist false
. Die Eigenschaft condenseWhite
betrifft nur Text mit der Eigenschaft htmlText
, nicht mit der Eigenschaft text
. Wenn Sie Text mit der Eigenschaft text
festlegen, wird condenseWhite
ignoriert.
Wenn condenseWhite
auf true
gesetzt ist, verwenden Sie HTML-Standardbefehle wie <BR>
und <P>
, um in das Textfeld Zeilenumbrüche einzufügen.
Legen Sie die Eigenschaft condenseWhite
fest, bevor Sie die Eigenschaft htmlText
festlegen.
Implementierung
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(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; } } }
defaultTextFormat | Eigenschaft |
defaultTextFormat:flash.text:TextFormat
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()
-Methode eingefügt wird) angewendet wird.
Hinweis: Wenn Zeichen ausgewählt werden, die mit setSelection()
und replaceSelectedText()
ersetzt werden sollen, wird das defaultTextFormat
nur angewendet, wenn der Text bis zu und einschließlich dem letzten Zeichen ausgewählt wurde. Hier ist ein Beispiel:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Bei Aufruf der Eigenschaft defaultTextFormat
sind alle Eigenschaften des zurückgegebenen TextFormat-Objekts definiert. Keine Eigenschaft besitzt den Wert null
.
Hinweis: Diese Eigenschaft kann nicht festgelegt werden, wenn ein Stylesheet auf das Textfeld angewendet wird.
Implementierung
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.
|
Verwandte API-Elemente
displayAsPassword | Eigenschaft |
displayAsPassword:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist false.
Implementierung
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | Eigenschaft |
embedFonts:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist false.
Implementierung
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Verwandte API-Elemente
gridFitType | Eigenschaft |
gridFitType:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, 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 Stringwerte verwenden:
Stringwert | Beschreibung |
---|---|
flash.text.GridFitType.NONE | Definiert keine Rasteranpassung. Horizontale und vertikale Linien in den Glyphen werden nicht am Pixelraster ausgerichtet. Diese Einstellung wird für Animationen und große Schriftgrade empfohlen. |
flash.text.GridFitType.PIXEL | Definiert die Anpassung breiter horizontaler und vertikaler Linien an das Pixelraster. Diese Einstellung funktioniert nur für linksbündig ausgerichtete Textfelder. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.display.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Diese Einstellung bietet im Allgemeinen die beste Lesbarkeit für linksbündigen Text. |
flash.text.GridFitType.SUBPIXEL | Breite horizontale und vertikale Linien werden an das Sub-Pixelraster auf LCD-Displays angepasst. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Die Einstellung flash.text.GridFitType.SUBPIXEL eignet sich oft für rechtsbündigen oder zentrierten dynamischen Text und ist manchmal eine praktische Alternative, wenn zwischen Animations- und Textqualität abzuwägen ist. |
Der Standardwert ist pixel.
Implementierung
public function get gridFitType():String
public function set gridFitType(value:String):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
gridFitType
-Eigenschaft. Achten Sie bei diesem Beispiel auf den Unterschied in der Lesbarkeit der ersten beiden Zeilen. Beachten Sie auch die optimale Verwendung von GridFitType.PIXEL
für link ausgerichteten Text und GridFitType.SUBPIXEL
für rechts ausgerichteten Text.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | Eigenschaft |
htmlText:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Enthält die HTML-Darstellung des Inhalts des Textfelds.
Flash Player unterstützt die folgenden HTML-Tags:
Tag | Beschreibung |
---|---|
Anker-Tag |
Mit dem Tag <a> wird ein Hyperlink erstellt. Das Tag unterstützt die folgenden Attribute:
|
Fettdruck-Tag |
Mit dem Tag <b> wird Text fett dargestellt. Für die verwendete Schriftart muss ein fettes Schriftbild vorhanden sein.
|
Zeilenumbruch-Tag |
Das Tag <br> fügt einen Zeilenumbruch in das Textfeld ein. Definieren Sie das Textfeld als mehrzeiliges Textfeld, um dieses Tag zu verwenden.
|
Schriftart-Tag |
Mit dem Tag <font> legen Sie fest, welche Schriftarten für die Textanzeige verwendet werden. Die folgenden Attribute werden vom font-Tag unterstützt::
|
Bild-Tag |
Mit dem Tag <img> können Sie externe Bilddateien (JPEG, GIF, PNG), SWF-Dateien und Movieclips in Textfelder einbetten. Text fließt automatisch um in Textfelder eingebettete Bilder herum. Sie müssen das Textfeld als mehrzeilig definieren, um Text um ein Bild fließen zu lassen.
Die folgenden Attribute werden vom
Medieninhalte, die in Textfelder eingebettet sind, werden in voller Größe angezeigt. Um die Abmessung der Medien anzugeben, die Sie einbetten, verwenden Sie das Im Allgemeinen wird ein in ein Textfeld eingebettetes Bild in der Zeile nach dem Tag Wenn sich in der Sicherheitssandbox der Anwendung AIR-Inhalt befindet, ignoriert AIR |
Kursiv-Tag |
Mit dem <i> -Tag markierter Text wird kursiv angezeigt. Für die verwendete Schriftart muss ein kursives Schriftbild vorhanden sein.
|
Listenelement-Tag |
Das Tag <li> sorgt dafür, dass vor dem Text, der vom Tag umschlossen ist, ein Aufzählungszeichen platziert wird. Hinweis: Dae Flash Player und AIR sortierte und unsortierte Listen-Tags (<ol> und <ul> nicht erkennen, ändern sie nicht, wie Ihre Liste wiedergegeben wird. Alle Listen werden unsortiert und mit Aufzählungszeichen vor jedem einzelnen Element angezeigt.
|
Absatz-Tag |
Mit dem Tag <p> wird ein neuer Absatz erstellt. Das Textfeld muss als mehrzeiliges Textfeld definiert werden, um dieses Tag zu verwenden. Die folgenden Attribute werden vom <p> -Tag unterstützt:
|
Bereichs-Tag |
Das Tag <span> ist nur im Einsatz mit CSS-Textstilen verfügbar. Das folgende Attribut wird dabei unterstützt:
|
Textformat-Tag |
Mit dem Tag Die folgenden Attribute werden vom Tag
|
Unterstreichungs-Tag |
Mit dem <u> -Tag markierter Text wird unterstrichen angezeigt.
|
Flash Player und AIR unterstützen die folgenden HTML-Entitäten:
Entität | Beschreibung |
---|---|
< | < (kleiner als) |
> | > (größer als) |
& | & (Und-Zeichen) |
" | " (doppelte Anführungszeichen) |
' | ' (Apostroph, einfaches Anführungszeichen) |
Flash Player und AIR unterstützen auch explizite Zeichencodes wie z. B. & (Und-Zeichen, ASCII) und € ( €-Symbol, Unicode).
Implementierung
public function get htmlText():String
public function set htmlText(value:String):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(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 = createCustomTextField(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 createCustomTextField(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; } } }
length | Eigenschaft |
maxChars | Eigenschaft |
maxChars:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann. Mit einem Skript kann mehr Text eingefügt werden, als die Eigenschaft maxChars
zulässt. maxChars
gibt lediglich an, wie viel Text ein Benutzer eingeben kann. Wenn der Wert dieser Eigenschaft 0
ist, können die Benutzer unbegrenzt viel Text eingeben.
Der Standardwert ist 0.
Implementierung
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | Eigenschaft |
maxScrollV | Eigenschaft |
mouseWheelEnabled | Eigenschaft |
mouseWheelEnabled:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht. Der Standardwert ist true
. Diese Eigenschaft ist nützlich, wenn Sie verhindern möchten, dass in Textfeldern ein Bildlauf mit dem Mausrad durchgeführt wird oder wenn Sie Ihre eigene Bildlaufeigenschaften für Textfelder erstellen möchten.
Implementierung
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | Eigenschaft |
multiline:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. Bei true
ist das Textfeld mehrzeilig, bei false
ist es einzeilig. In einem Feld des Typs TextFieldType.INPUT
gibt der multiline
-Wert an, ob die Enter
-Taste eine neue Zeile erstellt (bei false
wird die Enter
-Taste ignoriert). Wenn Sie Text in ein TextField
einfügen, dessen multiline
-Wert auf false
gesetzt ist, werden neue Zeilen aus dem Text entfernt.
Der Standardwert ist false.
Implementierung
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Verwandte API-Elemente
numLines | Eigenschaft |
numLines:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
Verwandte API-Elemente
restrict | Eigenschaft |
restrict:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. Wenn die restrict
-Eigenschaft auf null
gesetzt ist, kann jedes beliebige Zeichen eingegeben werden. Wenn die restrict
-Eigenschaft einen leeren String enthält, können keine Zeichen eingegeben werden. Weist die Eigenschaft restrict
eine bestimmte Zeichenfolge als Wert auf, können nur diese Zeichen in das Textfeld eingegeben werden. Der String wird von links nach rechts gelesen. Sie können mithilfe eines Bindestrichs (-) einen Zeichenbereich angeben. Nur die Benutzerinteraktion ist beschränkt; ein Skript kann jeden Text in das Textfeld einfügen. Diese Eigenschaft wird nicht an die Optionen unter „Schriftarten einbetten“ im Eigenschafteninspektor angeglichen.
Wenn der String mit dem Einfügezeichen (^) beginnt, werden anfänglich alle Zeichen akzeptiert, aber nachfolgende Zeichen im String werden nicht in die Liste der zulässigen Zeichen aufgenommen. Wenn der String nicht mit dem Einfügezeichen (^) beginnt, werden anfänglich keine Zeichen akzeptiert, aber nachfolgende Zeichen im String werden in die Liste der zulässigen Zeichen aufgenommen.
Im folgenden Beispiel können nur Großbuchstaben, Leerzeichen und Zahlen in das Textfeld eingegeben werden:
my_txt.restrict = "A-Z 0-9";
Im folgenden Beispiel werden alle Zeichen bis auf Kleinbuchstaben akzeptiert:
my_txt.restrict = "^a-z";
Wenn Sie „^“ bzw. „-“ als normale Zeichen verwenden möchten, müssen Sie ihnen einen umgekehrten Schrägstrich (\) voranstellen. Zulässige Backslash-Folgen: \-, \^ oder \\. Der umgekehrte Schrägstrich muss ein echtes Zeichen im String sein; in ActionScript muss der umgekehrte Schrägstrich also doppelt eingegeben werden. Im folgenden Beispiel werden nur der Bindestrich (-) und das Einfügezeichen (^) zugelassen:
my_txt.restrict = "\\-\\^";
Das Einfügezeichen (^) kann an jeder beliebigen Stelle im String verwendet werden, um Zeichen ein- oder auszuschließen. Im folgenden Beispiel werden alle Großbuchstaben außer Q akzeptiert:
my_txt.restrict = "A-Z^Q";
Sie können die Escape-Sequenz \u
verwenden, um restrict
-Strings zu konstruieren. Im folgenden Beispiel werden nur die Zeichen zwischen ASCII 32 (Leerzeichen) und ASCII 126 (Tilde) akzeptiert:
my_txt.restrict = "\u0020-\u007E";
Der Standardwert ist null.
Implementierung
public function get restrict():String
public function set restrict(value:String):void
scrollH | Eigenschaft |
scrollH:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die aktuelle horizontale Bildlaufposition. Ist die Eigenschaft scrollH
auf 0 gesetzt, erfolgt kein horizontaler Bildlauf. Bei diesem Eigenschaftswert handelt es sich um eine Ganzzahl, die die horizontale Position in Pixeln angibt.
Die Maßeinheit für den horizontalen Bildlauf sind Pixel, die Maßeinheit für den vertikalen Bildlauf Zeilen. Der horizontale Bildlauf wird in Pixeln gemessen, da die am häufigsten verwendeten Schriftarten normalerweise Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Hierbei kommt es nicht darauf an, ob eine Zeile mehrere Schriftarten enthält, da die Höhe der Zeile immer an die größte verwendete Schriftart angepasst wird.
Hinweis: Die Eigenschaft scrollH
basiert auf 0, nicht auf 1 wie die Eigenschaft scrollV
für den vertikalen Bildlauf.
Implementierung
public function get scrollH():int
public function set scrollH(value:int):void
Verwandte API-Elemente
scrollV | Eigenschaft |
scrollV:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die vertikale Textposition in einem Textfeld. Die Eigenschaft scrollV
ist besonders nützlich, wenn Benutzer auf einen bestimmten Abschnitt in einem längeren Text hingewiesen werden sollen, und bietet sich auch zum Erstellen von Textfeldern an, in denen ein Bildlauf durchgeführt werden kann.
Die Maßeinheit für den vertikalen Bildlauf sind Zeilen, die Maßeinheit für den horizontalen Bildlauf Pixel. Wenn die erste angezeigte Zeile auch die erste Zeile im Textfeld ist, hat „scrollV“ den Wert 1 (nicht 0). Der horizontale Bildlauf wird in Pixeln gemessen, da die meisten Schriftarten Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Selbst wenn eine Zeile mehrere Schriftarten enthält, wird die Höhe der Zeile an die größte verwendete Schriftart angepasst.
Implementierung
public function get scrollV():int
public function set scrollV(value:int):void
Verwandte API-Elemente
selectable | Eigenschaft |
selectable:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist true.
Implementierung
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
selectable
-Eigenschaft auf true
gesetzt ist, und ein anderes Textfeld, in dem die selectable
-Eigenschaft auf false
gesetzt ist. Wenn Sie dieses Beispiel verwenden, versuchen Sie, den Text in diesen Feldern mit der Maus oder der Tastatur auszuwählen.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | Eigenschaft |
selectionBeginIndex:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
printCursorPosition
-Methode 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 = createCustomTextField(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 createCustomTextField(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; } } }
selectionEndIndex | Eigenschaft |
selectionEndIndex:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
printCursorPosition
-Methode 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 = createCustomTextField(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 createCustomTextField(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; } } }
sharpness | Eigenschaft |
sharpness:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, 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 ist 0.
Implementierung
public function get sharpness():Number
public function set sharpness(value:Number):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
sharpness
-Eigenschaft für ein TextField-Objekt geändert wird. Sie müssen die Schriftart einbetten und die antiAliasType
-Eigenschaft auf ADVANCED
setzen.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | Eigenschaft |
styleSheet:StyleSheet
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Fügt ein Stylesheet an das Textfeld an. Informationen zum Erstellen von Stylesheets finden Sie im Eintrag zur StyleSheet-Klasse und im ActionScript 3.0 Entwicklerhandbuch.
Sie können das mit einem Textfeld verknüpfte Stylesheet jederzeit ändern. Bei Änderung des verwendeten Stylesheets wird das Textfeld mit dem neuen Stylesheet neu gezeichnet. Wenn Sie das Stylesheet entfernen möchten, setzen Sie es auf null
oder undefined
. Wenn Sie das verwendete Stylesheet entfernen, wird das Textfeld ohne Stylesheet neu gezeichnet.
Hinweis: Wenn das Stylesheet entfernt wird, wird der Inhalt von TextField.text
und TextField.htmlText
in der vorher vom Stylesheet angewendeten Formatierung angezeigt. Um den ursprünglichen Inhalt von TextField.htmlText
ohne Formatierung zu bewahren, speichern Sie den Wert in einer Variablen, bevor Sie das Stylesheet entfernen.
Implementierung
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
stylesheet
-Eigenschaft fest, bevor Sie den Inhalt festlegen.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | Eigenschaft |
text:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt. Zeilen sind durch das Wagenrücklaufzeichen ('\r'
, ASCII 13) getrennt. Diese Eigenschaft enthält unformatierten Text im Textfeld (ohne HTML-Tags).
Verwenden Sie die Eigenschaft htmlText
, um den Text in das HTML-Format zu konvertieren.
Hinweis: Wenn ein Stylesheet auf das Textfeld angewendet wird, wird der Inhalt der text
-Eigenschaft als HTML interpretiert.
Implementierung
public function get text():String
public function set text(value:String):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(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 = createCustomTextField(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 createCustomTextField(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; } } }
textColor | Eigenschaft |
textColor:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die Farbe des Textes in einem Textfeld (im Hexadezimalformat). Das Hexadezimalfarbsystem stellt Farbwerte anhand von sechs Ziffern dar. Jede Ziffer hat 16 mögliche Werte oder Zeichen. Die Zeichen reichen von 0-9 und dann A-F. Schwarz ist beispielsweise 0x000000
; weiß ist 0xFFFFFF
.
Der Standardwert ist 0 (0x000000).
Implementierung
public function get textColor():uint
public function set textColor(value:uint):void
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(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; } } }
textHeight | Eigenschaft |
textHeight:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die Höhe des Texts in Pixel.
Implementierung
public function get textHeight():Number
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(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 createCustomTextField(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; } } }
textInteractionMode | Eigenschaft |
textInteractionMode:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Die Interaktionsmodus-Eigenschaft; der Standardwert ist TextInteractionMode.NORMAL. Auf mobilen Plattformen bedeutet der normale Modus, dass ein Bildlauf ausgeführt, der Text jedoch nicht ausgewählt werden kann. Über das integrierte Kontextmenü des Textfeldes ist es jedoch möglich, in den Auswahlmodus zu wechseln. Auf dem Desktop bedeutet der normale Modus, dass ein Bildlauf ausgeführt und der Text ausgewählt werden kann.
Implementierung
public function get textInteractionMode():String
textWidth | Eigenschaft |
textWidth:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die Breite des Texts in Pixel.
Implementierung
public function get textWidth():Number
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(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 createCustomTextField(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; } } }
thickness | Eigenschaft |
thickness:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, 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 ist 0.
Implementierung
public function get thickness():Number
public function set thickness(value:Number):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
thickness
-Eigenschaft für ein TextField-Objekt geändert wird. Sie müssen die Schriftart einbetten und die antiAliasType
-Eigenschaft auf ADVANCED
setzen.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | Eigenschaft |
type:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ist 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“.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(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; } } }
useRichTextClipboard | Eigenschaft |
useRichTextClipboard:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird. Wenn dieses Objekt auf true
gesetzt ist, kopiert Flash Player Formatierungen (wie z. B. Ausrichtung, fett und kursiv) und fügt diese ein, wenn Sie zwischen Textfeldern kopieren und einfügen. Sowohl im Ausgangs- als auch im Zieltextfeld des Kopier- und Einfügevorgangs muss useRichTextClipboard
auf true
gesetzt sein. Der Standardwert ist false
.
Implementierung
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Beispiel ( Verwendung dieses Beispiels )
tf1
) und zwei dynamische Textfelder (tf2
und tf3
). Der Code verknüpft jedes dynamische Feld mit einem TextFormat-Objekt (Courier Bold-Schrift). Für das Textfeld tf2
ist die Eigenschaft useRichTextClipboard
auf false
gesetzt. Für das Textfeld tf3
ist die Eigenschaft useRichTextClipboard
auf true
gesetzt. Wenn Sie den Text im Textfeld tf2
kopieren und ihn in das Textfeld tf1
einfügen, enthält der eingefügte Text keine Formatierung. Wenn Sie den Text im Textfeld tf3
(für das useRichTextClipboard
auf true
gesetzt ist) kopieren und ihn in das Textfeld tf1
einfügen, enthält der eingefügte Text die Formatierung.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(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; } } }
wordWrap | Eigenschaft |
wordWrap:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird. Wenn die Eigenschaft wordWrap
auf true
gesetzt ist, findet im Textfeld ein Zeilenumbruch statt. Wenn der Wert false
ist, findet im Textfeld kein Zeilenumbruch statt. Der Standardwert ist false
.
Implementierung
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Beispiel ( Verwendung dieses Beispiels )
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 = createCustomTextField(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 = createCustomTextField(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 createCustomTextField(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; } } }
TextField | () | Konstruktor |
public function TextField()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt eine neue TextField-Instanz. Rufen Sie nach der Erstellung der TextField-Instanz die addChild()
- bzw. addChildAt()
-Methode 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.
Beispiel ( Verwendung dieses Beispiels )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | Methode |
public function appendText(newText:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ( Verwendung dieses Beispiels )
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 appendText()
-Methode 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.).
|
Rectangle — Ein Rechteck mit Mindest- und Höchstwerten für x und y , mit dem die Begrenzungsbox für das Zeichen definiert wird.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x
und y
angegebenen Punkt zurück.
Parameter
x:Number — Die x-Koordinate des Zeichens.
| |
y:Number — Die y-Koordinate des Zeichens.
|
int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einem Zeichen.
|
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Der auf null basierende Indexwert des ersten Zeichens im gleichen Absatz.
|
Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.
|
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt einen DisplayObject-Verweis für die angegebene id
zurück, bei einem Bild bzw. einer SWF-Datei, das/die einem HTML-formatierten Textfeld mit dem Tag <img>
hinzugefügt wurde. Das Tag <img>
liegt im folgenden Format vor:
<img src = 'filename.jpg' id = 'instanceName' >
Parameter
id:String — Die id , für die eine Entsprechung vorliegen muss (im Attribut id des Tags <img> ).
|
DisplayObject — Das Anzeigeobjekt, das dem Bild bzw. der SWF-Datei mit dem passenden id -Attribut im Tag <img> des Textfelds entspricht. Bei Medien von einer externen Quelle handelt es sich um ein Loader-Objekt. Sobald das Medienobjekt geladen ist, handelt es sich um ein untergeordnetes Objekt dieses Loader-Objekts. Für in die SWF-Datei eingebetteten Medien ist dies das geladene Objekt. Wenn kein <img> -Tag mit der übereinstimmenden id existiert, gibt die Methode null zurück.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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 Pixelgrenzen 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den auf null basierenden Indexwert der Zeile an dem von den Parametern x
und y
angegebenen Punkt zurück.
Parameter
x:Number — Die x-Koordinate der Zeile.
| |
y:Number — Die y-Koordinate der Zeile.
|
int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einer Zeile.
|
Beispiel ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom charIndex
-Parameter angegebene Zeichen enthält.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Der auf null basierende Indexwert der Zeile.
|
Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.
|
Beispiel ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.
Parameter
lineIndex:int — Die Nummer der Zeile, deren Länge Sie ermitteln möchten.
|
int — Die Anzahl der Zeichen in der Zeile.
|
Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.
|
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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):flash.text:TextLineMetrics
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt metrische Informationen zu einer bestimmten Textzeile zurück.
Parameter
lineIndex:int — Die Nummer der Zeile, für die Sie metrische Informationen ermitteln möchten.
|
flash.text:TextLineMetrics — Ein TextLineMetrics-Objekt.
|
Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter lineIndex
angegebenen Zeile zurück.
Parameter
lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).
|
int — Der auf null basierende Indexwert des ersten Zeichens in der Zeile.
|
Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.
|
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den Text der durch den Parameter lineIndex
angegebenen Zeile zurück.
Parameter
lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).
|
String — Der in der angegebenen Zeile enthaltene Textstring.
|
Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.
|
Beispiel ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück. Die Länge wird relativ zum ersten Zeichen im Absatz (wie von getFirstCharInParagraph()
zurückgegeben) und nicht zum vorliegenden Zeichenindex angegeben.
Parameter
charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
|
int — Gibt die Anzahl der Zeichen im Absatz zurück.
|
Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 clickHandler()
-Methode 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):flash.text:TextFormat
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter beginIndex
und endIndex
angegebenen Textbereich zurück. Nur Eigenschaften, die für den gesamten Text gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null
gesetzt.
Wenn Sie keine Werte für diese Parameter angeben, wird diese Methode auf den gesamten Text im Textfeld angewendet.
In der folgenden Tabelle sind drei Verwendungsmöglichkeiten aufgeführt:
Verwendung | Beschreibung |
---|---|
my_textField.getTextFormat() | Gibt ein TextFormat-Objekt mit den Formatierungsinformationen für den gesamten Text in einem Textfeld zurück. Nur Eigenschaften, die für den gesamten Text im Textfeld gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null gesetzt. |
my_textField.getTextFormat(beginIndex:Number) | Gibt ein TextFormat-Objekt mit einer Kopie des Textformats an der durch beginIndex gekennzeichneten Position zurück. |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den Textbereich zwischen beginIndex und endIndex-1 zurück. Nur Eigenschaften, die für den gesamten Text im angegebenen Textbereich gelten, sind im resultierenden TextFormat-Objekt eingestellt. Alle „gemischten“ Eigenschaften (mixed), die an unterschiedlichen Stellen im Textbereich unterschiedliche Werte aufweisen, besitzen den Wert null . |
Parameter
beginIndex:int (default = -1 ) — 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.
|
flash.text:TextFormat — Das TextFormat-Objekt, das die Formatierungseigenschaften des angegebenen Texts wiedergibt.
|
Auslöser
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im gültigen Bereich.
|
Verwandte API-Elemente
Beispiel
Verwendung dieses Beispiels
Bitte sehen Sie sich das Beispiel für die getFirstCharInParagraph()- oder setTextFormat()-Methode an, in dem illustriert ist, wie die
getTextFormat()
-Methode verwendet wird.
isFontCompatible | () | Methode |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Gibt „true“ zurück, wenn eine eingebettete Schriftart mit dem angegebenen fontName
und fontStyle
verfügbar ist, wobei Font.fontType
gleich flash.text.FontType.EMBEDDED
ist. Ab Flash Player 10 können zwei Arten von eingebetteten Schriftarten in einer SWF-Datei erscheinen. Normale eingebettete Schriftarten werden nur mit TextField-Objekten verwendet. CFF-Schriftarten werden nur von den flash.text.engine-Klassen verwendet. Die beiden Arten unterscheiden sich durch die fontType
-Eigenschaft der Font
-Klasse, die von der enumerateFonts()
-Funktion zurückgegeben wird.
TextField kann keine Schriftarten des Typs EMBEDDED_CFF
verwenden. Wenn embedFonts
auf true
gesetzt ist und die einzige Schriftart, die zur Laufzeit mit dem angegebenen Namen und Stil verfügbar ist, vom Typ EMBEDDED_CFF
ist, kann Flash Player den Text nicht wiedergeben (so als ob keine eingebetteten Schriftarten mit dem angegebenen Namen und Stil zur Verfügung stünden).
Wenn sowohl EMBEDDED
- als auch EMBEDDED_CFF
-Schriftarten mit dem gleichen Namen und Stil verfügbar sind, wird die EMBEDDED
-Schriftart ausgewählt und Text wird mit der EMBEDDED
-Schriftart wiedergegeben.
Parameter
fontName:String — Der Name der zu überprüfenden eingebetteten Schriftart.
| |
fontStyle:String — Legt den Schriftstil fest, der geprüft werden soll. Verwenden Sie flash.text.FontStyle
|
Boolean — true , wenn eine kompatible eingebettete Schriftart verfügbar ist, wenn nicht, dann false .
|
Auslöser
ArgumentError — Der angegebene fontStyle ist kein Mitglied von flash.text.FontStyle .
|
Verwandte API-Elemente
replaceSelectedText | () | Methode |
public function replaceSelectedText(value:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ( Verwendung dieses Beispiels )
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter beginIndex
und endIndex
) angegebenen Text als ausgewählt fest. Wenn die beiden Parameterwerte gleich sind, setzt diese Methode den Einfügepunkt (so als ob Sie die caretIndex
-Eigenschaft setzen).
Parameter
beginIndex:int — Der auf null basierende Indexwert für das erste Zeichen der Auswahl (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
| |
endIndex:int — Der auf null basierende Indexwert des letzten Zeichens in der Auswahl.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter format
angegebene Textformatierung zu. Der Wert des Parameters format
muss ein TextFormat-Objekt mit den gewünschten Änderungen bei der Textformatierung sein. Nur die Eigenschaften von format
, die nicht null lauten, werden dem Textfeld zugewiesen. Eigenschaften von format
, die auf null
gesetzt wurden, werden nicht zugewiesen. Standardmäßig sind alle Eigenschaften eines neu erstellten TextFormat-Objekts auf null
gesetzt.
Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.
Mit der Methode setTextFormat()
wird das Textformat geändert, das auf einen Zeichenbereich oder den gesamten Text in einem Textfeld angewendet wird. Geben Sie keine Werte für beginIndex
und endIndex
an, wenn die Eigenschaften des Formats auf den kompletten Text im Textfeld angewendet werden sollen. Wenn Sie die Eigenschaften des Formats auf einen Textbereich anwenden möchten, geben Sie Werte für die Parameter beginIndex
und endIndex
an. Mit der Eigenschaft length
können Sie die Indexwerte bestimmen.
Die beiden Arten von Formatierungsinformationen in einem TextFormat-Objekt sind Formatierungen auf Zeichen- und auf Absatzebene. Jedes Zeichen in einem Textfeld kann seine eigenen Zeichenformatierungseinstellungen (z. B. Schriftname, Schriftgrad, fett und kursiv) haben.
Bei Absätzen wird das erste Zeichen im Absatz auf die für den gesamten Absatz geltenden Absatzformatierungseinstellungen überprüft. Es gibt unter anderem folgende Absatzformatierungseinstellungen: linker Rand, rechter Rand und Einzug.
Jeder Text, der manuell vom Benutzer eingefügt oder durch die replaceSelectedText()
-Methode ersetzt wird, erhält die Textfeld-Standardformatierung für neuen Text und nicht die Formatierung, die für den Texteinfügepunkt angegeben ist. Um die Standardformatierung für neuen Text festzulegen, verwenden Sie defaultTextFormat
.
Parameter
format:flash.text:TextFormat — Ein TextFormat-Objekt, das sowohl Zeichen- als auch Absatzformatierungsinformationen enthält.
| |||||||||
beginIndex:int (default = -1 ) — 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.
Beachten Sie, dass manuell vom Benutzer eingefügter oder mit der |
Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.
| |
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im gültigen Bereich.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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); } } } }
change | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.CHANGE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, nachdem ein Steuerelementwert geändert wurde (im Gegensatz zum textInput
-Ereignis, das ausgelöst wird, bevor der Wert geändert 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.
Event.CHANGE
-Konstante definiert den Wert der type
-Eigenschaft eines change
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Wert geändert wurde. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Beispiel ( Verwendung dieses Beispiels )
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 das Standardtextformat wird dem 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 weiteren Text eingegeben 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 |
flash.events.TextEvent
Eigenschaft TextEvent.type =
flash.events.TextEvent.LINK
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 die Texteigenschaft des LINK-Ereignisses platziert.
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.
type
eines link
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Es 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. |
text | Der Rest der URL nach „event:“ |
Beispiel ( Verwendung dieses Beispiels )
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 href
-Attribut des HTML-Tags wird an die linkHandler()
-Methode als text
-Eigenschaft des link
-Ereignisobjekts übergeben.
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 |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.SCROLL
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Von einem TextField-Objekt ausgelöst, nachdem der Benutzer einen Bildlauf durchgeführt hat.
DieEvent.SCROLL
-Konstante definiert den Wert der type
-Eigenschaft eines scroll
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das TextField-Objekt, für das ein Bildlauf durchgeführt wurde. Die target -Eigenschaft entspricht nicht immer dem Objekt in der Anzeigeliste, das den Ereignis-Listener registriert hat. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Beispiel ( Verwendung dieses Beispiels )
mouseDown
-Ereignis ausgelöst und die verknüpfte mouseDownScroll
-Prozedur aufgerufen. Die mouseDownScroll()
-Prozedur führt dazu, dass im Feld ein Bildlauf durchgeführt wird. Danach wird das scroll
-Ereignis ausgelöst und die verknüpfte scrollHandler()
-Prozedur aktualisiert das zweite Textfeld, um die aktuelle Bildlaufposition anzuzeigen.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Ereignis |
flash.events.TextEvent
Eigenschaft TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player löst das Ereignis textInput
aus, wenn ein Benutzer ein oder mehr Textzeichen eingibt. Dieses Ereignis kann durch verschiedene Texteingabemethoden ausgelöst werden, z. B. die Standardtastatur, Eingabemethodeneditoren (Input Method Editors, IMEs), Spracherkennungssysteme oder das Einfügen von Text ohne Formatierungs- oder Stilinformationen.
type
eines textInput
-Ereignisobjekts.
Hinweis: Dieses Ereignis wird für die Entf- und Rücktaste nicht ausgelöst.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | true ; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das 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. |
text | Das bzw. die Zeichen wird/werden vom Benutzer eingegeben. |
Beispiel ( Verwendung dieses Beispiels )
textInput
-Ereignis ausgelöst, die textInputHandler()
-Prozedur aufgerufen und die Zeichen werden im zweiten Textfeld angezeigt. Wenn Sie einen Textblock in das Eingabefeld einfügen, kopiert die Ereignisprozedur den ganzen Block in das andere Feld.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Ereignis |
flash.events.Event
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Flash Player setzt das textInteractionModeChange
-Ereignis ab, wenn ein Benutzer den Interaktionsmodus eines Textfeldes ändert. Unter Android ist es zum Beispiel möglich, mithilfe von Kontextmenüoptionen zwischen dem NORMAL-Modus und dem SELECTION-Modus zu wechseln
TextFieldExample
zur Anzeige einer Textmeldung verwendet. Dies wird in den folgenden Schritten erreicht:
- Es wird eine
label
-Eigenschaft vom Typ „TextField“ erstellt. - Der Klassenkonstruktor ruft die Funktion
configureLabel()
auf. - Mit der Methode
configureLabel()
wird zuerst ein neues TextField-Objekt erstellt, das anschließend der Eigenschaftlabel
zugewiesen wird. Danach werden die Parameter wie folgt eingestellt:- Textfeld links ausrichten.
- Hintergrundfüllung aktivieren.
- Rahmen aktivieren.
- Mit der Methode
configureLabel()
wird die Variableformat
erstellt und einer neuen TextFormat-Instanz mit den folgenden Parametern zugewiesen:- Schriftart = Verdana
- Schriftfarbe = reines Rot
- Schriftgröße = 10
- Unterstreichung = true
- Die Eigenschaft
defaultTextFormat
des Textfeldslabel
ist aufformat
gesetzt, und dielabel
-Instanz wird der Anzeigeliste hinzugefügt. In dieser wird zuerst ein Textfeld ohne Text angezeigt. - Der Konstruktor setzt den Text des
label
-Textfelds auf"Hello world and welcome to the show."
fest, indem er diesetLabel()
-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); } } }
Tue Jun 12 2018, 10:04 AM Z