ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.controls.textClasses 

TextRange  - AS3 Flex

Paketmx.controls.textClasses
Klassepublic class TextRange
VererbungTextRange Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die TextRange-Klasse stellt Eigenschaften bereit, die einen Textbereich in den Steuerelementen Label, Text, TextArea, TextEditor und RichTextEditor auswählt und formatiert.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  beginIndex : int
Auf null basierende Indexposition im Textfeld des Steuerelements des ersten Zeichens im Bereich.
TextRange
  bullet : Boolean
Gibt an, ob der Text im Bereich eine Liste mit Aufzählungszeichen ist.
TextRange
  color : Object
Farbe des Texts im Bereich.
TextRange
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  endIndex : int
Auf null basierender Index im Textfeld des Steuerelements des Punktes direkt nach dem letzten Zeichen im Textbereich. Ist gleichbedeutend mit der auf eins basierenden Indexposition des letzten Zeichens.
TextRange
  fontFamily : String
Name der Schriftart für den Text im Bereich.
TextRange
  fontSize : int
Punktgröße des Texts im Bereich.
TextRange
  fontStyle : String
Stil der Schriftart im Bereich als „italic“ oder „normal“.
TextRange
  fontWeight : String
Stärke der Schriftart im Bereich als „bold“ oder „normal“.
TextRange
  htmlText : String
Inhalt des Bereichs in Form von HTML-Text.
TextRange
  kerning : Boolean
Ein boolescher Wert, der angibt, ob Kerning aktiviert (true) oder deaktiviert (false) ist.
TextRange
  letterSpacing : Number
Die Anzahl zusätzlicher Pixel, die zwischen den einzelnen Zeichen eingefügt werden sollen.
TextRange
  modifiesSelection : Boolean
[schreibgeschützt] Legt fest, ob die TextRange-Klasse den aktuell ausgewählten Text ändert.
TextRange
  owner : UIComponent
Das Steuerelement, das den Text enthält.
TextRange
  text : String
Inhalt des Bereichs im Klartext.
TextRange
  textAlign : String
Ausrichtung des Texts im Bereich.
TextRange
  textDecoration : String
Die Dekoration der Schriftart im Bereich als „underline“ oder „normal“.
TextRange
  url : String
URL für einen Hyperlink im Bereich.
TextRange
Öffentliche Methoden
 MethodeDefiniert von
  
TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)
Erstellt ein neues TextRange-Objekt, das eine Untergruppe des Inhalts eines Text-Steuerelements einschließlich Formatierungsinformationen darstellt.
TextRange
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

beginIndex

Eigenschaft
beginIndex:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Auf null basierende Indexposition im Textfeld des Steuerelements des ersten Zeichens im Bereich. Wenn das fünfte Zeichen im Text das erste Zeichen des Bereichs ist, hat diese Eigenschaft den Wert 4.



Implementierung
    public function get beginIndex():int
    public function set beginIndex(value:int):void

bullet

Eigenschaft 
bullet:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt an, ob der Text im Bereich eine Liste mit Aufzählungszeichen ist. Wenn nur ein Teil des Bereichs eine Liste mit Aufzählungszeichen ist, steht dieser Wert auf false.



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

color

Eigenschaft 
color:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Farbe des Texts im Bereich. Sie können diesen Wert mit einem gültigen Farbenbezeichner einstellen. Die Eigenschaft gibt den Wert als numerischen Wert zurück. Wenn der Bereich mehrere Farben hat, ist dieser Wert null.



Implementierung
    public function get color():Object
    public function set color(value:Object):void

endIndex

Eigenschaft 
endIndex:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Auf null basierender Index im Textfeld des Steuerelements des Punktes direkt nach dem letzten Zeichen im Textbereich. Ist gleichbedeutend mit der auf eins basierenden Indexposition des letzten Zeichens. Wenn das fünfte Zeichen im Text das letzte Zeichen des Bereichs ist, hat diese Eigenschaft den Wert 5.



Implementierung
    public function get endIndex():int
    public function set endIndex(value:int):void

fontFamily

Eigenschaft 
fontFamily:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Name der Schriftart für den Text im Bereich. Wenn der Bereich mehrere Schriftarten hat, ist dieser Wert null.



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

fontSize

Eigenschaft 
fontSize:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Punktgröße des Texts im Bereich. Wenn der Bereich mehrere Größen hat, ist dieser Wert 0.



Implementierung
    public function get fontSize():int
    public function set fontSize(value:int):void

fontStyle

Eigenschaft 
fontStyle:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stil der Schriftart im Bereich als „italic“ oder „normal“. Wenn die Eigenschaft auf einen anderen Stringwert gesetzt ist, wird der Stil „normal“ verwendet. Wenn der Bereich mehrere Stile hat, ist dieser Wert null.



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

fontWeight

Eigenschaft 
fontWeight:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stärke der Schriftart im Bereich als „bold“ oder „normal“. Wenn die Eigenschaft auf einen anderen Stringwert gesetzt ist, wird die Stärke „normal“ verwendet. Wenn der Bereich mehrere Stärken hat, ist dieser Wert null.



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

htmlText

