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...
flashx.textLayout.elements 

Configuration  - AS3

Paketflashx.textLayout.elements
Klassepublic class Configuration
VererbungConfiguration Inheritance Object
Implementiert IConfiguration

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Configuration-Klasse ist eine primäre Integrationsmöglichkeit zwischen dem Text Layout Framework und einer Anwendung. Sie können ein Configuration-Objekt bei der Erstellung einer neuen TextFlow-Instanz als Parameter dem TextFlow()-Konstruktor hinzufügen. Dadurch kann die Anwendung zunächst steuern, wie sich das Text Layout Framework verhält.

Mithilfe der Configuration-Klasse können Sie Ausgangs-, Absatz- und Containerformate für den Textfluss mithilfe der textFlowInitialFormat-Eigenschaft festlegen. Außerdem können Sie anfängliche Formatattribute für Hyperlinks, Auswahl, Bildlauf und Verwendung der Tabulator- und Eingabetaste festlegen.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  defaultLinkActiveFormat : flashx.textLayout.formats:ITextLayoutFormat
Legt die aktiven Zeichenformatattribute fest, die normalerweise auf alle Hyperlinks (LinkElement-Objekte) im Textfluss angewendet werden.
Configuration
  defaultLinkHoverFormat : flashx.textLayout.formats:ITextLayoutFormat
Legt die ursprünglichen Zeichenformatattribute fest, die auf einen Hyperlink (LinkElement-Objekte) im Textfluss angewendet werden, wenn die Maus sich darüber befindet.
Configuration
  defaultLinkNormalFormat : flashx.textLayout.formats:ITextLayoutFormat
Legt die ursprünglichen Hyperlinkattribute für alle LinkElement-Objekte im Textfluss fest.
Configuration
  defaultListMarkerFormat : IListMarkerFormat
Gibt die aktiven Zeichenformatattribute an, die anfänglich auf alle ListItems im Textfluss angewendet werden.
Configuration
  enableAccessibility : Boolean
Legt fest, ob Eingabehilfen zur Barrierefreiheit aktiviert sind.
Configuration
  flowComposerClass : Class
Gibt den Typ des Flow-Composers an, der standardmäßig einem neuen TextFlow-Objekt angehängt werden soll.
Configuration
  focusedSelectionFormat : SelectionFormat
Das ursprüngliche Auswahlformat (SelectionFormat) für einen Textfluss (TextFlow), wenn das dazugehörige Fenster den Fokus hat.
Configuration
  inactiveSelectionFormat : SelectionFormat
Das ursprüngliche Auswahlformat (SelectionFormat) für einen Textfluss (TextFlow), wenn sein Fenster nicht aktiv ist.
Configuration
  inlineGraphicResolverFunction : Function
Legt den Rückruf fest, der für die Auflösung eines Inline-Grafikelements verwendet wird.
Configuration
  manageEnterKey : Boolean
Legt fest, ob die Eingabetaste als Text über Text Layout Framework eingegeben wird, um z. B. einen Absatz aufzuteilen, oder die Verarbeitung über den Clientcode erfolgt.
Configuration
  manageTabKey : Boolean
Legt fest, ob die Tabulatortaste als Text über Text Layout Framework eingegeben wird oder die Verarbeitung über den Flash Player oder AIR erfolgt und die Tasteneingabe in ein Bedienfeldereignis mit Registerkarten umgewandelt wird.
Configuration
  overflowPolicy : String
Richtlinie, mit der entschieden wird, ob die letzte Zeile eines Containers in den Container passen oder über diesen hinausreichen soll.
Configuration
  releaseLineCreationData : Boolean
Erfordert, dass der Vorgang der Textzusammenstellung nach der Zusammenstellung jedes Absatzes Zeilenerstellungsdaten freigibt.
Configuration
  scrollDragDelay : Number
Gibt eine Zeitverzögerung zwischen Bildläufen an, um einen zu schnellen Bildlauf zu verhindern.
Configuration
  scrollDragPixels : Number
Legt die Standardpixelanzahl für einen Bildlauf fest, wenn der Benutzer durch Ziehen der Auswahl einen automatischen Bildlauf initiiert.
Configuration
  scrollMouseWheelMultiplier : Number
Legt die Standardpixelanzahl für einen Bildlauf bei Mausradereignissen fest.
Configuration
  scrollPagePercentage : Number
Legt den Standardprozentsatz des Textflusses für den Bildlauf durch Seiten fest.
Configuration
  textFlowInitialFormat : flashx.textLayout.formats:ITextLayoutFormat
