ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
fl.controls.listClasses 

ICellRenderer  - AS3 Flash

Paketfl.controls.listClasses
Schnittstellepublic interface ICellRenderer
Umsetzer CellRenderer, DataGridCellEditor, ImageCell

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Die ICellRenderer-Oberfläche stellt die Methoden und Eigenschaften bereit, die von einem CellRenderer benötigt werden. Alle benutzerdefinierten CellRenderer müssen diese Oberfläche implementieren. Alle benutzerdefinierten CellRenderer müssen entweder die UIComponent-Klasse oder eine Unterklasse der UIComponent-Klasse erweitern.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  data : Object
Ruft ein Objekt ab, das die mit einer Komponenten verknüpften Daten darstellt, oder legt dieses fest.
ICellRenderer
  listData : ListData
Ruft die Listeneigenschaften ab, die auf die Zelle angewendet werden (beispielsweise die Indexposition und ausgewählte Werte), oder legt diese fest.
ICellRenderer
  selected : Boolean
Ruft einen booleschen Wert ab bzw. legt einen booleschen Wert fest, der angibt, ob die aktuelle Zelle ausgewählt ist.
ICellRenderer
  x : Number
[Nur Schreiben] Legt die x-Koordinate des CellRenderers fest
ICellRenderer
  y : Number
[Nur Schreiben] Legt die y-Koordinate des CellRenderers fest
ICellRenderer
Öffentliche Methoden
 MethodeDefiniert von
  
Legt für die aktuelle Zelle einen spezifischen Mausstatus fest.
ICellRenderer
  
setSize(width:Number, height:Number):void
Legt die Größe der Daten gemäß den Pixelwerten in den Höhen- und Breitenparametern fest.
ICellRenderer
Eigenschaftendetails

data

Eigenschaft
data:Object

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft ein Objekt ab, das die mit einer Komponenten verknüpften Daten darstellt, oder legt dieses fest. Wenn dieser Wert festgelegt wurde, werden die Komponentendaten gespeichert; die Komponente, die diese enthält, wird entwertet. Die entwertete Komponente wird automatisch neu erstellt.

Die Data-Eigenschaft stellt ein Objekt dar, das das Element im DataProvider enthält, das die Zelle repräsentiert. In der Regel enthält die Data-Eigenschaft Standardwerte, die je nach Komponententyp variieren. Die Daten in der List- oder ComboBox-Komponente von CellRenderer enthalten eine Beschriftung, ein Symbol und Dateneigenschaften; eine TileList: eine Beschriftung oder eine Quelleigenschaft; eine DataGrid-Zelle enthält Werte für jede Spalte. Die Data-Eigenschaft kann auch benutzerspezifische Daten enthalten, die sich auf eine bestimmte Zelle beziehen. Benutzer können CellRenderer um eine Komponente erweitern, um unterschiedliche Dateneigenschaften bei der Wiedergabe der Zelle anzuwenden.

Darüber hinaus können Sie die Elemente labelField, labelFunction, iconField, iconFunction, sourceField und sourceFunction verwenden, um festzulegen, welche Eigenschaften zum Erstellen von Beschriftungen, Symbolen und Quellen verwendet werden sollen.



Implementierung
    public function get data():Object
    public function set data(value:Object):void

listData

Eigenschaft 
listData:ListData

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft die Listeneigenschaften ab, die auf die Zelle angewendet werden, z. B. die Werte index und selected, oder legt diese fest. Diese Listeneigenschaften werden automatisch aktualisiert, nachdem die Zelle entwertet wurde.



Implementierung
    public function get listData():ListData
    public function set listData(value:ListData):void

selected

Eigenschaft 
selected:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft einen booleschen Wert ab bzw. legt einen booleschen Wert fest, der angibt, ob die aktuelle Zelle ausgewählt ist. Der Wert true gibt an, dass die aktuelle Zelle ausgewählt ist, der Wert false, dass diese nicht ausgewählt ist.



Implementierung
    public function get selected():Boolean
    public function set selected(value:Boolean):void

x

Eigenschaft 
x:Number  [Nur Schreiben]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Legt die x-Koordinate des CellRenderers fest



Implementierung
    public function set x(value:Number):void

y

Eigenschaft 
y:Number  [Nur Schreiben]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Legt die y-Koordinate des CellRenderers fest



Implementierung
    public function set y(value:Number):void
Methodendetails

setMouseState

()Methode
public function setMouseState(state:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Legt für die aktuelle Zelle einen bestimmten Mausstatus fest. Diese Methode ist erforderlich, damit der Mausstatus von DataGrid für eine ganze Zeile festgelegt werden kann, wenn der Benutzer mit einer einzelnen Zelle interagiert.

Parameter

state:String — Ein String, der einen Mausstatus wie zum Beispiel "up" oder "over" festlegt.

setSize

()Methode 
public function setSize(width:Number, height:Number):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Legt die Größe der Daten gemäß den Pixelwerten in den Parametern width und height fest.

Parameter

width:Number — Die Breite, mit der der "CellRenderer" angezeigt wird (in Pixel).
 
height:Number — Die Höhe, mit der der "CellRenderer" angezeigt wird (in Pixel).

ICellRendererExample.as

In diesem Beispiel wird ein individueller CellRenderer durch Implementieren der ICellRenderer-Klasse erstellt.

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

  1. Fügen Sie die List- und Button-Komponenten zur Bibliothek hinzu.
  2. Speichern Sie diesen Code als "ICellRendererExample.as" im gleichen Verzeichnis wie die FLA-Datei.
  3. Legen Sie in der FLA-Datei für die Dokumentklasse den Wert "ICellRendererExample" fest.
package
{ 
    import fl.controls.List;
    import fl.data.DataProvider;
    import fl.events.ListEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    
    public class ICellRendererExample extends Sprite
    {
        public function ICellRendererExample() {
            var dp:DataProvider = new DataProvider();
            var totalEntries:Number = 42;
            var i:Number;
            for(i=0; i<totalEntries; i++) {
                dp.addItem( { label:Math.random(), data:null } );            
            }
            
            var myList = new List();
            myList.setSize(300,300);
            myList.move(10,10);
            myList.setStyle('cellRenderer', MyRenderer);    
            myList.dataProvider = dp;
            addChild(myList);
        }
    }
}
MyRenderer.as

Speichern Sie folgenden Code als "MyRenderer.as" im gleichen Verzeichnis wie die FLA-Datei.
package
{
    import fl.controls.LabelButton;
    import fl.controls.listClasses.ICellRenderer;
    import fl.controls.listClasses.ListData;
    
    public class MyRenderer extends LabelButton implements ICellRenderer {
        private var _listData:ListData;
        private var _data:Object;
        
        public function MyRenderer() {
        }

        public function set listData(newListData:ListData):void {
            _listData = newListData;
            label = "Random: " + _listData.label;
            drawRandomColor();
        }

        private function drawRandomColor():void {
            graphics.beginFill(Math.random()*0xFFFFFF);
            graphics.drawRect(0,0,20,20);
            graphics.endFill();            
        }

        public function get listData():ListData {
            return _listData;
        }

        public function set data(newData:Object):void {
            _data = newData;
        }

        public function get data():Object {
            return _data;
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.