SimpleButton  - AS3

Düğme "Basılı" durumu için görsel nesne olarak kullanılan görüntüleme nesnesini belirtir — "Basılı" durumu, kullanıcı hitTestState nesnesini seçtiğinde düğmenin bulunduğu durumdur.

İlgili API Öğeleri

Düğmenin etkin olup olmadığını belirten Boolean değeri. Bir düğme devre dışı bırakıldığında (enabled özelliği false değerine ayarlanır), düğme görünebilir ancak tıklatılamaz. Varsayılan değer true şeklindedir. Gezinmenizin bir kısmını devre dışı bırakmak isterseniz (örneğin, sayfanın tıklatılıp yeniden yüklenememesi için geçerli olarak görüntülenen sayfadaki bir düğmeyi devre dışı bırakmak isteyebilirsiniz) bu özellik yararlıdır.

Not: Bir düğme üzerindeki mouseClicks öğesini engellemek için, hem enabled hem de mouseEnabled özelliklerini false olarak ayarlayın.

Düğme için hit testing nesnesi olarak kullanılan görüntüleme nesnesini belirtir. Temel bir düğme için, hitTestState özelliğini, overState özelliğiyle aynı görüntüleme nesnesine ayarlayın. hitTestState özelliğini ayarlamazsanız, SimpleButton devre dışı olur — kullanıcı girdisi olaylarına yanıt vermez.

İlgili API Öğeleri

Düğme üzerinde durumu için görsel nesne olarak kullanılan bir görüntüleme nesnesini belirtir — düğme üzerinde durumu, işaretçi düğmenin üzerinde olduğunda düğmenin bulunduğu durumdur.

İlgili API Öğeleri

Bu düğmeye atanan SoundTransform nesnesi. SoundTransform nesnesi, ses düzeyini ayarlama, yatay kaydırma, sol hoparlör ataması ve sağ hoparlör atamasına yönelik özellikleri içerir. Bu SoundTransform nesnesi, düğmenin tüm durumları için geçerlidir. Bu SoundTransform nesnesi yalnızca gömülü sesleri etkiler.

İlgili API Öğeleri

SimpleButton veya MovieClip nesneleri olan diğer görüntüleme nesnelerinin, kullanıcı girdisi bırakma olaylarını alıp alamadığını belirtir. trackAsMenu özelliği, menüler oluşturmanızı sağlar. Herhangi bir SimpleButton veya MovieClip nesnesinde trackAsMenu özelliğini ayarlayabilirsiniz. trackAsMenu özelliği yoksa, varsayılan davranış false olur.

trackAsMenu özelliğini istediğiniz zaman değiştirebilirsiniz; değiştirilen düğme hemen yeni davranışı alır.

Düğme serbest durumu için görsel nesne olarak kullanılan bir görüntüleme nesnesini belirtir — düğme serbest durumu, işaretçi düğmenin üzerinde olmadığında düğmenin bulunduğu durumdur.

İlgili API Öğeleri

True olarak ayarlandığında, işaretçi bir düğme üzerinde gezindiği zaman el imlecinin gösterilip gösterilmeyeceğini belirten bir Boolean değeri. Bu özellik false değerine ayarlanırsa, bunun yerine ok işaretçisi imleci görüntülenir. Varsayılan değer true şeklindedir.

useHandCursor özelliğini istediğiniz zaman değiştirebilirsiniz; değiştirilen düğme hemen yeni imleç davranışını kullanır.

Yeni bir SimpleButton örneği oluşturur. Çeşitli düğme durumlarını temsil eden görüntüleme nesnelerinin tümü veya herhangi biri, yapıcıda parametreler olarak ayarlanabilir.

1. SimpleButtonExample() yapıcısında, button adıyla SimpleButton türünde yeni bir CustomSimpleButton nesnesi oluşturulur ve bu nesne CustomSimpleButton yapıcısı yöntemini çağırır. button nesnesi, görüntüleme listesine eklenir. Düğmenin rengi ve boyutu, sonraki adımlarda belirlenir.
2. CustomSimpleButton sınıfında, bulunduğu duruma (normal durumda turuncu, fare üzerinde gezdirildiğinde koyu sarı ve fare düğmesi basılı durumda açık mavi) göre button öğesinin boyutunu ve arka plan rengini denetlemek için daha sonra kullanılan instance özellikleri bildirilir. Tüm button durumlarında, size özelliği kullanılarak karenin boyutu 80 piksele ayarlanır.
3. CustomSimpleButton sınıfının yapıcı işlevi, ButtonDisplayState sınıfının dört örneğiyle downState, overState, upState, hitTestState ve useHandCursor özelliklerini ayarlar.
4. ButtonDisplayState sınıfında yapıcı, karenin boyutunu ve arka plan rengini ayarlar ve draw() yöntemini çağırır.
5. draw() yöntemi, düğmenin durumuna göre yapıcıda ayarlanan boyut ve arka plan rengiyle kareyi yeniden çizer.

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