Legt die TextLayoutFormat-Konfiguration zur anfänglichen Formatierung eines Textflusses fest (TextFlow-Objekt).
Configuration
  unfocusedSelectionFormat : SelectionFormat
Das ursprüngliche Auswahlformat, das Text Layout Framework verwendet, um die Auswahl zu zeichnen, wenn das Fenster aktiv ist, aber keiner der Container im TextFlow einen Fokus hat.
Configuration
Öffentliche Methoden
 MethodeDefiniert von
  
Configuration(initializeWithDefaults:Boolean = true)
Konstruktor - erstellt eine Standardkonfiguration.
Configuration
  
Erstellt einen Klon des Configuration-Objekts.
Configuration
 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

defaultLinkActiveFormat

Eigenschaft
defaultLinkActiveFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die aktiven Zeichenformatattribute fest, die normalerweise auf alle Hyperlinks (LinkElement-Objekte) im Textfluss angewendet werden. Dies sind Standardwerte für neue LinkElement-Objekte, die keine Werte für diese Attribute festlegen.

Der Standardwert ist null.



Implementierung
    public function get defaultLinkActiveFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set defaultLinkActiveFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Verwandte API-Elemente

defaultLinkHoverFormat

Eigenschaft 
defaultLinkHoverFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die ursprünglichen Zeichenformatattribute fest, die auf einen Hyperlink (LinkElement-Objekte) im Textfluss angewendet werden, wenn die Maus sich darüber befindet. Dies sind Standardwerte für neue LinkElement-Objekte, die keine Werte für diese Attribute festlegen.

Der Standardwert ist null.



Implementierung
    public function get defaultLinkHoverFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set defaultLinkHoverFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Verwandte API-Elemente

defaultLinkNormalFormat

Eigenschaft 
defaultLinkNormalFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die ursprünglichen Hyperlinkattribute für alle LinkElement-Objekte im Textfluss fest. Dies sind Standardwerte für neue LinkElement-Objekte, die keine Werte für diese Attribute festlegen. Das normale Standardformat zeigt den Hyperlink in Blau mit Unterstreichung an.



Implementierung
    public function get defaultLinkNormalFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set defaultLinkNormalFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Verwandte API-Elemente

defaultListMarkerFormat

Eigenschaft 
defaultListMarkerFormat:IListMarkerFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt die aktiven Zeichenformatattribute an, die anfänglich auf alle ListItems im Textfluss angewendet werden. Dies sind Standardwerte für neue ListItemElements-Objekte, die keine Werte für diese Attribute festlegen.

Der Standardwert ist null.



Implementierung
    public function get defaultListMarkerFormat():IListMarkerFormat
    public function set defaultListMarkerFormat(value:IListMarkerFormat):void

Verwandte API-Elemente

enableAccessibility

Eigenschaft 
enableAccessibility:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt fest, ob Eingabehilfen zur Barrierefreiheit aktiviert sind. Ist der Wert true, kann der TextFlow-Inhalt von Bildschirmleseprogrammen gelesen werden.

Der Standardwert ist false



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

Verwandte API-Elemente

flowComposerClass

Eigenschaft 
flowComposerClass:Class

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt den Typ des Flow-Composers an, der standardmäßig einem neuen TextFlow-Objekt angehängt werden soll. Der Standardwert ist „StandardFlowComposer“.



Implementierung
    public function get flowComposerClass():Class
    public function set flowComposerClass(value:Class):void

Verwandte API-Elemente

focusedSelectionFormat

Eigenschaft 
focusedSelectionFormat:SelectionFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das ursprüngliche Auswahlformat (SelectionFormat) für einen Textfluss (TextFlow), wenn das dazugehörige Fenster den Fokus hat. Text Layout Framework verwendet focusedSelectionFormat, um die Auswahl zu zeichnen, wenn das Fenster aktiv ist und einer der Container im TextFlow den Fokus hat. Sie können dieses Format gegebenenfalls mithilfe von SelectionManager.focusedSelectionFormat überschreiben.

Die SelectionFormat-Klasse legt die Standardwerte fest, die die Textfarbe und den Texthintergrund umkehren.



Implementierung
    public function get focusedSelectionFormat():SelectionFormat
    public function set focusedSelectionFormat(value:SelectionFormat):void

Verwandte API-Elemente

inactiveSelectionFormat

