Korzystanie ze składnika NumericStepper

Składnik NumericStepper umożliwia użytkownikowi przechodzenie przez uporządkowany zestaw liczb. Składnik zawiera liczbę w polu tekstowym, która jest widoczna obok małych przycisków strzałek w górę i w dół. Po naciśnięciu przycisku liczba jest krokowo zwiększana lub zmniejszana — w zależności od jednostki określonej w parametrze stepSize — dopóki użytkownik nie zwolni przycisku lub do osiągnięcia wartości maksymalnej albo minimalnej. Tekst znajdujący się w polu tekstowym składnika NumericStepper również jest dostępny do edycji.

Podgląd aktywny każdej instancji NumericStepper odzwierciedla ustawienie parametru wartości w Inspektorze właściwości oraz Inspektorze składników. W podglądzie aktywnym nie istnieje jednak żadna zależność między użyciem myszy lub klawisza na klawiaturze z przyciskami strzałek składnika NumericStepper.

Posługiwanie się składnikiem NumericStepper

Składnik NumericStepper może być używany wszędzie tam, gdzie użytkownik ma wybrać wartość liczbową. Na przykład: składnik NumericStepper może być używany w formie umożliwiającej wybór miesiąca, dnia i roku daty ważności karty kredytowej. Składnik NumericStepper może również służyć do zwiększania lub zmniejszania wielkości czcionek.

Składnik NumericStepper obsługuje wyłącznie dane liczbowe. Podczas tworzenia wymagane jest powiększenie składnika Stepper, gdy liczba widocznych miejsc liczbowych ma być większa niż dwa (na przykład: liczby 5246 lub 1,34).

W aplikacji można włączyć lub wyłączyć składnik NumericStepper. W stanie disabled składnik NumericStepper nie odbiera danych wprowadzanych za pomocą klawiatury lub myszy. W stanie enabled składnik NumericStepper staje się aktywny po jego kliknięciu lub wybraniu za pomocą klawisza Tab, a w środku składnika aktywne staje się pole tekstowe. Po aktywowaniu instancji NumericStepper można nią sterować za pomocą następujących klawiszy:

Klucz

Opis

Strzałka w dół

Zmiana wartości o jedną jednostkę.

Strzałka w lewo

Przesunięcie punktu wprowadzania w lewo w polu tekstowym.

Strzałka w prawo

Przesunięcie punktu wprowadzania w prawo w polu tekstowym.

Shift+Tab

Przesuwa aktywność do poprzedniego obiektu.

Karta

Przesuwa aktywność do kolejnego obiektu.

Strzałka w górę

Zmiana wartości o jedną jednostkę.

Więcej informacji na temat sterowania aktywnością zawiera opis klasy FocusManager w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional oraz w sekcji Praca z klasą FocusManager .

Parametry składnika NumericStepper

Dla każdej instancji składnika NumericStepper można w Inspektorze właściwości lub w Inspektorze składników ustawić następujące parametry tworzenia treści: maximum , minimum , stepSize i value . Dla każdego z tych parametrów istnieje odpowiednia właściwość ActionScript o takiej samej nazwie. Więcej informacji na temat możliwych wartości tych parametrów zawiera opis klasy NumericStepper w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Tworzenie aplikacji ze składnikiem NumericStepper

Poniższa procedura wyjaśnia jak podczas tworzenia dodać składnik NumericStepper do aplikacji. Przykład przedstawia umieszczenie składnika NumericStepper i składnika Label na stole montażowym oraz utworzenie detektora dla zdarzenia Event .Zdarzenie CHANGE w instancji NumericStepper. Gdy wartość składnika NumericStepper zostanie zmieniona, w przykładzie pojawi się nowa wartość we właściwości text instancji Label.

  1. Przeciągnij składnik NumericStepper z panelu Składniki na stół montażowy.

  2. W Inspektorze właściwości wprowadź dla instancji nazwę aNs .

  3. Przeciągnij składnik Label z panelu Składniki na stół montażowy.

  4. W Inspektorze właściwości wprowadź dla instancji nazwę aLabel .

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

    import flash.events.Event; 
 
aLabel.text = "value = " + aNs.value; 
 
aNs.addEventListener(Event.CHANGE, changeHandler); 
function changeHandler(event:Event) :void { 
    aLabel.text = "value = " + event.target.value; 
};

    W tym przykładzie właściwość text etykiety (Label) otrzymuje wartość składnika NumericStepper. Funkcja changeHandler() aktualizuje właściwość text etykiety przy każdej zmianie wartości instancji NumericStepper.

  6. Wybierz polecenie Sterowanie > Testuj film.

Tworzenie składnika NumericStepper przy użyciu języka ActionScript:

W tym przykładzie przedstawiono tworzenie trzech składników NumericStepper za pomocą kodu ActionScript — poszczególne składniki służą do wprowadzania miesiąca, dnia i roku daty urodzenia użytkownika. W przykładzie dodawane są również składniki Label dla monitu oraz dla identyfikatorów poszczególnych składników NumericStepper.

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

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

  3. Przeciągnij składnik NumericStepper do panelu Biblioteka.

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

    import fl.controls.Label; 
import fl.controls.NumericStepper; 
 
var dobPrompt:Label = new Label(); 
var moPrompt:Label = new Label(); 
var dayPrompt:Label = new Label(); 
var yrPrompt:Label = new Label(); 
 
var moNs:NumericStepper = new NumericStepper(); 
var dayNs:NumericStepper = new NumericStepper(); 
var yrNs:NumericStepper = new NumericStepper(); 
 
addChild(dobPrompt); 
addChild(moPrompt); 
addChild(dayPrompt); 
addChild(yrPrompt); 
addChild(moNs); 
addChild(dayNs); 
addChild(yrNs); 
 
dobPrompt.setSize(65, 22); 
dobPrompt.text = "Date of birth:"; 
dobPrompt.move(80, 150); 
 
moNs.move(150, 150); 
moNs.setSize(40, 22); 
moNs.minimum = 1; 
moNs.maximum = 12; 
moNs.stepSize = 1; 
moNs.value = 1; 
 
moPrompt.setSize(25, 22); 
moPrompt.text = "Mo."; 
moPrompt.move(195, 150); 
 
dayNs.move(225, 150); 
dayNs.setSize(40, 22); 
dayNs.minimum = 1; 
dayNs.maximum = 31; 
dayNs.stepSize = 1; 
dayNs.value = 1; 
 
dayPrompt.setSize(25, 22); 
dayPrompt.text = "Day"; 
dayPrompt.move(270, 150); 
 
yrNs.move(300, 150); 
yrNs.setSize(55, 22); 
yrNs.minimum = 1900; 
yrNs.maximum = 2006; 
yrNs.stepSize = 1; 
yrNs.value = 1980; 
 
yrPrompt.setSize(30, 22); 
yrPrompt.text = "Year"; 
yrPrompt.move(360, 150);

  5. Wybierz polecenia Sterowanie > Testuj film, aby uruchomić aplikację.