UIComponent  - AS3 Flash

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Komponente eine Benutzereingabe annehmen kann. Der Wert true gibt an, dass die Komponente Benutzereingaben annehmen kann, der Wert false, dass die Komponente keine Benutzereingaben annehmen kann.

Wenn Sie die Eigenschaft enabled auf false einstellen, wird die Farbe des Containers abgeblendet und Benutzereingaben werden blockiert (mit Ausnahme der Label- und ProgressBar-Komponenten).

Der Standardwert ist true.

Ruft einen booleschen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest. Der Wert true gibt an, dass die Fokusanzeige positioniert werden kann, der Wert false, dass diese nicht positioniert werden kann.

Falls für die Eigenschaft false festgelegt ist, wird der Fokus auf die erste übergeordnete Komponente übertragen, deren Eigenschaft mouseFocusEnabled auf true gesetzt ist.

Der Standardwert ist true.

Verwandte API-Elemente

Ruft den FocusManager-Wert ab bzw. legt den FocusManager-Wert fest, der den Fokus für diese und gleichrangige Komponenten steuert. Für jede Popup-Komponente wird eine separate Fokus-Schleife und eine FocusManager-Instanz verwaltet. Verwenden Sie diese Eigenschaften, um auf den richtigen FocusManager für diese Komponente zuzugreifen.

Ruft die Höhe der Komponente in Pixeln ab oder legt diese fest.

Durch Festlegen dieser Eigenschaft wird ein resize-Ereignis ausgelöst. Weitere Informationen dazu, wann dieses Ereignis ausgelöst wird, finden Sie im Abschnitt zum resize-Ereignis.

Falls die Eigenschaft scaleY der Komponente nicht 1.0 beträgt, stimmt die auf Basis der internen Koordinaten erhaltene Höhe der Komponente nicht mit dem Höhenwert der übergeordneten Koordinaten überein. Beispiel: Eine Komponente mit einer Höhe von 100 Pixeln und einer scaleY-Eigenschaft von 2 weist für die übergeordneten Koordinaten einen Wert von 100 Pixeln auf, speichert jedoch einen Höhenwert von 50 Pixeln.

Ruft einen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest. Der Wert true gibt an, dass die Fokusanzeige positioniert werden kann, der Wert false, dass diese nicht positioniert werden kann.

Falls für die Eigenschaft false festgelegt ist, wird der Fokus auf die erste übergeordnete Komponente übertragen, deren Eigenschaft mouseFocusEnabled auf true gesetzt ist.

Der Standardwert ist true.

Verwandte API-Elemente

Multipliziert die aktuelle Breite der Komponente mit einem Skalierungsfaktor.

Verwandte API-Elemente

Multipliziert die aktuelle Höhe der Komponente mit einem Skalierungsfaktor.

Verwandte API-Elemente

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Komponenteninstanz sichtbar ist. Der Wert true gibt an, dass die aktuelle Komponente sichtbar ist, der Wert false, dass diese nicht sichtbar ist.

Wenn diese Eigenschaft auf true eingestellt ist, wird vom Objekt ein show-Ereignis ausgelöst. Wenn diese Eigenschaft auf false eingestellt ist, wird vom Objekt ein hide-Ereignis ausgelöst. In beiden Fällen wird für untergeordnete Objekte kein show- oder hide-Ereignis ausgelöst, es sei denn, vom Objekt wird ausdrücklich eine diesbezügliche Anweisung geschrieben.

Der Standardwert ist true.

Verwandte API-Elemente

Ruft die Breite der Komponente in Pixeln ab oder legt diese fest.

Durch Festlegen dieser Eigenschaft wird ein resize-Ereignis ausgelöst. Weitere Informationen dazu, wann dieses Ereignis ausgelöst wird, finden Sie im Abschnitt zum resize-Ereignis.

