UITextFormat

Paket	mx.core
Klasse	public class UITextFormat
Vererbung	UITextFormat TextFormat Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die UITextFormat-Klasse repräsentiert Zeichenformatierungsinformationen für die UITextField-Klasse. Die UITextField-Klasse definiert die von vielen zusammengesetzten Flex-Komponenten zum Anzeigen von Text verwendete Komponente.

Die UITextFormat-Klasse erweitert die flash.text.TextFormat-Klasse, um die measureText()- und measureHTMLText()-Methode für die Messung des Texts und Eigenschaften für die Steuerung des erweiterten Anti-Aliasing von Schriftarten hinzuzufügen.

Verwandte API-Elemente

mx.core.UITextField

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		align : String Gibt die Ausrichtung des Absatzes an.	TextFormat
		antiAliasType : String Definiert die Anti-Aliasing-Einstellung für die UITextField-Klasse.	UITextFormat
		blockIndent : Object Gibt den Blockeinzug in Pixeln an.	TextFormat
		bold : Object Gibt an, ob der Text fett formatiert wird.	TextFormat
		bullet : Object Gibt an, dass der Text Bestandteil einer Aufzählung ist.	TextFormat
		color : Object Gibt die Textfarbe an.	TextFormat
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		direction : String Die Laufrichtung des Texts.	UITextFormat
		font : String Ein String mit dem Namen der Schriftart für Text in diesem Textformat.	TextFormat
		gridFitType : String Definiert die Rasteranpassungseinstellung für die UITextField-Klasse.	UITextFormat
		indent : Object Gibt den Einzug vom linken Rand bis zum ersten Zeichen im Absatz an.	TextFormat
		italic : Object Gibt an, ob Text in diesem Textformat kursiv formatiert wird.	TextFormat
		kerning : Object Ein boolescher Wert, der angibt, ob Kerning aktiviert (true) oder deaktiviert (false) ist.	TextFormat
		leading : Object Eine Ganzzahl, die den Abstand zwischen den Zeilen (leading) angibt.	TextFormat
		leftMargin : Object Der linke Rand des Absatzes in Pixel.	TextFormat
		letterSpacing : Object Eine Zahl für den insgesamt verfügbaren Platz, der gleichmäßig zwischen den Zeichen aufgeteilt wird.	TextFormat
		locale : String Das Gebietsschema für den Text.	UITextFormat
		moduleFactory : IFlexModuleFactory Die zum Erstellen von TextFields für eingebettete Schriftarten verwendete moduleFactory.	UITextFormat
		rightMargin : Object Der rechte Rand des Absatzes in Pixel.	TextFormat
		sharpness : Number Definiert die Schärfeeinstellung für die UITextField-Klasse.	UITextFormat
		size : Object Die Größe des Texts in diesem Textformat in Pixeln.	TextFormat
		tabStops : Array Gibt benutzerdefinierte Tabstopps als Array aus nicht negativen Ganzzahlen an.	TextFormat
		target : String Gibt das Zielfenster an, in dem der Hyperlink angezeigt werden soll.	TextFormat
		thickness : Number Definiert die Stärkeeinstellung für die UITextField-Klasse.	UITextFormat
		underline : Object Gibt an, ob der Text mit diesem Textformat unterstrichen ist (true) oder nicht (false).	TextFormat
		url : String Gibt die Ziel-URL für den Text in diesem Textformat an.	TextFormat
		useFTE : Boolean = false Bestimmt, wie die measureText()- und die measureHTMLText()-Methode bei der Messung des Texts vorgehen.	UITextFormat

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		UITextFormat(systemManager:ISystemManager, font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null) Konstruktor.	UITextFormat
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		measureHTMLText(htmlText:String, roundUp:Boolean = true):flash.text:TextLineMetrics Gibt Abmessungsinformationen für den angegebenen HTML-Text zurück, welche HTML-Tags wie etwa „<font>“ und „<b>“ enthalten können. Dabei wird davon ausgegangen, dass diese Informationen in einem einzeiligen UITextField angezeigt werden und dieses UITextFormat-Objekt zum Definieren des Textformats verwendet wird.	UITextFormat
		measureText(text:String, roundUp:Boolean = true):flash.text:TextLineMetrics Gibt Abmessungsinformationen für den angegebenen Text zurück. Dabei wird davon ausgegangen, dass diese Informationen in einem einzeiligen UITextField angezeigt werden und dieses UITextFormat-Objekt zum Definieren des Textformats verwendet wird.	UITextFormat
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftendetails

antiAliasType

Eigenschaft

public var antiAliasType:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Definiert die Anti-Aliasing-Einstellung für die UITextField-Klasse. Die möglichen Werte sind "normal" (flash.text.AntiAliasType.NORMAL) und "advanced" (flash.text.AntiAliasType.ADVANCED).

