ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flashx.textLayout.elements 

Configuration  - AS3

Pakietflashx.textLayout.elements
Klasapublic class Configuration
DziedziczenieConfiguration Inheritance Object
Implementuje IConfiguration

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Klasa Configuration jest podstawowym punktem integracji między specyfikacją Text Layout Framework a aplikacją. Obiekt Configuration można wprowadzić jako parametr do konstruktora TextFlow() podczas tworzenia nowej instancji TextFlow. Takie rozwiązanie umożliwia aplikacji wewnętrzne kontrolowanie działania specyfikacji Text Layout Framework.

Klasa Configuration umożliwia określanie formatów początkowych, formatów akapitów i kontenerów dla przepływu tekstu za pomocą właściwości textFlowInitialFormat. Umożliwia także określenie atrybutów początkowego formatu dla łączy, zaznaczania, przewijania oraz obsługi za pomocą klawiszy Tab i Enter.

Wyświetl przykłady

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
  defaultLinkActiveFormat : flashx.textLayout.formats:ITextLayoutFormat
Określa atrybuty aktywnego formatu znaków, które początkowo mają zastosowanie dla wszystkich łączy (obiekty LinkElement) w przepływie tekstu.
Configuration
  defaultLinkHoverFormat : flashx.textLayout.formats:ITextLayoutFormat
Określa atrybuty początkowego formatu znaków, które mają zastosowanie do łącza (LinkElement) w przepływie tekstu, gdy kursor znajdzie się nad łączem.
Configuration
  defaultLinkNormalFormat : flashx.textLayout.formats:ITextLayoutFormat
Określa początkowe atrybuty łącza dla wszystkich obiektów LinkElement w przepływie tekstu.
Configuration
  defaultListMarkerFormat : IListMarkerFormat
Określa atrybuty formatu znaków aktywnych, które początkowo są stosowane do wszystkich obiektów ListItem w przepływie tekstu.
Configuration
  enableAccessibility : Boolean
Określa, czy funkcje ułatwień dostępu są włączone, czy nie.
Configuration
  flowComposerClass : Class
Określa typ układacza przepływu, jaki jest domyślnie dołączany do nowego obiektu TextFlow.
Configuration
  focusedSelectionFormat : SelectionFormat
Początkowy format zaznaczenia (SelectionFormat) dla przepływu tekstu (TextFlow), gdy okno przepływu ma punkt skupienia.
Configuration
  inactiveSelectionFormat : SelectionFormat
Początkowy format zaznaczenia (SelectionFormat) dla przepływu tekstu (TextFlow), gdy okno przepływu jest nieaktywne.
Configuration
  inlineGraphicResolverFunction : Function
Określa funkcję wywołania zwrotnego używaną do ustalania lokalizacji lokalnego elementu graficznego.
Configuration
  manageEnterKey : Boolean
Określa, czy naciśnięcie klawisza Enter / Return jest wprowadzane jako tekst przez strukturę Text Layout Framework (na przykład w celu rozdzielenia akapitu), czy też te klawisze są obsługiwane przez kod klienta.
Configuration
  manageTabKey : Boolean
Określa, czy naciśnięcie klawisza TAB jest wprowadzane jako tekst przez architekturę Text Layout Framework, program Flash Player lub środowisko AIR obsługuje naciśnięcie, co powoduje powstanie zdarzenia panelu z kartami.
Configuration
  overflowPolicy : String
Strategia używana do podejmowania decyzji o tym, czy ostatni wiersz kontenera znajduje się jeszcze w kontenerze, czy nie mieści się w nim.
Configuration
  releaseLineCreationData : Boolean
Żąda, aby proces tworzenia układu tekstu zwalniał dane tworzenia wiersza po określeniu układów poszczególnych akapitów.
Configuration
  scrollDragDelay : Number
Określa opóźnienie czasowe między jedną operacją przewijania a kolejną taką operacją, aby zapobiec zbyt szybkiemu przewijaniu.
Configuration
  scrollDragPixels : Number
Określa domyślną liczbę pikseli do przewinięcia, gdy użytkownik zainicjuje automatyczne przewijanie poprzez przeciągnięcie zaznaczenia.
Configuration
  scrollMouseWheelMultiplier : Number
Określa domyślną liczbę pikseli do przewinięcia dla zdarzeń kółka myszy.
Configuration
  scrollPagePercentage : Number
Określa domyślny procent przepływu tekstu do przewinięcia w przypadku przewijania stron.
Configuration
  textFlowInitialFormat : flashx.textLayout.formats:ITextLayoutFormat
Określa początkową konfigurację formatu TextLayoutFormat dla przepływu tekstu (obiekt TextFlow).
Configuration
  unfocusedSelectionFormat : SelectionFormat
Początkowy format zaznaczenia, z którego korzysta specyfikacja Text Layout Framework do rysowania zaznaczenia, gdy okno jest aktywne, ale na żadnym z kontenerów w obiekcie TextFlow nie ma punktu skupienia.
Configuration
Metody publiczne
 MetodaZdefiniowane przez
  
