StandardFlowComposer  - AS3

Jeśli układacz przepływu wykonuje aktualnie operację określania układu, wartością jest true.

Liczba kontenerów przypisanych do wystąpienia klasy IFlowComposer.

Element główny skojarzony z wystąpieniem klasy IFlowComposer.

Tylko obiekt TextFlow może być elementem głównym.

Tworzy obiekt StandardFlowComposer.

W celu użycia obiektu StandardFlowComposer należy przypisać go do właściwości flowComposer obiektu TextFlow. Należy wywołać metodę updateAllControllers() w celu zdefiniowania układu i wyświetlenia tekstu w kontenerach dołączonych do układacza przepływu.

package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.compose.StandardFlowComposer;

    public class StandardFlowComposer_constructor
    {
        public function createComposer(textFlow:TextFlow):void
        {
             textFlow.flowComposer = new StandardFlowComposer();
        }
    }
}

Dodaje kontroler do danej instancji klasy IFlowComposer.

Kontener dodany do końca listy kontenera.

Parametry

package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_addController
    {
        import flash.display.Sprite;
        import flashx.textLayout.elements.TextFlow;
        import flashx.textLayout.container.ContainerController;
        
        public function setupController(textFlow:TextFlow):void
        {
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            textFlow.flowComposer.addController( controller );
        }
    }
}

Dodaje kontroler do danego wystąpienia klasy IFlowComposer w określonym indeksie.

Elementy listy kontrolerów są numerowane od 0 (pierwszy kontroler ma indeks 0).

Parametry

package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_addControllerAt
    {
        import flash.display.Sprite;
        import flashx.textLayout.elements.TextFlow;
        import flashx.textLayout.container.ContainerController;
        
        public function setupController(textFlow:TextFlow):void
        {
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            textFlow.flowComposer.addControllerAt( controller, 0 );
        }
    }
}

Oblicza, ile wierszy jest wymaganych do wyświetlenia zawartości w elemencie głównym przepływu, a także położenia tych wierszy w kontenerach wyświetlania przepływu.

Metoda compose() układa treść tylko wówczas, gdy została ona zmieniona od czasu ostatniej operacji określania układu. Wyniki są zapisywane, dzięki czemu kolejne wywołania metody compose() lub updateAllControllers() nie wykonują dodatkowych operacji określania układu, jeśli treść przepływu nie uległa zmianie.

Jeśli zawartość kontenera uległa zmianie, metoda zwraca wartość true.

Powiązane elementy interfejsu API

package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_compose
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.compose();
        }
    }
}

Układa zawartość głównego elementu aż do kontenera (włącznie) w określonym indeksie.

Jeśli treść jakiegokolwiek kontenera — łącznie z kontenerem w określonym indeksie — uległa zmianie, metoda zwraca true. Jeśli wartość index jest większa od liczby kontrolerów (lub nie jest określona), wówczas układana jest treść wszystkich kontenerów.

Parametry

package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_composeToController
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.composeToController( 3 );
        }
    }
}

Układa zawartość elementu głównego aż do określonego położenia.

Jeśli treść jakiegokolwiek kontenera — łącznie z kontenerem zawierającym indeks w określonym położeniu — uległa zmianie, metoda zwraca true. Jeśli wartość absolutePosition jest większa od długości przepływu (obiektu TextFlow) lub nie jest określona, wówczas układana jest treść całego kontenera.

Parametry

package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_composeToPosition
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.composeToPosition( 344 );
        }
    }
}

Zwraca indeks kontrolera zawierającego treść w określonym położeniu.

Położenie może być traktowane jako mniejsze przedziały między dwoma znakami lub innymi elementami przepływu tekstu. Jeśli wartość absolutePosition jest położeniem między ostatnim znakiem w jednym kontenerze a pierwszym znakiem w następnym kontenerze, wówczas poprzedzający kontener zostanie zwrócony, jeśli parametr preferPrevious zostanie ustawiony na true, a kolejny kontener zostanie zwrócony, jeśli dla parametru preferPrevious zostanie ustawiona wartość false.

Metoda zwraca -1, jeśli treść w określonym położeniu nie jest zawarta w żadnym kontenerze lub znajduje się poza zakresem położenia w przepływie tekstu.

Parametry

