Korzystanie ze składnika CheckBox

Obiekt CheckBox jest kwadratowym polem, które można zaznaczyć lub z którego można usunąć zaznaczenie. Po jego zaznaczeniu w polu wyświetlone zostanie oznaczone znacznikiem wyboru. Do składnika CheckBox można dodać etykietę tekstową i umieścić ją po lewej/prawej stronie lub poniżej/powyżej składnika.

Składników CheckBox można używać w celu zgromadzenia zestawu wartości true i false , które się wzajemnie nie wykluczają. Na przykład aplikacja zbierająca informacje o rodzaju samochodu, który użytkownik chce nabyć może użyć składników CheckBox, aby umożliwić wybieranie jego cech.

Posługiwanie się składnikiem CheckBox

Składnika CheckBox w aplikacji można włączyć lub wyłączyć. Jeśli składnik CheckBox jest włączony i zostanie kliknięty lub kliknięta zostanie jego etykieta, składnik zostanie aktywowany i wyświetlony zostanie jako naciśnięty. Jeśli wskaźnik z wciśniętym przyciskiem myszy przesunięty zostanie poza obszar powiązany ze składnikiem CheckBox lub jego etykietą wygląd składnika powróci do stanu pierwotnego i zachowa aktywność do wprowadzania. Stan składnika CheckBox nie zmienia się do momentu zwolnienia przycisku myszy nad składnikiem. Ponadto składnik CheckBox zawiera dwa stany disabled (selected i deselected), które używają odpowiednio karnacji selectedDisabledSkin i disabledSkin , które nie zezwalają na wykonywanie działań za pomocą myszy lub klawiatury.

Jeśli składnik CheckBox jest wyłączony, karnacja disabled jest wyświetlana niezależnie od działania użytkownika. W stanie disabled składnik CheckBox nie odbiera danych wprowadzanych za pomocą klawiatury lub myszy.

Instancja CheckBox jest aktywowana po jej kliknięciu lub przejściu do niej za pomocą klawisza Tab. Po aktywowaniu instancji CheckBox można nią sterować za pomocą następujących klawiszy:

Klucz

Opis

Shift+Tab

Przesuwa aktywność do poprzedniego elementu.

Spacja

Zaznacza lub usuwa zaznaczenie składnika i wywołuje zdarzenie change .

Karta

Przesuwa aktywność do kolejnego elementu.

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

Podgląd aktywny każdej z instancji CheckBox odzwierciedla zmiany dokonane w parametrach w Inspektorze właściwości oraz Inspektorze składników podczas tworzenia.

Po dodaniu składnika CheckBox do aplikacji można go udostępnić dla czytnika ekranu, dodając do kodu ActionScript następujące wiersze: 

import fl.accessibility.CheckBoxAccImpl; 
 
CheckBoxAccImpl.enableAccessibility();

Ułatwienia dostępu włącza się dla danej klasy składników tylko raz, niezależnie od liczby posiadanych instancji.

Parametry składnika CheckBox

Dla każdej instancji składnika CheckBox w Inspektorze właściwości lub Inspektorze składników można ustawić następujące parametry tworzenia treści: label , labelPlacement i selected . 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 CheckBox w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Tworzenie aplikacji za pomocą składnika CheckBox

Poniższa procedura wyjaśnia za pomocą fragmentu z formularza aplikacji do udzielania kredytów jak podczas tworzenia dodać składnik CheckBox do aplikacji. W formularzu zawarte jest pytanie, czy zgłaszający się jest właścicielem domu i zapewniany jest składnik CheckBox w celu umożliwienia odpowiedzi “tak”. Jeśli taka odpowiedź zostanie zaznaczona, w formularzu wyświetlone zostaną dwa przyciski opcji, które umożliwią wskazanie względnej wartości domu.

