NumericStepper  - AS3 Flash

Pobiera lub ustawia wartość wskazującą, czy składnik akceptuje interakcje ze strony użytkownika. Wartość true oznacza, że składnik może akceptować interakcje ze strony użytkownika; wartość false oznacza sytuację przeciwną.

Ustawienie właściwości enabled na false powoduje, że kolor kontenera zostanie wyszarzony, a akceptowanie interakcji ze strony użytkownika będzie zablokowane (z wyjątkiem składników Label i ProgressBar).

Wartością domyślną jest true.

Pobiera lub ustawia tryb edytora IME. Edytor IME umożliwia użytkownikom wprowadzanie za pośrednictwem klawiatury QWERTY znaków należących do chińskiego, japońskiego oraz koreańskiego zestawu znaków.

Edytor IME jest przełączany do podanego trybu po uaktywnieniu składnika, a pierwotny tryb jest przywracany po jego dezaktywacji.

Klasa flash.system.IMEConversionMode definiuje stałe dla poprawnych wartości tej właściwości. Właściwość tę należy ustawić na wartość null, aby uniknąć użycia edytora IME wraz ze składnikiem.

Pobiera lub ustawia wartość maksymalną w sekwencji wartości numerycznych.

Wartością domyślną jest 10.

Pobiera lub ustawia wartość minimalną w sekwencji wartości numerycznych.

Wartością domyślną jest 0.

Pobiera następną wartość w sekwencji.

Pobiera poprzednią wartość w sekwencji.

Pobiera lub ustawia liczbę niezerową opisującą jednostkę zmiany między wartościami. Właściwość value jest wielokrotnością tej liczby pomniejszoną o wartość minimalną. Składnik NumericStepper zaokrągla wartość wynikową do najbliższej wielkości krokowej.

Wartością domyślną jest 1.

Pobiera odwołanie do składnika TextInput zawartego w składniku NumericStepper. Właściwość ta służy do uzyskiwania dostępu do podstawowego składnika TextInput i manipulowania nim. Na przykład użytkownik może użyć tej właściwości do zmiany bieżącego wyboru w polu tekstowym lub do ograniczenia zbioru znaków akceptowanych w danym polu tekstowym.

Pobiera lub ustawia bieżącą wartość składnika NumericStepper.

Wartością domyślną jest 1.

Tworzy nową instancję składnika NumericStepper.

Wyświetla lub ukrywa wskaźnik aktywności tego składnika.

Klasa UIComponent implementuje tę metodę poprzez utworzenie i ustawienie położenia instancji klasy określonej przez styl focusSkin.

Parametry

Pobiera domyślną mapę stylów dla bieżącego składnika. Mapa stylów zawiera typ odpowiedni dla składnika, w zależności od stylu składnika. Na przykład dla stylu disabledTextFormat wartość jest równa null lub jest obiektem TextFormat. Można używać tych stylów w wywołaniach metody setStyle() dla bieżącego składnika. Poniższy kod przesłania domyślny styl disabledTextFormat dla określonego składnika:

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

Powiązane elementy interfejsu API

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

Uaktywnia daną instancję składnika.

Wywoływane, gdy użytkownik zmieni wartość składnika NumericStepper.

Uwaga: To zdarzenie nie jest wywoływane, jeśli wartość jest zmieniana za pośrednictwem kodu ActionScript.

To zdarzenie ma następujące właściwości:

1. Dodaj składnik NumericStepper do biblioteki.
2. Zapisz ten kod pod nazwą NumericStepperExample.as w tym samym katalogu, co plik FLA.
3. Ustaw właściwość DocumentClass w pliku FLA na wartość NumericStepperExample.

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