SimpleButton  - AS3

Określa obiekt wyświetlany stosowany jako obiekt wizualny dla stanu "Down" przycisku. Jest to stan przycisku, w sytuacji gdy użytkownik kliknie obiekt hitTestState.

Powiązane elementy interfejsu API

Wartość typu Boolean wskazująca, czy przycisk jest wciśnięty. W przypadku wyłączenia przycisku (włączona właściwość ma wartość false) przycisk jest widoczny, lecz nie można go kliknąć. Wartością domyślną jest true. Właściwość ta jest przydatna w razie potrzeby wyłączenia części nawigacji; na przykład gdy zachodzi potrzeba wyłączenia przycisku na stronie wyświetlanej w danym momencie, aby nie było możliwości jego kliknięcia ani ponownego załadowania strony.

Uwaga: Aby uniemożliwić klikanie przycisku, należy ustawić dla właściwości enabled i mouseEnabled wartość false.

Określa obiekt wyświetlany, który sygnalizuje fakt wciśnięcia przycisku. Dla przycisku podstawowego należy ustawić właściwość hitTestState na ten sam obiekt wyświetlany, co właściwość overState. W przypadku braku ustawienia właściwości hitTestState obiekt SimpleButton jest nieaktywny — nie reaguje na zdarzenia interakcji ze strony użytkownika.

Powiązane elementy interfejsu API

Określa obiekt wyświetlany stosowany jako obiekt wizualny dla stanu "button over". Jest to stan przycisku, w sytuacji gdy wskaźnik znajduje się nad przyciskiem.

Powiązane elementy interfejsu API

Skojarzony z tym przyciskiem obiekt SoundTransform. Obiekt SoundTransform zawiera właściwości umożliwiające ustawianie głośności, przesunięcia oraz przypisywanie lewego i prawego głośnika. Ten obiekt SoundTransform jest stosowany wobec wszystkich stanów przycisku. Ten obiekt SoundTransform ma wypływ tylko na dźwięki osadzone.

Powiązane elementy interfejsu API

Wskazuje, czy inne obiekty ekranowe, będące obiektami SimpleButton lub MovieClip, mogą reagować na zdarzenia zwolnienia urządzenia wejściowego użytkownika. Właściwość trackAsMenu umożliwia tworzenie menu. Możliwe jest utworzenie właściwości trackAsMenu na dowolnym obiekcie SimpleButton lub MovieClip. Jeżeli właściwość trackAsMenu nie istnieje, wówczas domyślne zachowanie ma wartość false.

Możliwa jest zmiana właściwości trackAsMenu w dowolnym momencie; zmodyfikowany przycisk natychmiast wykorzystuje nowe zachowanie kursora.

Określa obiekt wyświetlany stosowany jako obiekt wizualny dla stanu button up. Jest to stan przycisku, w sytuacji gdy wskaźnik nie znajduje się nad przyciskiem.

Powiązane elementy interfejsu API

Wartość typu Boolean, która określa, czy wskaźnik przesuwany nad przyciskiem ma przybierać postać dłoni (true). Jeżeli właściwość ta jest ustawiona na wartość false, wówczas pojawia się kursor strzałki. Wartością domyślną jest true.

Możliwa jest zmiana właściwości useHandCursor w dowolnym momencie; zmodyfikowany przycisk natychmiast wykorzystuje nowe zachowanie kursora.

Tworzy nową instancję klasy SimpleButton. Wybrane lub wszystkie obiekty wyświetlane reprezentujące różne stany przycisku mogą być ustawione jako parametry konstruktora.

1. W konstruktorze SimpleButtonExample() tworzony jest obiekt CustomSimpleButton typu SimpleButton o nazwie button, który wywołuje metodę CustomSimpleButton konstruktora. Obiekt button jest następnie dodawany do listy wyświetlania. Kolor i rozmiar przycisku jest określany w następnych krokach.
2. W klasie CustomSimpleButton właściwości instancji są deklarowane w celu późniejszego użycia do kontroli rozmiaru i koloru tła elementu button, co jest oparte na stanie, w jakim się znajduje (kolor pomarańczowy jeżeli stan jest normalny, kolor ciemno żółty gdy wskaźnik myszy znajduje się nad obiektem, oraz kolor jasno niebieski przy stanie naciśnięcia przycisku myszy). We wszystkich przypadkach stanu obiektu button rozmiar kwadratu jest ustawiony na 80 pikseli przy użyciu właściwości size.
3. Funkcja konstruktora klasy CustomSimpleButton ustawia właściwości downState, overState, upState, hitTestState oraz useHandCursor przy pomocy czterech instancji klasy ButtonDisplayState.
4. W klasie ButtonDisplayState konstruktor ustawia wartości rozmiaru kwadratu i koloru tła oraz wywołuje metodę draw().
5. Metoda draw() przerysowuje kwadrat według rozmiaru i zestawu kolorów tła ustawionego w konstruktorze bazującym na stanie przycisku.

package {
    import flash.display.Sprite;

    public class SimpleButtonExample extends Sprite {
        public function SimpleButtonExample() {
            var button:CustomSimpleButton = new CustomSimpleButton();
            addChild(button);
        }
    }
}

import flash.display.DisplayObject;
import flash.display.Shape;
import flash.display.SimpleButton;

class CustomSimpleButton extends SimpleButton {
    private var upColor:uint   = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;
    private var size:uint      = 80;

    public function CustomSimpleButton() {
        downState      = new ButtonDisplayState(downColor, size);
        overState      = new ButtonDisplayState(overColor, size);
        upState        = new ButtonDisplayState(upColor, size);
        hitTestState   = new ButtonDisplayState(upColor, size * 2);
        hitTestState.x = -(size / 4);
        hitTestState.y = hitTestState.x;
        useHandCursor  = true;
    }
}

class ButtonDisplayState extends Shape {
    private var bgColor:uint;
    private var size:uint;

    public function ButtonDisplayState(bgColor:uint, size:uint) {
        this.bgColor = bgColor;
        this.size    = size;
        draw();
    }

    private function draw():void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}