Пакетfl.controls.listClasses
Классpublic class ListData
НаследованиеListData Inheritance Object
Подклассы TileListData

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Класс ListData отправляет сообщения и содержит данные, относящиеся к определенной ячейке в компоненте на основе списка. Эта информация включает метку и значок, которые связаны с ячейкой независимо от того, выбрана ли она, а также положение ячейки в списке (строка и столбец).

Каждый раз при аннулировании средства визуализации создается новый компонент ListData.

Посмотреть примеры



Общедоступные свойства
 СвойствоОпределено
  column : uint
[только для чтения] Столбец, в котором отображается элемент данных.
ListData
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  icon : Object
[только для чтения] Класс, представляющий значок для элемента в компоненте List, который вычисляется с помощью метода класса List.
ListData
  index : uint
[только для чтения] Индекс элемента в поставщике данных.
ListData
  label : String
[только для чтения] Метка, отображаемая в ячейке.
ListData
  owner : UIComponent
[только для чтения] Ссылка на объект List, который является владельцем данного элемента.
ListData
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  row : uint
[только для чтения] Строка, в которой отображается элемент данных.
ListData
Общедоступные методы
 МетодОпределено
  
ListData(label:String, icon:Object, owner:UIComponent, index:uint, row:uint, col:uint = 0)
Создает новый экземпляр класса ListData в соответствии с заданными параметрами.
ListData
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
columnсвойство
column:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Столбец, в котором отображается элемент данных. В списке это значение всегда равно 0.


Реализация
    public function get column():uint
iconсвойство 
icon:Object  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Класс, представляющий значок для элемента в компоненте List, который вычисляется с помощью метода класса List.


Реализация
    public function get icon():Object
indexсвойство 
index:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Индекс элемента в поставщике данных.


Реализация
    public function get index():uint
labelсвойство 
label:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Метка, отображаемая в ячейке.


Реализация
    public function get label():String
ownerсвойство 
owner:UIComponent  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Ссылка на объект List, который является владельцем данного элемента.


Реализация
    public function get owner():UIComponent
rowсвойство 
row:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Строка, в которой отображается элемент данных.


Реализация
    public function get row():uint
Сведения о конструкторе
ListData()Конструктор
public function ListData(label:String, icon:Object, owner:UIComponent, index:uint, row:uint, col:uint = 0)

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Создает новый экземпляр класса ListData в соответствии с заданными параметрами.

Параметры
label:String — Метка, отображаемая в ячейке.
 
icon:Object — Значок, отображаемый в этой ячейке.
 
owner:UIComponent — Компонент, которому принадлежит эта ячейка.
 
index:uint — Индекс элемента в поставщике данных.
 
row:uint — Строка, в которой отображается этот элемент. В компонентах List или DataGrid это значение соответствует индексу. В компоненте TileList это значение может отличаться от индекса.
 
col:uint (default = 0) — Столбец, в котором отображается этот элемент. В компоненте List это значение всегда равно 0.
Примеры Как пользоваться примерами
ListDataExample.as

В этом примере показано, как выполняется доступ к свойству listData средства визуализации ячейки.

Чтобы применить этот пример на практике, выполните следующие действия.

  1. Добавьте компоненты List и Button в библиотеку.
  2. Сохраните этот код под именем ListDataExample.as в том же каталоге, где и FLA-файл.
  3. Присвойте классу Document в FLA-файле значение ListDataExample.
package 
{
    import fl.controls.List;
    import fl.controls.listClasses.CellRenderer;
    import fl.controls.listClasses.ListData;
    import fl.events.ListEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.text.TextField;
    
    public class ListDataExample extends Sprite
    {
        var sampleItem1:Object = { label:"John Alpha" };
        var sampleItem2:Object = { label:"Mary Bravo" };
        var sampleItem3:Object = { label:"Trevor Gamma" };
        var sampleItem4:Object = { label:"Susan Delta" };        
        
        var myList:List;
        var tf:TextField;

        public function ListDataExample() {
            createList();

            tf = new TextField();
            tf.x = 10;
            tf.y = 125;
            addChild(tf);
        }
        private function createList():void {
            myList = new List();
            myList.move(10,10);
            myList.addItem(sampleItem1);
            myList.addItem(sampleItem2);
            myList.addItem(sampleItem3);
            myList.addItem(sampleItem4);
            myList.rowCount = 4;
            
            myList.addEventListener(ListEvent.ITEM_CLICK,listItemSelected);
            addChild(myList);
        }
        private function listItemSelected(e:ListEvent):void {
            var cr:CellRenderer = myList.itemToCellRenderer(e.item) as CellRenderer;
            var listData:ListData = cr.listData;

            tf.text = "Row selected: " + listData.row;
        }
    }
}