Använda komponenten CheckBox

En CheckBox är en fyrkantig ruta som kan markeras eller avmarkeras. När den är markerad visas en bock i rutan. Du kan lägga till en textetikett i en CheckBox och placera den till vänster om, höger om, ovanför eller nedanför CheckBox.

Du kan använda flera CheckBox om du vill samla in en uppsättning med true - och false -värden som inte är ömsesidigt uteslutande. Ett program som samlar in information om vilken sorts bil du vill köpa kan använda CheckBoxes för att låta dig välja funktioner.

Användarinteraktion med CheckBox

Du kan aktivera eller inaktivera en CheckBox i ett program. Om en CheckBox är aktiverad och en användare klickar på den eller på dess etikett, får CheckBox fokus för inmatning och dess nedtryckta utseende visas. Om en användare flyttar pekaren utanför markeringsramen för en CheckBox eller dess etikett samtidigt som han håller ned musknappen återgår komponentens utseende till det ursprungliga läget, och den behåller indatafokus. Läget för en CheckBox ändras inte förrän musknappen släpps ovanför komponenten. Dessutom har CheckBox två inaktiverade lägen, markerad och avmarkerad, som använder selectedDisabledSkin och disabledSkin , och som inte tillåter interaktion via mus eller tangentbord.

Om en CheckBox är inaktiverad visas dess inaktiverade utseende, oavsett användarinteraktion. I inaktiverat läge tar en CheckBox inte emot inmatningar från musen eller tangentbordet.

En CheckBox-förekomst får fokus om en användare klickar på den eller går till den med tabbtangenten. När en CheckBox-förekomst har fokus kan du använda följande tangenter för att styra den:

Nyckel

Beskrivning

Skift+Tabb

Flyttar fokus till föregående element.

Mellanslagstangent

Markerar eller avmarkerar komponenten och utlöser change -händelsen.

Tabb

Flyttar fokus till nästa element.

Mer information om hur fokuskontroll finns i Arbeta med FocusManager och i FocusManager -klassen i Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

En direktförhandsvisning av varje CheckBox-förekomst reflekterar ändringar som gjorts för parametrar i egenskapsinspektören eller komponentinspektören vid redigeringen.

När du lägger till CheckBox-komponenten i ett program kan du göra den åtkomlig för en skärmläsare genom att lägga till följande rader med ActionScript-kod: 

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

Du aktiverar bara en komponents åtkomlighet en gång, oavsett hur många förekomster du har av komponenten.

CheckBox-komponentparametrar

Du kan ställa in följande utvecklingsparametrar i egenskapsinspektören eller komponentinspektören för varje förekomst av CheckBox-komponenten: label , labelPlacement och selected . Var och en av de här parametrarna har en motsvarande ActionScript-egenskap med samma namn. Information om möjliga värden på de här parametrarna finns i CheckBox-klassen i Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

Skapa ett program med Checkbox

Följande procedur beskriver, med hjälp av ett utdrag ur ett låneansökningsformulär, hur du lägger till en CheckBox-komponent i ett program under utvecklingen. I formuläret får den som ansöker frågan om han eller hon är en husägare, och där finns en CheckBox där användaren kan svara ”ja”. Om användaren svarar ”ja” visas två alternativknappar där användaren kan ange husets relativa värde.

Skapa ett program med Checkbox-komponenten

  1. Skapa ett nytt Flash-dokument (ActionScript 3.0).

  2. Dra en CheckBox-komponent från panelen Komponenter till scenen.

  3. Gör följande i egenskapsinspektören:

    • Ange homeCh som förekomstnamn.

    • Ange 140 som värde för bredden (W).

    • Ange ” Äger ditt hus ?” för etikettparametern.

  4. Dra två RadioButton-komponenter från panelen Komponenter till scenen och placera dem nedanför och till höger om CheckBox. Ange följande värden för dem i egenskapsinspektören:

    • Ange underRb och overRb som förekomstnamn.

    • Ange 120 för parametern W (bredd) för båda RadioButtons.

    • Ange Under 500 000 kr? för etikettparametern för underRb .

    • Ange Över 500 000 kr? för etikettparametern för overRb .

    • Ange valueGrp för parametern groupName för båda RadioButtons.

  5. Öppna åtgärdspanelen, markera bildruta 1 i huvudtidslinjen och ange följande ActionScript-kod: 

    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;     
}

    Den här koden skapar en händelsehanterare för en CLICK -händelse som aktiverar RadioButtons underRb och overRb om CheckBox homeCh markeras, och inaktiverar dem om homeCh inte markeras. Mer information finns i avsnittet om klassen MouseEvent i Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

  6. Välj Kontroll > Testa filmen.

Följande exempel kopierar det föregående programmet, men skapar CheckBox och RadioButtons med ActionScript.

Skapa en CheckBox med ActionScript

  1. Skapa ett nytt Flash-dokument (ActionScript 3.0).

  2. Dra CheckBox-komponenten och RadioButton-komponenten från panelen Komponenter till det aktuella dokumentets bibliotekspanel. Om bibliotekspanelen inte är öppen trycker du på Ctrl+L eller väljer Fönster > Bibliotek för att öppna den.

    Då blir komponenterna tillgängliga för ditt program, men de placeras inte på scenen.

  3. Öppna panelen Åtgärder, markera bildruta 1 i huvudtidslinjen och ange följande kod för att skapa och placera komponentförekomsterna: 

    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?";

    Koden använder konstruktorerna CheckBox() och RadioButton() för att skapa komponenterna och metoden addChild() för att placera dem på scenen. Den använder metoden move() för att placera komponenterna på scenen.

  4. Nu lägger du till följande ActionScript för att skapa en händelseavlyssnare och en händelsehanterarfunktion: 

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

    Den här koden skapar en händelsehanterare för en CLICK -händelse som aktiverar alternativknapparna underRb och overRb om CheckBox homeCh markeras, och inaktiverar dem om homeCh inte markeras. Mer information finns i avsnittet om klassen MouseEvent i Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

  5. Välj Kontroll > Testa filmen.