Configuration(initializeWithDefaults:Boolean = true)
Konstruktor — tworzy domyślną konfigurację.
Configuration
  
Tworzy klon obiektu Configuration.
Configuration
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Szczegół właściwości

defaultLinkActiveFormat

właściwość
defaultLinkActiveFormat:flashx.textLayout.formats:ITextLayoutFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa atrybuty aktywnego formatu znaków, które początkowo mają zastosowanie dla wszystkich łączy (obiekty LinkElement) w przepływie tekstu. Istnieją wartości domyślne dla nowych obiektów LinkElement, które nie określają wartości dla tych atrybutów.

Wartość domyślna to null.



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

Powiązane elementy interfejsu API

defaultLinkHoverFormat

właściwość 
defaultLinkHoverFormat:flashx.textLayout.formats:ITextLayoutFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa atrybuty początkowego formatu znaków, które mają zastosowanie do łącza (LinkElement) w przepływie tekstu, gdy kursor znajdzie się nad łączem. Istnieją wartości domyślne dla nowych obiektów LinkElement, które nie określają wartości dla tych atrybutów.

Wartość domyślna to null.



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

Powiązane elementy interfejsu API

defaultLinkNormalFormat

właściwość 
defaultLinkNormalFormat:flashx.textLayout.formats:ITextLayoutFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa początkowe atrybuty łącza dla wszystkich obiektów LinkElement w przepływie tekstu. Są to wartości domyślne dla nowych obiektów LinkElement, które nie określają wartości dla tych atrybutów. Domyślny, zwykły format wyświetlania łącza w kolorze niebieskim z podkreśleniem.



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

Powiązane elementy interfejsu API

defaultListMarkerFormat

właściwość 
defaultListMarkerFormat:IListMarkerFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa atrybuty formatu znaków aktywnych, które początkowo są stosowane do wszystkich obiektów ListItem w przepływie tekstu. Są to wartości domyślne dla nowych obiektów ListItemElement, które nie określają wartości dla tych atrybutów.

Wartość domyślna to null.



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

Powiązane elementy interfejsu API

enableAccessibility

właściwość 
enableAccessibility:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa, czy funkcje ułatwień dostępu są włączone, czy nie. W przypadku wartości true czytniki ekranu mogą odczytać zawartość przepływu TextFlow.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

flowComposerClass

właściwość 
flowComposerClass:Class

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa typ układacza przepływu, jaki jest domyślnie dołączany do nowego obiektu TextFlow. Wartością domyślną jest StandardFlowComposer.



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

Powiązane elementy interfejsu API

focusedSelectionFormat

właściwość 
focusedSelectionFormat:SelectionFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Początkowy format zaznaczenia (SelectionFormat) dla przepływu tekstu (TextFlow), gdy okno przepływu ma punkt skupienia. Specyfikacja Text Layout Framework wykorzystuje format focusedSelectionFormat w celu rysowania zaznaczenia, gdy okno jest aktywne, a na jednym z kontenerów w obiekcie TextFlow znajduje się punkt skupienia. Ten format można w razie potrzeby przesłonić za pomocą klasy SelectionManager.focusedSelectionFormat.

Klasa SelectionFormat określa wartości domyślne, które powodują odwrócenie koloru tekstu i jego tła.



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

Powiązane elementy interfejsu API

inactiveSelectionFormat

właściwość 
inactiveSelectionFormat:SelectionFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Początkowy format zaznaczenia (SelectionFormat) dla przepływu tekstu (TextFlow), gdy okno przepływu jest nieaktywne. Specyfikacja Text Layout Framework wykorzystuje format inactiveSelectionFormat do rysowania zaznaczenia, gdy okno jest zaznaczone. Ten format można w razie potrzeby przesłonić za pomocą klasy SelectionManager.inactiveSelectionFormat.

Jeśli format unfocusedSelectionFormat nie zostanie przesłonięty, zostaną użyte następujące wartości SelectionFormat:

  • color = 0xffffff (biały)
  • alpha = 0
  • blendMode = flash.display.BlendMode.DIFFERENCE

Rezultatem jest brak wyświetlania zaznaczenia.



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

Powiązane elementy interfejsu API

inlineGraphicResolverFunction

właściwość 
inlineGraphicResolverFunction:Function

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa funkcję wywołania zwrotnego używaną do ustalania lokalizacji lokalnego elementu graficznego. W wywołaniu zwrotnym jako argument przekazywany jest obiekt flashx.textLayout.elements.InlineGraphicElement i zwracana jest wartość, która ma być używana jako źródło flashx.textLayout.elements.InlineGraphicElement#source dla elementu. Ta funkcja wywołania zwrotnego realizuje mechanizm opóźniający udostępnienie źródła elementu graficznego do momentu bezpośrednio poprzedzającego umieszczenie tego elementu w układzie.

Uwaga: Wywołanie zwrotne następuje pod warunkiem, że ustawione jest już źródło elementu zastępczego typu String. Ponadto wywołanie zwrotne może następować wielokrotnie.



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