Tworzenie aplikacji za pomocą składnika Checkbox

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

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

  3. W Inspektorze właściwości wykonaj następujące kroki:

    • Dla nazwy instancji wprowadź homeCh .

    • Wprowadź 140 dla wartości szerokości (W).

    • Wprowadź “ Own your home ?” dla parametru label.

  4. Przeciągnij dwa składniki RadioButton z panelu Składniki na stół montażowy i umieść je po prawej stronie poniżej składnika CheckBox. W Inspektorze właściwości wprowadź dla nich następujące wartości:

    • Dla nazw instancji wprowadź underRb i overRb .

    • W obu składnikach RadioButton wprowadź wartość 120 dla parametru Sz (szerokość).

    • Wprowadź Under $500,000? dla parametru label instancji underRb .

    • Wprowadź wartość Over $500,000? dla parametru label instancji overRb .

    • Wprowadź valueGrp dla parametru groupName obu składników RadioButton.

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

    homeCh.addEventListener(MouseEvent.CLICK, clickHandler); 
underRb.enabled = false; 
overRb.enabled = false; 
 
function clickHandler(event:MouseEvent):void { 
    underRb.enabled = event.target.selected; 
    overRb.enabled = event.target.selected;     
}

    Kod ten tworzy moduł obsługi zdarzenia CLICK , który włącza składniki RadioButton underRb i overRb , jeśli zaznaczony jest składnik CheckBox homeCh , a wyłącza je, jeśli homeCh nie jest zaznaczony. Więcej informacji zawiera opis klasy MouseEvent w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

  6. Wybierz polecenie Sterowanie > Testuj film.

W poniższym przykładzie powielana jest poprzednia aplikacja i tworzone są za pomocą ActionScript składnik CheckBox i składniki RadioButton.

Tworzenie składnika Checkbox przy użyciu kodu ActionScript

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

  2. Przeciągnij składnik CheckBox i składnik RadioButton z panelu Składniki do panelu Biblioteka bieżącego dokumentu. Jeśli panel Biblioteka jest zamknięty, naciśnij klawisze Ctrl+L lub wybierz opcje Okno > Biblioteka, aby otworzyć panel Biblioteka.

    Spowoduje to udostępnienie składników w aplikacji użytkownika, ale nie zostaną one wstawione na stół montażowy.

  3. Otwórz panel Operacje, zaznacz klatkę nr 1 na głównej osi czasu i wprowadź następujący kod w celu utworzenia i ustawienia instancji składnika: 

    import fl.controls.CheckBox; 
import fl.controls.RadioButton; 
 
var homeCh:CheckBox = new CheckBox(); 
var underRb:RadioButton = new RadioButton(); 
var overRb:RadioButton = new RadioButton(); 
addChild(homeCh); 
addChild(underRb); 
addChild(overRb); 
underRb.groupName = "valueGrp"; 
overRb.groupName = "valueGrp"; 
homeCh.move(200, 100); 
homeCh.width = 120; 
homeCh.label = "Own your home?"; 
underRb.move(220, 130); 
underRb.enabled = false; 
underRb.width = 120; 
underRb.label = "Under $500,000?"; 
overRb.move(220, 150); 
overRb.enabled = false; 
overRb.width = 120; 
overRb.label = "Over $500,000?";

    Kod ten używa konstruktorów CheckBox() i RadioButton() w celu utworzenia składników oraz metody addChild() w celu umieszczenia ich na stole montażowym. Metoda move() używana jest do ustawienia składników na stole montażowym.

  4. Dodaj następujący kod ActionScript, aby utworzyć detektor zdarzeń i funkcję obsługi zdarzenia: 

    homeCh.addEventListener(MouseEvent.CLICK, clickHandler); 
 
function clickHandler(event:MouseEvent):void { 
    underRb.enabled = event.target.selected; 
    overRb.enabled = event.target.selected;     
}

    Kod ten tworzy moduł obsługi zdarzenia CLICK , który włącza przyciski opcji underRb i overRb , jeśli zaznaczony jest składnik CheckBox homeCh , a wyłącza je, jeśli homeCh nie jest zaznaczony. Więcej informacji zawiera opis klasy MouseEvent w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

  5. Wybierz polecenie Sterowanie > Testuj film.