Eigenschaft 
inactiveSelectionFormat:SelectionFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das ursprüngliche Auswahlformat (SelectionFormat) für einen Textfluss (TextFlow), wenn sein Fenster nicht aktiv ist. Text Layout Framework verwendet inactiveSelectionFormat, um die Auswahl zu zeichnen, wenn das Fenster nicht aktiv ist. Sie können dieses Format gegebenenfalls mithilfe von SelectionManager.inactiveSelectionFormat überschreiben.

Wenn Sie unfocusedSelectionFormat nicht überschreiben, sind die für SelectionFormat verwendeten Werte:

  • color = 0xffffff (weiß)
  • alpha = 0
  • blendMode = flash.display.BlendMode.DIFFERENCE

Als Ergebnis wird keine Auswahl angezeigt.



Implementierung
    public function get inactiveSelectionFormat():SelectionFormat
    public function set inactiveSelectionFormat(value:SelectionFormat):void

Verwandte API-Elemente

inlineGraphicResolverFunction

Eigenschaft 
inlineGraphicResolverFunction:Function

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt den Rückruf an, der zum Auflösen eines Inline-Grafikelements verwendet wird. Der Rückruf verwendet ein flashx.textLayout.elements.InlineGraphicElement-Objekt und gibt den als flashx.textLayout.elements.InlineGraphicElement#source des Elements zu verwendenden Wert zurück. Dieser Rückruf bietet den Verzögerungsmechanismus, indem die Quelle eines Inline-Grafikelements kurz vor der Zusammenstellung zur Verfügung gestellt wird.

Hinweis: Dieser Rückruf wird nur aufgerufen, wenn eine Platzhalterquelle des Typs String bereits festgelegt ist. Außerdem kann er mehrmals aufgerufen werden.



Implementierung
    public function get inlineGraphicResolverFunction():Function
    public function set inlineGraphicResolverFunction(value:Function):void

Verwandte API-Elemente

manageEnterKey

Eigenschaft 
manageEnterKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt fest, ob die Eingabetaste als Text über Text Layout Framework eingegeben wird, um z. B. einen Absatz aufzuteilen, oder die Verarbeitung über den Clientcode erfolgt. Der Client-Code verarbeitet dies möglicherweise, indem z. B. ein Formular übernommen wird, das eine Standardschaltfläche für diesen Zweck enthält.

Der Standardwert ist true.



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

manageTabKey

Eigenschaft 
manageTabKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt fest, ob die Tabulatortaste als Text über Text Layout Framework eingegeben wird oder die Verarbeitung über den Flash Player oder AIR erfolgt und die Tasteneingabe in ein Bedienfeldereignis mit Registerkarten umgewandelt wird.

Der Standardwert ist false



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

overflowPolicy

Eigenschaft 
overflowPolicy:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Richtlinie, mit der entschieden wird, ob die letzte Zeile eines Containers in den Container passen oder über diesen hinausreichen soll. Verwenden Sie die Konstanten der OverflowPolicy-Klasse, um diese Eigenschaft festzulegen.

Der Standardwert ist OverflowPolicy.FIT_DESCENDERS. Dabei wird die Zeile in den Satzbereich eingepasst, wenn auch der Bereich vom oberen Ende bis zur Grundlinie hineinpasst.



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

Verwandte API-Elemente

releaseLineCreationData

Eigenschaft 
releaseLineCreationData:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erfordert, dass der Vorgang der Textzusammenstellung nach der Zusammenstellung jedes Absatzes Zeilenerstellungsdaten freigibt. Durch diese Anforderung wird weniger Speicher benötigt, aber der Zusammenstellungsvorgang wird verlangsamt.

Der Standardwert ist false



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

Verwandte API-Elemente

scrollDragDelay

Eigenschaft 
scrollDragDelay:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt eine Zeitverzögerung zwischen Bildläufen an, um einen zu schnellen Bildlauf zu verhindern. Dieser Wert legt die Verzögerung in Millisekunden fest. Der Standardwert ist 35.



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

scrollDragPixels

Eigenschaft 
scrollDragPixels:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die Standardpixelanzahl für einen Bildlauf fest, wenn der Benutzer durch Ziehen der Auswahl einen automatischen Bildlauf initiiert. Der Standardwert ist 20.



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

scrollMouseWheelMultiplier

Eigenschaft 
scrollMouseWheelMultiplier:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die Standardpixelanzahl für einen Bildlauf bei Mausradereignissen fest. Der Standardwert ist 20.



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

scrollPagePercentage

Eigenschaft 
scrollPagePercentage:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt den Standardprozentsatz des Textflusses für den Bildlauf durch Seiten fest. Der Standardwert ist 7,0 / 8,0 oder ,875.



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

