Korzystanie ze składnika UIScrollBar

Składnik UIScrollBar umożliwia dodawanie paska przewijania do pola tekstowego. Pasek przewijania można dodać do pola tekstowego podczas tworzenia lub w czasie wykonywania w ActionScript. Aby użyć składnika UIScrollBar, utwórz pole tekstowe na stole montażowym, a następnie przeciągnij składnik UIScrollBar z panelu Składniki do dowolnego kwadrantu w obwiedni pola tekstowego.

Jeśli długość paska przewijania jest mniejsza niż łączna długość strzałek przewijania, pasek nie będzie wyświetlany poprawnie. Jeden z przycisków strzałki zostanie ukryty za drugim. W programie Flash nie jest dostępna funkcja kontroli takiego błędu. W takim przypadku dobrym sposobem jest ukrycie paska przewijania za pomocą kodu ActionScript. Jeśli pasek przewijania ma taką wielkość, że nie wystarcza miejsca na pole przewijania, program Flash ukryje pole przewijania.

Składnik UIScrollBar działa jak każdy inny pasek przewijania. Zawiera przyciski strzałek na każdym końcu, a także ścieżkę i pole przewijania między strzałkami. Składnik można dołączyć do dowolnej krawędzi pola tekstowego i używany w poziomie lub w pionie.

Informacje na temat klasy TextField zawiera opis klasy TextField w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Posługiwanie się składnikiem UIScrollBar

Składnik UIScrollBar — w przeciwieństwie do wielu innych składników — może odbierać dane wejściowe z myszy wprowadzane w sposób ciągły, np. gdy użytkownik przytrzymuje przycisk myszy — wówczas nie występują powtarzalne kliknięcia.

Składnika UIScrollBar nie można obsługiwać za pomocą klawiatury.

Parametry składnika UIScrollBar

Dla każdej instancji składnika UIScrollBar można w Inspektorze właściwości lub w Inspektorze składników ustawić następujące parametry tworzenia treści: direction i scrollTargetName . Każdy z parametrów posiada odpowiadającą mu właściwość ActionScript o tej samej nazwie.

W kodzie ActionScript możliwe jest ustawienie dodatkowych opcji dla składnika UIScrollBar z wykorzystaniem jego klas, metod, właściwości i zdarzeń. Więcej informacji zawiera opis klasy UIScrollBar w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Tworzenie aplikacji ze składnikiem UIScrollBar

Poniższa procedura opisuje jak podczas tworzenia dodać składnik UIScrollBar do aplikacji.

  1. Utwórz nowy dokument Flash (ActionScript 3.0).

  2. Utwórz dynamiczne pole tekstowe o wysokości wystarczającej dla jednego lub dwu wierszy tekstu, a następnie nadaj instancji nazwę myText w Inspektorze właściwości.

  3. W Inspektorze właściwości ustaw dla opcji Typ wiersza pola wprowadzania tekstu wartość Wielowierszowy lub Wielowierszowy bez zawijania, jeśli planowane jest użycie paska przewijania w poziomie.

  4. Otwórz panel Operacje, wybierz Klatkę nr 1 na głównej osi czasu, a następnie wprowadź następujący kod ActionScript w celu wprowadzenia wartości do właściwości text w taki sposób, aby użytkownik musiał przewinąć w celu wyświetlenia całości: 

    myText.text="When the moon is in the seventh house and Jupiter aligns with Mars, then peace will guide the planet and love will rule the stars."
    Uwaga: Upewnij się, że pole tekstowe na stole montażowym jest dostatecznie małe, aby konieczne było jego przewijanie w celu wyświetlenia całego tekstu. Jeśli pole nie jest tak małe, pasek przewijania może być niewidoczny lub może się pojawić jako dwa wiersze bez wskaźnika (część przeciągana w celu przewijania).

  5. Upewnij się, że przyciąganie do obiektów jest włączone (Widok > Przyciąganie > Przyciągaj do obiektów).

  6. Przeciągnij instancję UIScrollBar z panelu Składniki do pola wprowadzania tekstu obok strony, do której chcesz dołączyć instancję. Podczas zwalniania przycisku myszy składnik musi nachodzić na pole tekstowe — tylko wówczas składnik będzie poprawnie powiązany z polem. Nadaj instancji nazwę mySb.

    Właściwość scrollTargetName składnika automatycznie zostanie wypełniona nazwą instancji pola tekstowego z Inspektora właściwości i Inspektora składników. Jeśli nazwa właściwości nie będzie widoczna na karcie Parametry, możliwe, że instancja składnika UIScrollBar nie nachodziła dostatecznie na pole tekstowe.

  7. Wybierz polecenie Sterowanie > Testuj film.

Tworzenie instancji składnika UIScrollBar przy użyciu kodu ActionScript

Za pomocą języka ActionScript można utworzyć instancję UIScrollBar i skojarzyć ją z polem tekstowym w czasie wykonywania. Poniższy przykład przedstawia tworzenie instancji poziomego składnika UIScrollBar oraz dołączanie go do dołu instancji pola tekstowego o nazwie myTxt — to pole jest ładowane z adresu URL. Przykład ustawia również wielkość paska przewijania zgodną z wielkością pola tekstowego:

  1. Utwórz nowy dokument Flash (ActionScript 3.0).

  2. Przeciągnij składnik ScrollBar do panelu Biblioteka.

  3. Otwórz panel Operacje, zaznacz klatkę nr 1 na głównej osi czasu i wprowadź następujący kod ActionScript: 

    import flash.net.URLLoader; 
import fl.controls.UIScrollBar; 
import flash.events.Event; 
 
var myTxt:TextField = new TextField(); 
myTxt.border = true; 
myTxt.width = 200; 
myTxt.height = 16; 
myTxt.x = 200; 
myTxt.y = 150; 
 
var mySb:UIScrollBar = new UIScrollBar(); 
mySb.direction = "horizontal"; 
// Size it to match the text field. 
mySb.setSize(myTxt.width, myTxt.height);  
 
// Move it immediately below the text field. 
mySb.move(myTxt.x, myTxt.height + myTxt.y); 
 
// put them on the Stage 
addChild(myTxt); 
addChild(mySb); 
// load text 
var loader:URLLoader = new URLLoader(); 
var request:URLRequest = new URLRequest("http://www.helpexamples.com/flash/lorem.txt"); 
loader.load(request); 
loader.addEventListener(Event.COMPLETE, loadcomplete); 
 
function loadcomplete(event:Event) { 
    // move loaded text to text field 
    myTxt.text = loader.data; 
    // Set myTxt as target for scroll bar. 
    mySb.scrollTarget = myTxt; 
}

  4. Wybierz polecenie Sterowanie > Testuj film.