Der Standardwert ist "advanced", wodurch ein Anti-Aliasing für die eingebettete Schriftart aktiviert wird. Stellen Sie diese Eigenschaft auf "normal" ein, um das erweiterte Anti-Aliasing zu deaktivieren.

Diese Eigenschaft hat keine Auswirkungen für Systemschriftarten.

Diese Eigenschaft wird auf den gesamten Text in einem UITextField-Objekt angewendet. Es ist nicht möglich, ihn selektiv auf einzelne Zeichen anzuwenden.

Der Standardwert ist "advanced".

Verwandte API-Elemente

flash.text.AntiAliasType

direction

Eigenschaft

public var direction:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die Laufrichtung des Texts.

Zulässige Werte sind "ltr" für den von links nach rechts verlaufenden Text lateinischer Schriften und "rtl" für den von rechts nach links laufenden Text z. B. des Arabischen oder Hebräischen.

FTE und TLF verwenden diesen Wert in ihrem bidirektionalen Textlayoutalgorithmus, der die Unicode-Zeichenfolge der Glyphenfolge zuordnet.

Hinweis: Dieser Stil gilt nur, wenn dieses UITextFormat bei einem UIFTETextField (und nicht bei einem UITextField) verwendet wird.

Der Standardwert ist null.

gridFitType

Eigenschaft

public var gridFitType:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Definiert die Rasteranpassungseinstellung für die UITextField-Klasse. Die möglichen Werte sind "none" (flash.text.GridFitType.NONE), "pixel" (flash.text.GridFitType.PIXEL) und "subpixel" (flash.text.GridFitType.SUBPIXEL).

Diese Eigenschaft kommt nur zur Anwendung, wenn Sie eine eingebettete Schriftart verwenden und die fontAntiAliasType-Eigenschaft auf „advanced“ eingestellt ist.

Diese Eigenschaft hat keine Auswirkungen für Systemschriftarten.

Diese Eigenschaft wird auf den gesamten Text in einem UITextField-Objekt angewendet. Es ist nicht möglich, ihn selektiv auf einzelne Zeichen anzuwenden.

Der Standardwert ist "pixel".

Verwandte API-Elemente

flash.text.GridFitType

locale

Eigenschaft

public var locale:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Das Gebietsschema für den Text.

FTE und TLF verwenden dieses Gebietsschema für die Zuordnung von Unicode-Schriftarten zu Schriftartglyphen und für die Suche nach Ausweichschriftarten.

Hinweis: Dieser Stil gilt nur, wenn dieses UITextFormat bei einem UIFTETextField (und nicht bei einem UITextField) verwendet wird.

Der Standardwert ist null.

moduleFactory

Eigenschaft

moduleFactory:IFlexModuleFactory

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die zum Erstellen von TextFields für eingebettete Schriftarten verwendete moduleFactory.

Implementierung
public function get moduleFactory():IFlexModuleFactory
public function set moduleFactory(value:IFlexModuleFactory):void

sharpness

Eigenschaft

public var sharpness:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Definiert die Schärfeeinstellung für die UITextField-Klasse. Diese Eigenschaft gibt die Schärfe der Glyphenkanten an. Die möglichen Werte sind Zahlen von -400 bis 400.

Diese Eigenschaft kommt nur zur Anwendung, wenn Sie eine eingebettete Schriftart verwenden und die fontAntiAliasType-Eigenschaft auf „advanced“ eingestellt ist.

Diese Eigenschaft hat keine Auswirkungen für Systemschriftarten.

Diese Eigenschaft wird auf den gesamten Text in einem UITextField-Objekt angewendet. Es ist nicht möglich, ihn selektiv auf einzelne Zeichen anzuwenden.

Der Standardwert ist 0.

Verwandte API-Elemente

flash.text.TextField

thickness

Eigenschaft

public var thickness:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Definiert die Stärkeeinstellung für die UITextField-Klasse. Diese Eigenschaft gibt die Stärke der Glyphenkanten an. Die möglichen Werte sind Zahlen von -200 bis 200.

Diese Eigenschaft kommt nur zur Anwendung, wenn Sie eine eingebettete Schriftart verwenden und die fontAntiAliasType-Eigenschaft auf „advanced“ eingestellt ist.

Diese Eigenschaft hat keine Auswirkungen für Systemschriftarten.

Diese Eigenschaft wird auf den gesamten Text in einem UITextField-Objekt angewendet. Es ist nicht möglich, ihn selektiv auf einzelne Zeichen anzuwenden.

Der Standardwert ist 0.

Verwandte API-Elemente

flash.text.TextField

useFTE

Eigenschaft

public var useFTE:Boolean = false

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, wie die measureText()- und die measureHTMLText()-Methode bei der Messung des Texts vorgehen.

Ist der Wert hierfür true, verwenden sie eine nicht auf dem Bildschirm angezeigte Instanz der FTETextField-Klasse im Text Layout Framework. Ist der Wert false, verwenden sie eine nicht auf dem Bildschirm angezeigte Instanz der TextField-Klasse im Flash Player.

