TLFTextField  - AS3 Flash

Wenn sich das Textfeld bei der Einstellung true nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in Hellblau. Wenn sich das Textfeld bei Einstellung false nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld nicht.

Beispiel:

		package 
		{
		    import flash.display.Sprite;
		    import fl.text.TLFTextField;
		    import flash.text.TextFieldType;
		
    	    public class TLFTextField_alwaysShowSelection extends Sprite 
		    {
		
		        public function TLFTextField_alwaysShowSelection() 
		        {
		            var label1:TLFTextField = createTLFTextField(0, 20, 200, 20);
		            label1.text = "This text is selected.";
		            label1.setSelection(0, 9);
		            label1.alwaysShowSelection = true;
		
		            var label2:TLFTextField = createTLFTextField(0, 50, 200, 20);
		            label2.text = "Drag to select some of this text.";
		        }
		
		        private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
		        {
		            var result:TLFTextField = new TLFTextField();
		            result.x = x; 
		            result.y = y;
		            result.width = width; 
		            result.height = height;
		            addChild(result);
		            return result;
		        }
		    }
		}
		

Der Standardwert ist false.

Verwandte API-Elemente

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

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

Der Standardwert ist flash.text.AntiAliasType.NORMAL.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

Legt den Alpha-Wert des Textfeldhintergrunds fest. Der Alpha-Hintergrund kann auf einen beliebigen Wert zwischen 0 (unsichtbar) und 1 (durchgehend) gesetzt werden. Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Hintergrund verwendet wird. Der Alpha-Effekt ist jedoch nur dann sichtbar, wenn die Eigenschaft background des Textfelds true ist.

Der Standardwert ist 1.0.

Verwandte API-Elemente

Gibt die Hintergrundfarbe des Textfelds an. 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.

Der Standardwert ist 0xFFFFFF (white).

Verwandte API-Elemente

Gibt eine vertikale oder horizontale Abfolge der Zeilenplatzierung an. Zeilen werden entweder von oben nach unten (BlockProgression.TB für horizontalen Text) oder von rechts nach links (BlockProgression.RL für vertikalen Text) platziert.

Zulässige Werte sind flashx.textLayout.formats.BlockProgression.RL, flashx.textLayout.formats.BlockProgression.TB, flashx.textLayout.formats.FormatValue.INHERIT.

Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. Wenn bei keinem der übergeordneten Elemente diese Eigenschaft festgelegt ist, wird der Wert TB verwendet.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

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.

Verwandte API-Elemente

Legt den Alpha-Wert des Rahmens fest. Der Alpha-Wert des Rahmens kann auf einen beliebigen Wert zwischen 0 (unsichtbar) und 1 (durchgehend) gesetzt werden. Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Rahmen verwendet wird. Der Alpha-Effekt ist jedoch nur dann sichtbar, wenn die Eigenschaft border des Textfelds true ist.

Der Standardwert ist 1.0.

Verwandte API-Elemente

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.

Verwandte API-Elemente

Legt die Breite des Rahmens fest. Die Breite des Rahmens kann auf einen beliebigen Wert zwischen 1 und 100 gesetzt werden. Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Rahmen verwendet wird. Die Breite ist jedoch nur dann sichtbar, wenn die Eigenschaft border des Textfelds true lautet.

Die Breite des Rahmens wird beim Berechnen der Breite oder Höhe des Textfelds berücksichtigt. Um die Breite oder Höhe des Textcontainers ohne Rahmen zu erhalten, ziehen Sie zweimal den Wert von borderWidth vom Wert für die Breite (width) oder Höhe (height) ab.

Beispiel: txtHeight = tlf.height - (2 tlf.borderwidth);.

Der Standardwert ist 1.

Verwandte API-Elemente

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 scrollV-Eigenschaft ist der auf 1 basierende Index der obersten sichtbaren Zeile im Fenster und bottomScroll ist die letzte sichtbare Zeile im Fenster.

Der gesamte Text zwischen den durch scrollV und bottomScrollV begrenzten Zeilen ist zurzeit im Textfeld sichtbar.

Verwandte API-Elemente

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

