NumericStepper  - AS3 Flash

Hämtar eller ställer in värde som anger om komponenten kan ta emot användarinteraktion. Värdet true anger att komponenten kan ta emot användarinteraktion; värdet false anger att det inte kan det.

Om du ställer in egenskapen enabled till false blir färgen på behållaren dämpad och inmatning från användaren blockeras (med undantag för Label- och ProgressBar-komponenter).

Standardvärdet är true.

Hämtar eller ställer in läget för IME (Input Method Editor). Med IME kan användare använda ett QWERTY-tangentbord för att ange tecken från kinesiska, japanska och koreanska teckenuppsättningar.

I Flash ställs IME in på ett visst läge när komponenten får fokus, och när komponenten förlorar fokus utförs en återställning till det ursprungliga värdet.

Klassen flash.system.IMEConversionMode definierar konstanter för de giltiga värdena för den här egenskapen. Ställ in den här egenskapen på null för att förhindra att IME används med komponenten.

Hämtar eller ställer in det högsta värdet i sekvensen med numeriska värden.

Standardvärdet är 10.

Hämtar eller ställer in det lägsta värdet i den numeriska värdesekvensen.

Standardvärdet är 0.

Hämtar nästa värde i värdesekvensen.

Hämtar det föregående värdet i värdesekvensen.

Hämtar eller ställer in en siffra som inte är noll som beskriver ändringsenheten mellan värden. Egenskapen value är delbar med den här siffran. NumericStepper-komponenten avrundar resultatvärdet till närmaste stegstorlek.

Standardvärdet är 1.

Hämtar en referens till TextInput-komponenten som finns i NumericStepper-komponenten. Använd den här egenskapen om du vill få åtkomst till och ändra den underliggande TextInput-komponenten. Du kanske vill ändra på textrutans markering eller begränsa tecknen som kan anges i den.

Hämtar eller ställer in det aktuella värdet för NumericStepper-komponenten.

Standardvärdet är 1.

Skapar en ny instans av komponenten NumericStepper.

Visar eller döljer fokusindikatorn på komponenten.

UIComponent-klassen implementerar den här metoden genom att skapa och positionera en instans av klassen som anges med formatet focusSkin.

Parametrar

Hämtar standardformatförskjutningen för den aktuella komponenten. Formatförskjutningen innehåller den type som är lämplig för komponenten, beroende på det format komponenten använder. Till exempel innehåller formatet disabledTextFormat värdet null eller ett TextFormat-objekt. Du kan använda dessa format och anropa setStyle() på den aktuella komponenten. Följande kod åsidosätter standardformatet för disabledTextFormat för den angivna komponenten:

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

Relaterade API-element

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

Ställer in fokus på den här komponentinstansen.

Skickas när användaren ändrar värdet för NumericStepper-komponenten.

Obs! Den här händelsen skickas inte om ActionScript används för att ändra värdet.

Den här händelsen har följande egenskaper:

1. Lägg till NumericStepper-komponenten i biblioteket.
2. Spara koden som NumericStepperExample.as i samma katalog som din FLA-fil.
3. Ställ in NumericStepperExample som DocumentClass i FLA-filen.

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