Falls die Eigenschaft scaleX der Komponente nicht 1.0 beträgt, stimmt die auf Basis der internen Koordinaten erhaltene Breite der Komponente nicht mit dem Breitenwert der übergeordneten Koordinaten überein. Beispiel: Eine Komponente mit einer Breite von 100 Pixeln und einer scaleX-Eigenschaft von 2 weist für die übergeordneten Koordinaten einen Wert von 100 Pixeln auf, speichert jedoch einen Breitenwert von 50 Pixeln.

Verwandte API-Elemente

Ruft die X-Koordinate ab, die die Position der Komponente auf der X-Achse innerhalb des übergeordneten Containers angibt. Dieser Wert wird in Pixeln angegeben und von links berechnet.

Durch die Festlegung dieser Eigenschaft wird ein ComponentEvent.MOVE-Ereignis ausgelöst.

Der Standardwert ist 0.

Verwandte API-Elemente

Ruft die Y-Koordinate ab, die die Position der Komponente auf der Y-Achse innerhalb des übergeordneten Containers angibt. Dieser Wert wird in Pixeln angegeben und von oben berechnet.

Durch Festlegen dieser Eigenschaft wird ein move-Ereignis ausgelöst.

Verwandte API-Elemente

Erstellt eine neue Instanz der UIComponent-Komponente.

Löscht eine Stileigenschaft aus dieser Komponenteninstanz.

Hierbei gibt die Methode getStyle() nicht notwendigerweise den Wert undefined zurück.

Parameter

Verwandte API-Elemente

Blendet die Fokusanzeige auf dieser Komponente ein oder aus.

Mit der UIComponent-Klasse wird diese Methode implementiert, indem eine Instanz der vom Stil focusSkin definierten Klasse erstellt und positioniert wird.

Parameter

Leitet einen unmittelbaren Erstellungsvorgang ein, ohne sämtliche Elemente wie bei invalidateNow zu entwerten.

Ruft das Objekt ab, das derzeit den Fokus hat.

Beachten Sie, dass diese Methode nicht notwendigerweise die Komponente, auf der der Fokus liegt, zurückgibt. Es kann auch die interne Unterkomponente, die den Fokus übernommen hat, zurückgegeben werden. Verwenden Sie zum Abrufen der Komponente mit dem Fokus die Eigenschaft focusManager.focus.

Ruft eine Stileigenschaft ab, die in der Stilkette der Komponente festgelegt ist.

Der von dieser Methode zurückgegebene Typ hängt von der Stileigenschaft ab, die mit dieser Methode abgerufen wird. Zu den möglichen Typen gehören Boolesche Typen, Zeichenfolgen, Zahlen, int, uint für eine RGB-Farbe, eine Klasse für eine Skin oder ein beliebiges Objekt.

Falls Sie diese Methode zum Abrufen einer bestimmten Stileigenschaft aufrufen, wird ein bekannter Typ zurückgegeben, den Sie in einer Variablen desselben Typs speichern können. Es ist keine Datentypkonvertierung notwendig. Eine einfache Zuweisungsaussage, wie im folgenden Beispiel, ist ausreichend:

var backgroundColor:uint = getStyle("backgroundColor");

Falls die Stileigenschaft nicht in der Stilkette festgelegt ist, wird mit dieser Methode der Wert undefined zurückgegeben. Beachten Sie, dass es sich bei undefined um einen speziellen Wert handelt, der sich von false, "", NaN, 0 oder null unterscheidet. Ein gültiger Stilwert kann niemals undefined sein. Mit der statischen Methode StyleManager.isValidStyleValue() können Sie überprüfen, ob ein Wert festgelegt wurde.

Parameter

Verwandte API-Elemente

import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var myComboBox:ComboBox = new ComboBox();
myComboBox.setStyle("textPadding", 6);
myComboBox.setStyle("disabledAlpha", 0.8);

var styleObject:Object = ComboBox.getStyleDefinition();
var styleDP:DataProvider = new DataProvider();
var styleName:String;
var styleDefaultValue:String;
var styleCurrentValue:String;