Powiązane elementy interfejsu API

manageEnterKey

właściwość 
manageEnterKey:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa, czy naciśnięcie klawisza Enter / Return jest wprowadzane jako tekst przez strukturę Text Layout Framework (na przykład w celu rozdzielenia akapitu), czy też te klawisze są obsługiwane przez kod klienta. Kod klienta może obsługiwać naciśnięcie takiego klawisza na przykład poprzez zatwierdzenie formularza, który zawiera dla tego celu domyślny przycisk.

Wartością domyślną jest true.



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

manageTabKey

właściwość 
manageTabKey:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa, czy naciśnięcie klawisza TAB jest wprowadzane jako tekst przez strukturę Text Layout Framework, czy program Flash Player (lub AIR) obsługuje naciśnięcie, co powoduje powstanie zdarzenia panelu z kartami.

Wartością domyślną jest false.



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

overflowPolicy

właściwość 
overflowPolicy:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Strategia używana do podejmowania decyzji o tym, czy ostatni wiersz kontenera znajduje się jeszcze w kontenerze, czy nie mieści się w nim. W celu ustawienia tej właściwości należy użyć stałych z klasy OverflowPolicy.

Wartością domyślną jest klasa OverflowPolicy.FIT_DESCENDERS, która powoduje dopasowanie wiersza do obszaru określania układu, pod warunkiem że możliwe jest dopasowanie obszaru od góry do dołu.



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

Powiązane elementy interfejsu API

releaseLineCreationData

właściwość 
releaseLineCreationData:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Żąda, aby proces tworzenia układu tekstu zwalniał dane tworzenia wiersza po określeniu układów poszczególnych akapitów. To żądanie oszczędza pamięć, ale spowalnia proces określania układu.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

scrollDragDelay

właściwość 
scrollDragDelay:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa opóźnienie czasowe między jedną operacją przewijania a kolejną taką operacją, aby zapobiec zbyt szybkiemu przewijaniu. Ta wartość określa, że opóźnienie jest wyrażone w milisekundach. Wartością domyślną jest 35.



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

scrollDragPixels

właściwość 
scrollDragPixels:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa domyślną liczbę pikseli do przewinięcia, gdy użytkownik zainicjuje automatyczne przewijanie poprzez przeciągnięcie zaznaczenia. Wartość domyślna to 20.



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

scrollMouseWheelMultiplier

właściwość 
scrollMouseWheelMultiplier:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa domyślną liczbę pikseli do przewinięcia dla zdarzeń kółka myszy. Wartość domyślna to 20.



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

scrollPagePercentage

właściwość 
scrollPagePercentage:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa domyślny procent przepływu tekstu do przewinięcia w przypadku przewijania stron. Wartością domyślną jest 7,0 / 8,0 lub 0,875.



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

textFlowInitialFormat

właściwość 
textFlowInitialFormat:flashx.textLayout.formats:ITextLayoutFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Określa początkową konfigurację formatu TextLayoutFormat dla przepływu tekstu (obiekt TextFlow).

Wartość domyślna to null.



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

Powiązane elementy interfejsu API

unfocusedSelectionFormat

właściwość 
unfocusedSelectionFormat:SelectionFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Początkowy format zaznaczenia, z którego korzysta specyfikacja Text Layout Framework do rysowania zaznaczenia, gdy okno jest aktywne, ale na żadnym z kontenerów w obiekcie TextFlow nie ma punktu skupienia. Ten format można w razie potrzeby przesłonić za pomocą klasy SelectionManager.unfocusedSelectionFormat.

Jeśli format unfocusedSelectionFormat nie zostanie przesłonięty, zostaną użyte następujące wartości SelectionFormat:

  • color = 0xffffff (biały)
  • alpha = 0
  • blendMode = flash.display.BlendMode.DIFFERENCE

Rezultatem jest brak wyświetlania zaznaczenia.



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

Powiązane elementy interfejsu API

Konstruktor Szczegół

Configuration

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Konstruktor — tworzy konfigurację domyślną.

Parametry
initializeWithDefaults:Boolean (default = true) — Określa, czy w konfiguracji zostaną zainicjowane wartości domyślne. Wartością domyślną jest true. Jeśli ustawiona jest wartość false, wartości domyślne nie są inicjowane, co powoduje zapisanie tylko niektórych obiektów Metoda clone() ustawia wartość false i kopiuje właściwości z oryginalnego obiektu.

Powiązane elementy interfejsu API

Szczegół metody

clone

()metoda
public function clone():Configuration

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Tworzy klon obiektu Configuration.

Zwraca
Configuration
Szczegół stałej

hasTouchScreen

Stała
tlf_internal static const hasTouchScreen:Boolean

ConfigurationExample.as

W tym przykładzie przedstawiono tworzenie początkowej konfiguracji formatu, która jest stosowana do obiektu TextFlow, jaki składa się z akapitu i łącza.
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 ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.