textFlowInitialFormat

Eigenschaft 
textFlowInitialFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt die TextLayoutFormat-Konfiguration zur anfänglichen Formatierung eines Textflusses fest (TextFlow-Objekt).

Der Standardwert ist null.



Implementierung
    public function get textFlowInitialFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set textFlowInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Verwandte API-Elemente

unfocusedSelectionFormat

Eigenschaft 
unfocusedSelectionFormat:SelectionFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das ursprüngliche Auswahlformat, das Text Layout Framework verwendet, um die Auswahl zu zeichnen, wenn das Fenster aktiv ist, aber keiner der Container im TextFlow einen Fokus hat. Sie können dieses Format überschreiben, wenn Sie SelectionManager.unfocusedSelectionFormat verwenden, falls erforderlich.

Wenn Sie unfocusedSelectionFormat nicht überschreiben, sind die für SelectionFormat verwendeten Werte:

  • color = 0xffffff (weiß)
  • alpha = 0
  • blendMode = flash.display.BlendMode.DIFFERENCE

Als Ergebnis wird keine Auswahl angezeigt.



Implementierung
    public function get unfocusedSelectionFormat():SelectionFormat
    public function set unfocusedSelectionFormat(value:SelectionFormat):void

Verwandte API-Elemente

Konstruktordetails

Configuration

()Konstruktor
public function Configuration(initializeWithDefaults:Boolean = true)

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor - erstellt eine Standardkonfiguration.

Parameter
initializeWithDefaults:Boolean (default = true) — Legt fest, ob die Konfiguration mit den Standardwerten initialisiert wird. Der Standardwert lautet true. Wenn false festgelegt wird, erfolgt die Initialisierung ohne Standardwerte, wodurch einige Objekte gespeichert werden. Die clone()-Methode legt hierfür false fest und kopiert die Eigenschaften aus dem ursprünglichen Objekt.

Verwandte API-Elemente

Methodendetails

clone

()Methode
public function clone():Configuration

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt einen Klon des Configuration-Objekts.

Rückgabewerte
Configuration
Konstantendetails

hasTouchScreen

Konstante
tlf_internal static const hasTouchScreen:Boolean

ConfigurationExample.as

In diesem Beispiel wird eine anfängliche Formatierungskonfiguration erstellt, die auf einen TextFlow angewendet wird, der aus einem Absatz und einem Hyperlink besteht.
package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    import flash.text.engine.FontPosture;
    import flash.text.engine.Kerning;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.edit.SelectionFormat;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.Configuration;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextAlign;
    import flashx.textLayout.formats.TextDecoration;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ConfigurationExample extends Sprite
    {
        public function ConfigurationExample()
        {    
            //create container for the text and add to stage
            var textContainer:Sprite = new Sprite();
            textContainer.x = 50;
            textContainer.y = 20;
            this.stage.addChild( textContainer );
            
            // create Configuration, set properties for it and add to TextFlow
            var config:Configuration = new Configuration();
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 16;
            textLayoutFormat.kerning = Kerning.ON;
            textLayoutFormat.fontStyle = FontPosture.ITALIC;
            textLayoutFormat.textAlign = TextAlign.CENTER;
            config.textFlowInitialFormat = textLayoutFormat;
            var linkNormalFormat:TextLayoutFormat = new TextLayoutFormat();
            // make links red and underlined
            linkNormalFormat.color = 0xFF0000;
            linkNormalFormat.textDecoration = TextDecoration.UNDERLINE;
            config.defaultLinkNormalFormat = linkNormalFormat;
            // set selection color to light blue
              var selectionFormat:SelectionFormat = new SelectionFormat(0x333300);
              config.focusedSelectionFormat = selectionFormat;
            var textFlow:TextFlow = new TextFlow(config);
            // make text selectable
            var selectionManager:SelectionManager = new SelectionManager();
            textFlow.interactionManager = selectionManager;
            
            // create paragraph, a span of text, and a link
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            var linkSpan:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            link.href = "http://www.adobe.com";
            linkSpan.text = "Adobe's website";
            link.addChild(linkSpan);
            span.text = "The best place to go for information about Adobe products is: ";
            
            // Add span and link to paragraph; add paragraph to TextFlow
            p.addChild(span);
            p.addChild(link);
            textFlow.addChild(p);
            
            // Add a controller for the container; specify container width and height
            textFlow.flowComposer.addController(new ContainerController(textContainer, 80, 300));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}




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