for (styleName in styleObject) {
    styleDefaultValue = String(styleObject[styleName]);
    styleCurrentValue = String(myComboBox.getStyle(styleName));
    styleDP.addItem({name:styleName, defaultValue:styleDefaultValue, currentValue:styleCurrentValue});
}
styleDP.sortOn("name", Array.CASEINSENSITIVE);

var c1:DataGridColumn = new DataGridColumn("name");
c1.headerText = "Style name:";
var c2:DataGridColumn = new DataGridColumn("defaultValue");
c2.headerText = "Default style value:";
var c3:DataGridColumn = new DataGridColumn("currentValue");
c3.headerText = "Current style value:"

var styleDataGrid:DataGrid = new DataGrid();
styleDataGrid.addColumn(c1); // name
styleDataGrid.addColumn(c2); // defaultValue
styleDataGrid.addColumn(c3); // currentValue
styleDataGrid.dataProvider = styleDP;
styleDataGrid.setSize(stage.stageWidth - 20, stage.stageHeight - 20);
styleDataGrid.move(10, 10);
addChild(styleDataGrid);

Ruft die Standardstilmatrix der aktuellen Komponente ab. Die Stilmatrix enthält den für die Komponente geeigneten Typ und hängt von dem Stil ab, der von der Komponente verwendet wird. Der Stil disabledTextFormat enthält beispielsweise den Wert null oder ein TextFormat-Objekt. Sie können diese Stile verwenden und setStyle() für die aktuelle Komponente aufrufen. Mit folgendem Code wird der Standardstil disabledTextFormat der angegebenen Komponente überschrieben:

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

Verwandte API-Elemente

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

Gibt den angegebenen Stil für eine Komponente zurück, unter Berücksichtigung aller Stile, die auf globaler Ebene, auf Komponentenebene und auf Instanzebene festgelegt wurden.

Wenn für eine Komponente zum Beispiel auf globaler Ebene der Stil myStyle festgelegt wurden und Sie getStyle("myStyle") für eine Instanz aufrufen, die keine Instanzeinstellung hat, wird null zurückgegeben. Wenn Sie getStyleValue("myStyle") aufrufen, wird "myStyle" zurückgegeben, da dieser auf globaler Ebene aktiv ist.

Parameter

Entwertet eine Eigenschaft und erstellt die Komponente im nächsten Bild neu, sofern nicht anderweitig festgelegt.

Parameter

Führt Stile aus mehreren Klassen in einem Objekt zusammen. Falls ein Stil für mehrere Objekte definiert ist, wird der zuerst gefundene Stil verwendet.

Parameter

Verschiebt die Komponente innerhalb der übergeordneten Komponente an die angegebene Position. Dies hat den gleichen Effekt wie das Ändern der Komponentenposition mithilfe der Eigenschaften x und y. Wenn Sie diese Methode aufrufen, wird das Ereignis ComponentEvent.MOVE ausgelöst.

Um die Methode updateDisplayList() in einer individuellen Komponente zu überschreiben, verwenden Sie die Methode move(), anstatt die Eigenschaften x und y festzulegen. Grund dafür ist, dass beim Aufrufen der Methode move() sofort nach dem erfolgten Verschiebungsvorgang ein Ereignisobjekt move ausgelöst wird. Wenn Sie jedoch die Komponentenposition durch Festlegen der Eigenschaften x und y ändern, wird das Ereignisobjekt bei der nächsten Aktualisierung des Bildschirms ausgelöst.

Parameter

Verwandte API-Elemente

Legt den Fokus auf diese Komponente. Die Komponente kann den Fokus wiederum an eine Unterkomponente weitergeben.

Hinweis: Wenn der Fokus mit dieser Methode festgelegt wird, erfolgt die Fokusanzeige nur bei den TextInput- und TextArea-Komponenten. Wenn Sie mit der Tabulatortaste zu einer Komponente wechseln, wird die Fokusanzeige für alle Komponenten eingeblendet.

Legt eine bestimmte Breite und Höhe für die Komponente fest.

