NumericStepper  - AS3 Flash

Bileşenin kullanıcı etkileşimi kabul edip edemeyeceğini gösteren bir değeri alır veya ayarlar. true değeri, bileşenin kullanıcı etkileşimini kabul edebileceğini; false değeri ise edemeyeceğini gösterir.

enabled özelliğini false olarak ayarlarsanız kabın rengi karartılır ve (Label ve ProgressBar bileşenleri hariç) kullanıcı girdisi engellenir.

Varsayılan değer şudur true.

Girdi yöntemi düzenleyicisinin (IME) modunu alır veya ayarlar. IME, kullanıcıların Çince, Japonca, Korece karakter kümelerinden karakter girmesi için QWERTY klavye kullanmayı mümkün hale getirir.

Bileşen odak aldığında Flash, IME'yi belirtilen moda ayarlar ve bileşen odağı kaybettiğinde de orijinal değerine geri yükler.

flash.system.IMEConversionMode sınıfı, bu özellik için geçerli değerler olarak kullanılacak sabitleri tanımlar. IME'nin bileşenle kullanımını önlemek için bu özelliği, null olarak ayarlayın.

Maksimum değeri, sayısal değer sırasında alır veya ayarlar.

Varsayılan değer şudur 10.

Minimum sayıyı, sayısal değer sırasında alır veya ayarlar.

Varsayılan değer şudur 0.

Sonraki değeri, değer sırasında alır.

Önceki değeri, değer sırasında alır.

Değerler arasındaki değişim birimini tanımlayan, sıfır dışındaki bir sayıyı alır veya ayarlar. value özelliği, bu sayıdan minimum değerin çıkarılmasıyla elde edilen sonucun bir katsayısıdır. NumericStepper bileşeni, ortaya çıkan değeri en yakın adım boyutuna yuvarlar.

Varsayılan değer şudur 1.

NumericStepper bileşeninin içerdiği TextInput bileşenine bir başvuru alır. Bu özelliği, temel TextInput bileşenine erişmek ve bu bileşeni işlemek için kullanın. Örneğin, bu özelliği metin kutusundaki geçerli seçimi değiştirmek veya metin kutusunun kabul ettiği karakterleri kısıtlamak için kullanabilirsiniz.

NumericStepper bileşeninin geçerli değerini alır veya ayarlar.

Varsayılan değer şudur 1.

Yeni bir NumericStepper bileşeni örneği oluşturur.

Bu bileşendeki odak göstergesini gösterir veya gizler.

UIComponent sınıfı, focusSkin stili tarafından belirtilen sınıfın örneğini oluşturup konumlandırarak bu yöntemi uygular.

Parametreler

Geçerli bileşen için varsayılan stil eşlemesini alır. Stil eşlemesi, bileşenin kullandığı stile bağlı olarak bileşen için uygun olan türü içerir. Örneğin disabledTextFormat stili, null değeri veya TextFormat nesnesi içerir. Geçerli bileşende bu stilleri kullanılabilir ve setStyle() öğesini çağırabilirsiniz. Şu kod, belirtilen bileşendeki varsayılan disabledTextFormat stilini geçersiz kılar:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

İlgili API Öğeleri

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

Odağı bu bileşen örneğine alır.

Kullanıcı NumericStepper bileşeninin değerini değiştirdiğinde gönderilir.

Not: Metni değiştirmek için ActionScript kullanıldığında bu olay gönderilmez.

Bu olay şu özelliklere sahiptir:

1. NumericStepper bileşenini kütüphanenize ekleyin.
2. Bu kodu FLA dosyanızla aynı dizine NumericStepperExample.as olarak kaydedin.
3. FLA dosyasındaki DocumentClass öğesini NumericStepperExample olarak ayarlayın.

package 
{
    import flash.display.Sprite
    import flash.text.TextField;
    import flash.events.Event;
    import fl.controls.NumericStepper;
    
    public class NumericStepperExample extends Sprite
    {
        private var ns1:NumericStepper;
        private var ns2:NumericStepper;
        private var tf1:TextField;
        private var tf2:TextField;
        private var rowHeight1:Number = 10;
        private var rowHeight2:Number = 50;
        
        public function NumericStepperExample() {        
            setupSteppers();
            setupTextFields();
        }
        private function setupTextFields():void {
            tf1 = new TextField();
            tf1.text = "This stepper increments by 1 between 0 and 5. Disables if it reaches 0.";
            tf1.autoSize = "left";
            tf1.x = 100;
            tf1.y = rowHeight1;
            addChild(tf1);
            
            tf2 = new TextField();
            tf2.text = "This stepper increments by 0.01 between 0 and 20. Disables if it reaches 0.";
            tf2.autoSize = "left";
            tf2.x = 100;
            tf2.y = rowHeight2;
            addChild(tf2);
        }
        private function setupSteppers():void {    
            ns1 = new NumericStepper();
            ns1.stepSize = 1;
            ns1.maximum = 5;
            ns1.minimum = 0;
            ns1.addEventListener(Event.CHANGE,changeOccurred);
            ns1.move(10,rowHeight1);
            addChild(ns1);

            ns2 = new NumericStepper();
            ns2.stepSize = 0.01;
            ns2.maximum = 20;
            ns2.minimum = 0;
            ns2.value = 10;
            ns2.addEventListener(Event.CHANGE,changeOccurred);
            ns2.move(10,rowHeight2);
            addChild(ns2);
        }
        private function changeOccurred(e:Event):void {
            var nsTarget:NumericStepper = e.target as NumericStepper;
            if(nsTarget.value == 0) nsTarget.enabled = false;
        }
    }
}