Der Standardwert ist false.

Konstruktordetails

()

Konstruktor

public function UITextFormat(systemManager:ISystemManager, font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

	`systemManager:ISystemManager` — Ein SystemManager-Objekt. Der SystemManager verfolgt, welche Schriftarten eingebettet sind. Normalerweise ist dies der von der `systemManager`-Eigenschaft der UIComponent übergebene SystemManager.

	`font:String` (default = `null`) — Ein String, der den Namen einer Schriftart angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`size:Object` (default = `null`) — Eine Zahl, die eine Schriftgröße in Pixeln angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`color:Object` (default = `null`) — Eine vorzeichenlose Ganzzahl, die die RGB-Farbe des Texts angibt, wie etwa 0xFF0000 für rot, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`bold:Object` (default = `null`) — Ein boolesches Flag, das angibt, ob der Text fett ist, oder `null` um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`italic:Object` (default = `null`) — Ein boolesches Flag, das angibt, ob der Text kursiv ist, oder `null` um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`underline:Object` (default = `null`) — Ein boolesches Flag, das angibt, ob der Text unterstrichen ist, oder `null` um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`url:String` (default = `null`) — Ein String, der die URL angibt, mit der der Text über Hyperlink verknüpft ist, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`target:String` (default = `null`) — Ein String, der das Zielfenster angibt, in dem die über Hyperlink verknüpfte URL angezeigt wird. Ist das Zielfenster `null` oder ein leerer String, wird die über Hyperlink verknüpfte Seite im selben Browserfenster angezeigt. Ist der `urlString`-Parameter `null` oder ein leerer String, hat diese Eigenschaft keine Auswirkungen. Dieser Parameter ist optional und hat den Standardwert `null`.

	`align:String` (default = `null`) — Ein String, der die Ausrichtung des Absatzes als einen flash.text.TextFormatAlign-Wert angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`leftMargin:Object` (default = `null`) — Eine Zahl, die den linken Rand des Absatzes in Pixeln angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`rightMargin:Object` (default = `null`) — Eine Zahl, die den rechten Rand des Absatzes in Pixeln angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`indent:Object` (default = `null`) — Eine Zahl, die die Einrückung vom linken Rand bis zum ersten Zeichen des Absatzes in Pixeln angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

	`leading:Object` (default = `null`) — Eine Zahl, die den zusätzlichen vertikalen Abstand zwischen Zeilen angibt, oder `null`, um anzugeben, dass dieses UITextFormat-Objekt diese Eigenschaft nicht festlegt. Dieser Parameter ist optional und hat den Standardwert `null`.

Verwandte API-Elemente

flash.text.TextFormatAlign

Methodendetails

measureHTMLText

()

Methode

public function measureHTMLText(htmlText:String, roundUp:Boolean = true):flash.text:TextLineMetrics

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt Abmessungsinformationen für den angegebenen HTML-Text zurück, welche HTML-Tags wie etwa <font> und <b> enthalten können. Dabei wird davon ausgegangen, dass diese Informationen in einem einzeiligen UITextField angezeigt werden und dieses UITextFormat-Objekt zum Definieren des Textformats verwendet wird.

Parameter

	`htmlText:String` — Ein String, der den zu messenden HTML-Text angibt.

	`roundUp:Boolean` (default = `true`) — Ein boolesches Flag, das angibt, ob die gemessene Breite und Höhe auf die jeweils nächste Ganzzahl gerundet werden soll. In den meisten Fällen ist es empfehlenswert, zu runden.

Rückgabewerte

flash.text:TextLineMetrics — Ein TextLineMetrics-Objekt mit den Textabmessungen.

Verwandte API-Elemente

flash.text.TextLineMetrics

measureText

()

Methode

public function measureText(text:String, roundUp:Boolean = true):flash.text:TextLineMetrics

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt Abmessungsinformationen für den angegebenen Text zurück. Dabei wird davon ausgegangen, dass diese Informationen in einem einzeiligen UITextField angezeigt werden und dieses UITextFormat-Objekt zum Definieren des Textformats verwendet wird.

Parameter

	`text:String` — Ein String, der den zu messenden Text angibt.

	`roundUp:Boolean` (default = `true`) — Ein boolesches Flag, das angibt, ob die gemessene Breite und Höhe auf die jeweils nächste Ganzzahl gerundet werden soll. In den meisten Fällen ist es empfehlenswert, zu runden.

Rückgabewerte

flash.text:TextLineMetrics — Ein TextLineMetrics-Objekt mit den Textabmessungen.

Verwandte API-Elemente

flash.text.TextLineMetrics

Rechtliche Hinweise | Onlinedatenschutzerklärung

UITextFormat - AS3 Flex

Klassen x

antiAliasType

direction

gridFitType

locale

moduleFactory

sharpness

thickness

useFTE

UITextFormat

measureHTMLText

measureText