Parameter

Legt eine Stileigenschaft für diese Komponenteninstanz fest. Dieser Stil kann einen global festgelegten Stil überschreiben.

Wenn diese Methode aufgerufen wird, kann sich die Systemleistung verschlechtern. Verwenden Sie diese Methode nur, wenn unbedingt notwendig.

Parameter

Verwandte API-Elemente

import fl.controls.Button;

var myFormat:TextFormat = new TextFormat();
myFormat.font = "Georgia";

var b:Button = new Button();
b.label = "Hello World";
b.setStyle("textFormat", myFormat);
addChild(b);

import fl.controls.Button;

var flashIcon:Loader = new Loader();
flashIcon.contentLoaderInfo.addEventListener(Event.COMPLETE, completeHandler);
flashIcon.load(new URLRequest("http://www.helpexamples.com/flash/images/logo.png"));

var myButton:Button = new Button();
myButton.label = "Flash";
myButton.move(10, 10);
addChild(myButton);

function completeHandler(event:Event):void {
    flashIcon.width = 16;
    flashIcon.height = 16;
    myButton.setStyle("icon", flashIcon);
}

Die Eigenschaften und das Layout des Objekts werden geprüft und aktualisiert. Das Objekt wird ggf. neu erstellt.

Eigenschaften, die eine umfangreiche Berechnung erfordern, werden in der Regel erst verarbeitet, nachdem das Skript ausgeführt wurde. Grund dafür ist, dass das Festlegen einer Eigenschaft unter Umständen das Verarbeiten anderer Eigenschaften zur Folge hat. Wenn Sie beispielsweise die Eigenschaft width festlegen, muss unter Umständen die Breite von über- oder untergeordneten Objekten ebenfalls neu berechnet werden. Falls die Breite eines Objekts vom Skript öfter als einmal neu berechnet wird, müssen abhängige Eigenschaften unter Umständen ebenfalls neu berechnet werden. Verwenden Sie diese Methode, um dieses Verhalten manuell zu überschreiben.

Wird ausgelöst, wenn die Sichtbarkeit der Komponente von sichtbar zu unsichtbar wechselt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;

var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);

var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);


function changeHandler(event:Event):void {
    toggleButton.emphasized = toggleButton.selected;
    myList.visible = toggleButton.selected;
}

function hideHandler(event:ComponentEvent):void {
    trace("hiding list");
    myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function showHandler(event:ComponentEvent):void {
    trace("showing list");
    myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function itemRollOverHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

function itemRollOutHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

Verwandte API-Elemente

Wird nach dem Verschieben einer Komponente ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.ComponentEvent;
import fl.events.SliderEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 20); 
myUILoader.addEventListener(ComponentEvent.MOVE, moveHandler);
addChild(myUILoader);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.minimum = myUILoader.x;
mySlider.maximum = myUILoader.x + 200;
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myUILoader.x = event.value;
}

function moveHandler(event:ComponentEvent):void {
    trace("[move] x:" + event.currentTarget.x + ", y:" + event.currentTarget.y);
}

Wird ausgelöst, wenn die Größe der Komponente geändert wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var myImg:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - myImg.width) / 2;
    var newY:uint = (stage.stageHeight - myImg.height) / 2;
    myImg.move(newX, newY);
}

Wird ausgelöst, wenn die Sichtbarkeit der Komponente von unsichtbar zu sichtbar wechselt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;

var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);

var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);


function changeHandler(event:Event):void {
    toggleButton.emphasized = toggleButton.selected;
    myList.visible = toggleButton.selected;
}

function hideHandler(event:ComponentEvent):void {
    trace("hiding list");
    myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function showHandler(event:ComponentEvent):void {
    trace("showing list");
    myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function itemRollOverHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

function itemRollOutHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

Verwandte API-Elemente

Die Versionsnummer der Komponenten.

import fl.controls.CheckBox;

var myCheckBox:CheckBox = new CheckBox();
trace(myCheckBox.version);