Beispiel:

		package 
		{
			import flash.display.Sprite;
			import flash.events.MouseEvent;
			import fl.text.TLFTextField;
			import flash.text.TextFieldType;
		
			public class TLFTextField_caretIndex extends Sprite 
			{
				public function TLFTextField_caretIndex() 
				{
					var tlf:TLFTextField = createTLFTextField(10, 10, 100, 100);
					tlf.wordWrap = true;
					tlf.type = TextFieldType.INPUT;
					tlf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
					tlf.addEventListener(MouseEvent.CLICK, printCursorPosition);
				}
		
				private function printCursorPosition(event:MouseEvent):void 
				{
					var tlf:TLFTextField = TLFTextField(event.currentTarget);
					trace("caretIndex:", tlf.caretIndex);
					trace("selectionBeginIndex:", tlf.selectionBeginIndex);
					trace("selectionEndIndex:", tlf.selectionEndIndex);
				}
		
				private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
				{
					var result:TLFTextField = new TLFTextField();
					result.x = x;
					result.y = y;
					result.width = width;
					result.height = height;
					addChild(result);
					return result;
				}
			}
		}		 
		

Verwandte API-Elemente

Anzahl der Textspalten (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Die Spaltenzahl überschreibt die anderen Spalteneinstellungen. Als Wert ist eine ganze Zahl oder FormatValue.AUTO festgelegt, falls nicht angegeben. Wenn columnCount nicht festgelegt ist, wird columnWidth dazu verwendet, so viele Spalten zu erstellen, wie in den Container passen.

Zulässige Werte als String sind flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT sowie Ganzzahlen von 1 bis 50.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert AUTO an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Gibt den Zwischenraum in Pixeln an, der zwischen den Spalten gelassen werden soll (übernimmt Standardwert, wenn während der Kaskade nicht definiert).

Zulässige Werte sind Zahlen von 0 bis 1000 und flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert 20 an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Spaltenbreite in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Wenn Sie die Breite, aber nicht die Anzahl der Spalten festlegen, erstellt TextLayout so viele Spalten dieser Breite wie möglich, wobei die Containerbreite und die columnGap-Einstellungen zugrunde gelegt werden. Der restliche Raum befindet sich links nach der letzten Spalte. Der Wert ist eine Zahl.

Zulässige Werte als String sind flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT und Zahlen von 0 bis 8000.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert AUTO an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text oder TLF-Markup entfernt werden sollen. Der Standardwert ist false. Die Eigenschaft condenseWhite betrifft nur TLF-Markup oder 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 standardmäßige HTML-Tags wie <br> und <p>, um in das Textfeld Zeilenumbrüche einzufügen.

Legen Sie die condenseWhite-Eigenschaft fest, bevor Sie die htmlText-Eigenschaft oder die tlfMarkup-Eigenschaft festlegen.

Das folgende Beispiel zeigt, wie mit der condenseWhite-Eigenschaft überflüssiger Leerraum aus tlfMarkup-Inhalt entfernt werden kann:

		 import fl.text.TLFTextField;
		 
		 var my_tlf:TLFTextField = new TLFTextField();
		 my_tlf.autoSize = 'left';
		 
		 // This line removes white space from tlfMarkup
		 my_tlf.condenseWhite = true;
		 
		 addChild(my_tlf);
		 
		 var my_markup:String =   '<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">'
		 					+ '	<p>'
		 					+ '		<span>Here is the first span.</span>'
		 					+ ' 	       \n'
		 					+ '		<span>And here is the second span.</span>'
		 					+ '	</p>'
		 					+ '</TextFlow>';
		 					
		 my_tlf.tlfMarkup = my_markup;
		 

Der Standardwert ist false.

Verwandte API-Elemente

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.

Verwandte API-Elemente

Gibt die standardmäßige bidirektionale Einbettungsstufe des Texts im Textblock an. Lesereihenfolge von links nach rechts wie in lateinischen Skripten oder von rechts nach links (Arabisch, Hebräisch). Diese Eigenschaft wirkt sich auf die Spaltenanordnung aus, wenn sie auf der Containerebene angewendet wird. Spalten können ebenso wie Text von links nach rechts oder von rechts nach links ausgerichtet sein. Im Folgenden sind einige Beispiele aufgeführt:

Zulässige Werte sind flashx.textLayout.formats.Direction.LTR, flashx.textLayout.formats.Direction.RTL, flashx.textLayout.formats.FormatValue.INHERIT.

Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. Wenn bei keinem der übergeordneten Elemente diese Eigenschaft festgelegt ist, wird der Wert LTR verwendet.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

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.

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 die SWF-Datei eingebettet ist, wird der Text in einer Ersatzschriftart angezeigt.

Der Standardwert ist false.

Verwandte API-Elemente

Gibt die Grundlinienposition der ersten Linie im Container an. Auf welche Grundlinie diese Eigenschaft verweist, hängt vom Gebietsschema auf Containerebene ab. Für Japanisch und Chinesisch ist es TextBaseline.IDEOGRAPHIC_BOTTOM, für alle anderen Sprachen ist es TextBaseline.ROMAN. Der Offset vom oberen Versatz (oder dem rechten Einzug, wenn für blockProgression RL eingestellt wurde) des Containers zur Grundlinie der ersten Zeile kann BaselineOffset.ASCENT, d. h. gleich der Oberlänge der Zeile (BaselineOffset.LINE_HEIGHT) sein und damit der Höhe dieser ersten Zeile entsprechen oder eine beliebige Zahl mit einem Festwert für einen absoluten Abstand sein. BaselineOffset.AUTO richtet die Oberlänge der Zeile am oberen Versatz des Containers aus.

Zulässige Werte: flashx.textLayout.formats.BaselineOffset.AUTO, flashx.textLayout.formats.BaselineOffset.ASCENT, flashx.textLayout.formats.BaselineOffset.LINE_HEIGHT, flashx.textLayout.formats.FormatValue.INHERIT und Zahlen von 0 bis 1000.

Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. Wenn bei keinem der übergeordneten Elemente diese Eigenschaft festgelegt ist, wird der Wert AUTO verwendet.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

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:

Der Standardwert ist flash.text.GridFitType.PIXEL.

Verwandte API-Elemente

Enthält die HTML-Darstellung des Inhalts des Textfelds.

TLFTextField-Instanzen unterstützen die folgenden HTML-Tags:

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

Verwandte API-Elemente

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

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.

Der maximale Wert der Eigenschaft scrollH.

Verwandte API-Elemente

Der maximale Wert der Eigenschaft scrollV.

Verwandte API-Elemente

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

Der Standardwert ist true.

Gibt an, ob es sich um ein mehrzeiliges Textfeld handelt. 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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

Unterer Versatz in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Raum zwischen der unteren Containerkante und dem Text. Der Wert ist eine Zahl.

Bei horizontalem Text in bildlauffähigen Containern mit mehreren Spalten wird in der ersten und den folgenden Spalten der Textabstand als Leerraum unten im Container angezeigt. Bei der letzten Spalte müssen Sie möglicherweise einen Bildlauf durchführen, um den Abstand zu sehen, wenn der gesamte Text nicht in die Spalte passt.

Zulässige Werte sind Zahlen von 0 bis 1000 und flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert 0 an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Linker Einzug in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Raum zwischen der linken Containerkante und dem Text. Der Wert ist eine Zahl.

Bei vertikalem Text in bildlauffähigen Containern mit mehreren Spalten wird in der ersten und den folgenden Spalten der Textabstand als Leerraum am Ende des Containers angezeigt. Bei der letzten Spalte müssen Sie möglicherweise einen Bildlauf durchführen, um den Abstand zu sehen, wenn der gesamte Text nicht in die Spalte passt.

Zulässige Werte sind Zahlen von 0 bis 1000 und flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert 0 an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Rechter Einzug in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Raum zwischen der rechten Containerkante und dem Text. Der Wert ist eine Zahl.

Zulässige Werte sind Zahlen von 0 bis 1000 und flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert 0 an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Oberer Versatz in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Raum zwischen der oberen Containerkante und dem Text. Der Wert ist eine Zahl.

Zulässige Werte sind Zahlen von 0 bis 1000 und flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert 0 an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente

Ruft das Zeichen ab, das zum Verbergen von Zeichen in einem Kennwortblock verwendet wird, bzw. legt dieses fest.

Der maximale Wert von pixelScrollV. Die Einheit von pixelMaxScrollV sind Pixel, anders als bei der maxScrollV-Eigenschaft, die zeilenbasiert ist.

Die vertikale Position von Text in einem Textfeld, angegeben in Pixel, anders als bei scrollV, was zeilenbasiert ist. Die pixelScrollV-Eigenschaft ist hilfreich für den glatten Bildlauf eines textField zu einer bestimmten Position.

Verwandte API-Elemente

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.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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. Anders als klassische dynamische Textfelder oder Eingabetextfelder ist ein TLF-Textfeld immer auswählbar, wenn es bearbeitet werden kann. Wenn diese Eigenschaft auf „false“ gesetzt ist und der Eingabetyp dynamisch ist, kann der Benutzer den Text im Feld nicht auswählen.

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.

Der Standardwert ist true.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

Bildschärfe ist auf TLF-Textfelder nicht anwendbar. Jeder ggf. angegebene Wert wird ignoriert und es wird immer null zurückgegeben.

Stylesheets für TLF-TextField.

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.

Verwandte API-Elemente

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

Verwenden Sie diese Eigenschaft, um Formatierung aus den TLF-Klassen in den flashx-Paketen auf die TLFTextField-Instanz anzuwenden. Beispiel:

		 var myFormat:TextLayoutFormat = new TextLayoutFormat();
		 myFormat.textIndent = 8;
		 myFormat.color = 0x336633;
		 myFormat.fontFamily = "Arial, Helvetica, _sans";
		 myFormat.fontSize = 24;
		 
		 var myTextFlow:TextFlow = myTLFTextField.textFlow;
		 myTextFlow.hostFormat = myFormat;
		 

Verwandte API-Elemente

Die Höhe des Texts in Pixel. Der obere und untere Abstand zum Rahmen ist in diesem Wert nicht enthalten.

Verwandte API-Elemente

Die Breite des Texts in Pixel. Der rechte und linke Abstand zum Rahmen ist in diesem Wert nicht enthalten.

Verwandte API-Elemente

Die thickness-Eigenschaft wird auf das TLF-Textfeld nicht angewendet. Jeder ggf. angegebene Wert wird ignoriert und es wird immer null zurückgegeben.

Legt das TLF-Markup des Texts im TLF-Textfeld fest bzw. ruft dieses ab.

Die Markup-Spezifikation ist unter http://sourceforge.net/projects/tlf.adobe/files/docs/TLF_2.0_specification.pdf/download veröffentlicht.

Verwandte API-Elemente

Der Typ des Textfelds. Eine der folgenden TextFieldType-Konstanten: TextFieldType.DYNAMIC zur Angabe eines auswählbaren TLF-Textfelds, das nicht von den Benutzern bearbeitet werden kann, oder TextFieldType.INPUT zur Angabe eines bearbeitbaren TLF-Textfelds, das von den Benutzern bearbeitet werden kann.

Der Standardwert ist dynamic.

Verwandte API-Elemente

Gibt an, ob die Textformatierung mit dem Text in die Zwischenablage kopiert werden soll. Bei dem Wert true kopiert Flash Player die Formatierung (zum Beispiel Ausrichtung, Fett- und Kursivschrift) im tlfMarkup-Format in die Zwischenablage.

Der Standardwert ist false.

Verwandte API-Elemente

Vertikale Ausrichtung oder Blocksatz (übernimmt Standardwert, wenn während der Kaskade nicht definiert). Bestimmt, wie TextFlow-Elemente innerhalb des Containers ausgerichtet werden.

Zulässige Werte sind flashx.textLayout.formats.VerticalAlign.TOP, flashx.textLayout.formats.VerticalAlign.MIDDLE, flashx.textLayout.formats.VerticalAlign.BOTTOM, flashx.textLayout.formats.VerticalAlign.JUSTIFY, flashx.textLayout.formats.FormatValue.INHERIT.

Wenn diese Eigenschaft während einer Kaskade nicht definiert ist, nimmt sie den Wert TOP an.

Der Standardwert ist undefined (indicates not set).

Verwandte API-Elemente