package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.compose.StandardFlowComposer;
    
    public class StandardFlowComposer_findControllerIndexAtPosition
    {
        public function findControllerIndexAtPosition(textFlow:TextFlow):void
        {
            var index:int = textFlow.flowComposer.findControllerIndexAtPosition( 344 );
        }
    }
}

Zwraca bezwzględne położenie pierwszego elementu zawartości w określonym obiekcie ContainerController.

Położenie jest obliczane poprzez zliczanie odstępu między dwoma znakami lub innymi elementami przepływu tekstu. Położenie poprzedzające pierwszy element przepływu jest równe zero. Położenie bezwzględne jest położeniem zliczanym od początku przepływu.

Parametry

Zwraca obiekt ContainerController w określonym indeksie.

Parametry

package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.container.ContainerController;
    
    public class StandardFlowComposer_getControllerAt
    {
        public function findControllerIndexAtPosition(textFlow:TextFlow):void
        {
            var controller:ContainerController =  textFlow.flowComposer.getControllerAt( 0 );
        }
    }
}

Zwraca indeks określonego obiektu ContainerController.

Parametry

package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.container.ContainerController;
    
    public class StandardFlowComposer_getControllerIndex
    {
        public function getControllerIndex(textFlow:TextFlow, controller:ContainerController):void
        {
            var index:int =  textFlow.flowComposer.getControllerIndex( controller );
        }
    }
}

Wywoływana przez TextFlow w przypadku zmiany menedżera interakcji.

Ta funkcja jest wywoływana automatycznie. Kod nie musi koniecznie wywoływać tej metody. Klasy, które rozszerzają układacza StandardFlowComposer, mogą przesłaniać tę metodę w celu aktualizowania detektorów zdarzeń oraz innych właściwości zależnych od menedżera interakcji.

Parametry

Zwraca true, jeśli określenie układu jest wymagane — w przeciwnym wypadku zwraca false

Usuwa wszystkie kontrolery z danej instancji klasy IFlowComposer.

Usuwa kontroler z danej instancji klasy IFlowComposer.

Parametry

Usuwa kontroler w określonym indeksie z danego wystąpienia klasy IFlowComposer.

Parametry

Ustawia punkt skupienia na kontener, który zawiera położenie określone przez parametr absolutePosition.

Obiekt StandardFlowComposer wywołuje metodę setFocus() obiektu ContainerController zawierającego określone położenie przepływu tekstu.

Parametry

Powiązane elementy interfejsu API

Parametry

Układa treść elementu głównego i aktualizuje obraz na ekranie.

Układ tekstu jest tworzony w dwóch fazach: określanie układu i wyświetlanie. W fazie określania układu układacz przepływu oblicza liczbę wierszy wymaganych do wyświetlenia treści, a także położenie tych wierszy w kontenerach wyświetlania przepływu. W fazie wyświetlania układacz przepływu aktualizuje elementy potomne obiektu ekranowego z jego kontenerów. Metoda updateAllControllers() inicjuje kolejno obydwie fazy. Układacz StandardFlowComposer śledzi zmiany treści, dzięki czemu pełny cykl określania układu i wyświetlania jest wykonywany tylko w razie potrzeby.

Ta metoda natychmiast i synchronicznie aktualizuje wszystkie wiersze tekstu i oraz listę wyświetlania.

Jeśli zawartość któregokolwiek kontenera uległa zmianie, metoda zwraca wartość true.

Układa i aktualizuje zawartość wyświetlaną aż do kontenera (i włącznie z nim) w określonym indeksie.

Metoda updateToController() układa treść i aktualizuje treść wyświetlaną wszystkich kontenerów aż do kontenera (wraz z nim) w określonym indeksie. Na przykład: jeśli istnieje łańcuch 20 kontenerów i określony zostanie indeks 10, wówczas metoda updateToController() spowoduje, że kontenery od pierwszego do dziesiątego (indeksy 0-9) zostaną ułożone i wyświetlone. Po wykonaniu tej operacji proces określania układu zakończy się. Jeśli indeks controllerIndex ma wartość -1 (nieokreślony), wówczas wszystkie kontenery zostaną zaktualizowane.

Ta metoda natychmiast i synchronicznie aktualizuje wszystkie wiersze tekstu i oraz listę wyświetlania.

Jeśli zawartość któregokolwiek kontenera uległa zmianie, metoda zwraca wartość true.

Parametry