Eigenschaft 
htmlText:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Inhalt des Bereichs in Form von HTML-Text. Diese Eigenschaft gibt alle HTML-Markupzeichen für den Bereich zurück, einschließlich des Markups für die Formatierung, das von Flex angewendet wird, nicht nur das HTML-Markup, das Sie mit einer htmlText-Eigenschaft festlegen. Diese Eigenschaft ist daher eine vollständige HTML-Darstellung des Texts, wie er im Steuerelement erscheint.



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

kerning

Eigenschaft 
kerning:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein boolescher Wert, der angibt, ob Kerning aktiviert (true) oder deaktiviert (false) ist. Der Begriff „Kerning“ bezeichnet die Anpassung der Pixel zwischen bestimmten Zeichenpaaren zur Verbesserung der Lesbarkeit. Diese Funktion sollte nur verwendet werden, wenn sie unbedingt erforderlich ist, beispielsweise bei Überschriften in großen Schriftarten. Kerning wird nur für eingebettete Schriftarten unterstützt. Bestimmte Schriftarten wie Verdana und Schriftarten mit fester Breite wie Courier New unterstützen Kerning nicht

Der Standardwert ist false.



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

letterSpacing

Eigenschaft 
letterSpacing:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Anzahl der zusätzlichen Pixel, die zwischen den Zeichen angezeigt werden. Durch einen positiven Wert wird der Zeichenabstand über den normalen Abstand hinaus vergrößert und durch einen negativen Wert verkleinert.

Der Standardwert ist 0.



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

modifiesSelection

Eigenschaft 
modifiesSelection:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Legt fest, ob die TextRange-Klasse den aktuell ausgewählten Text ändert. Vom Konstruktur eingestellt.



Implementierung
    public function get modifiesSelection():Boolean

owner

Eigenschaft 
owner:UIComponent

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Steuerelement, das den Text enthält. Das Eigentümer-Steuerelement muss über eine textField-Eigenschaft oder, bei einem RichTextEditor-Steuerelement, über eine textArea-Eigenschaft verfügen. Der Eigentümer des Texts in einem RichTextEditor-Steuerelement ist das RichTextEditor-Steuerelement, nicht sein TextArea-Substeuerelement. Ursprünglich vom Konstruktur eingestellt.



Implementierung
    public function get owner():UIComponent
    public function set owner(value:UIComponent):void

text

Eigenschaft 
text:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Inhalt des Bereichs im Klartext.



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

textAlign

Eigenschaft 
textAlign:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ausrichtung des Texts im Bereich. Die flash.text.TextFormatAlign-Konstanten legen die gültigen Werte fest. Wenn diese Eigenschaft auf einen anderen Wert gesetzt wird, hat dies keine Auswirkungen. Wenn der Bereich mehrere Ausrichtungen hat, ist dieser Wert null.



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

Verwandte API-Elemente

textDecoration

Eigenschaft 
textDecoration:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Dekoration der Schriftart im Bereich als „underline“ oder „normal“. Wenn die Eigenschaft auf einen anderen Stringwert gesetzt ist, wird normaler Text angezeigt. Wenn der Bereich mehrere Einstellungen für die Textdekoration hat, ist dieser Wert null.



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

url

Eigenschaft 
url:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

URL für einen Hyperlink im Bereich. Wenn der Bereich keinen Hyperlink enthält, ist der Wert ein leerer String. Wenn der Bereich mehrere Hyperlinks enthält, ist der Wert null.



Implementierung
    public function get url():String
    public function set url(value:String):void
Konstruktordetails

TextRange

()Konstruktor
public function TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt ein neues TextRange-Objekt, das eine Untergruppe des Inhalts eines Text-Steuerelements einschließlich Formatierungsinformationen darstellt.

Parameter
owner:UIComponent — Das Steuerelement, das den Text enthält. Das Steuerelement muss über eine textField-Eigenschaft oder, bei einem RichTextEditor-Steuerelement, über eine textArea-Eigenschaft verfügen.
 
modifiesSelection:Boolean (default = false) — Ob der Text im Texbereich ausgewählt wird. Wenn Sie diesen Parameter auf true setzen und keinen Beginn- oder Endeindex angeben, der mit Text im Steuerelement übereinstimmt, verwendet Flex den Beginn- oder Endeindex der aktuellen Textauswahl. Wenn dieser Parameter true ist, Sie die Parameter beginIndex und endIndex weglassen und keine Auswahl vorgenommen wurde, ist das TextRange-Objekt leer.
 
beginIndex:int (default = -1) — Auf null basierende Indexposition des ersten Zeichens im Bereich. Wenn der modifiesSelection-Parameter false ist und Sie diesen Parameter weglassen oder einen negativen Wert angeben, beginnt der Bereich mit dem ersten Textzeichen.
 
endIndex:int (default = -1) — Auf null basierender Index der Position nach dem letzten Zeichen im Bereich. Wenn der modifiesSelection-Parameter false ist und Sie diesen Parameter weglassen, einen negativen Wert angeben oder einen Wert nach dem Ende des Texts angeben, endet der Bereich mit dem letzten Textzeichen.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.