Пакет | fl.controls |
Класс | public class List |
Наследование | List ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Реализует | IFocusManagerComponent |
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Компонент List состоит из элементов, строк и поставщика данных, которые описываются следующим образом:
label
с описанием и свойство data
, где хранятся данные, связанные с этим элементом. По умолчанию компонент List использует класс CellRenderer для обеспечения строк, в которых выполняется показ элементов списка. Эти строки можно использовать программным методом; обычно это происходит путем создания подклассов класса CellRenderer. Класс CellRenderer реализует интерфейс ICellRenderer, который предоставляет набор свойств и методов, используемых компонентом List для манипуляции строками, а также отправки данных и информации о состоянии в каждую строку для показа. В нее включены сведения о размере и выделении данных.
Компонент List обеспечивает методы, которые оказывают влияние на поставщика данных (например, методы addItem()
и removeItem()
). Эти и другие методы можно использовать для манипуляции данными любого массива, который существует в том же кадре, что и компонент List и последующей трансляции изменений в нескольких представлениях. Если компонент List не имеет внешнего поставщика данных, эти методы автоматически создают экземпляр поставщика данных и предоставляют его с помощью свойства List.dataProvider
. Компонент List визуализирует каждую строку с помощью спрайта, в котором реализован интерфейс ICellRenderer. Чтобы указать это средство визуализации, воспользуйтесь свойством List.cellRenderer
. Можно также создать или загрузить с сервера экземпляр Array, а затем использовать его в качестве модели данных для нескольких списков, полей со списком, сеток данных и т.д.
Свойство | Определено | ||
---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
![]() | allowMultipleSelection : Boolean
Определяет логическое значение, указывающее, можно ли одновременно выбрать несколько элементов списка. | SelectableList | |
![]() | alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
![]() | blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
![]() | blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
![]() | buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
![]() | cacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | contextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
![]() | dataProvider : DataProvider
Определяет или задает модель данных для списка просматриваемых элементов. | SelectableList | |
![]() | doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | |
![]() | dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен. | Sprite | |
![]() | enabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем. | UIComponent | |
![]() | filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
![]() | focusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | |
![]() | focusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
![]() | focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
![]() | graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
![]() | height : Number
Определяет или задает высоту компонента (в пикселах). | UIComponent | |
![]() | hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
![]() | horizontalLineScrollSize : Number
Определяет или задает значение, показывающее протяженность прокрутки по горизонтали при щелчке стрелки прокрутки. | BaseScrollPane | |
![]() | horizontalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок горизонтальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки. | BaseScrollPane | |
![]() | horizontalScrollBar : ScrollBar [только для чтения]
Определяет ссылку на горизонтальную полосу прокрутки. | BaseScrollPane | |
![]() | horizontalScrollPolicy : String
Определяет или задает значение, показывающее состояние горизонтальной полосы прокрутки. | BaseScrollPane | |
![]() | horizontalScrollPosition : Number
Определяет или задает значение, показывающее положение горизонтальной полосы прокрутки на панели прокрутки (в пикселах). | BaseScrollPane | |
iconField : String
Определяет или задает поле элемента, содержащее значок для данного элемента. | List | ||
iconFunction : Function
Определяет или задает функцию, используемую для получения значка элемента. | List | ||
labelField : String
Определяет или задает имя поля в объекте dataProvider, отображаемое в качестве метки поля TextInput и раскрывающегося списка. | List | ||
labelFunction : Function
Определяет или задает функцию, используемую для получения метки элемента. | List | ||
![]() | length : uint [только для чтения]
Определяет число элементов, предоставляемых поставщиком данных. | SelectableList | |
![]() | loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
![]() | mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
![]() | maxHorizontalScrollPosition : Number
Определяет или задает величину, на которую список прокручивается вправо, если свойство horizontalScrollPolicy имеет значение ScrollPolicy.ON (в пикселах). | SelectableList | |
![]() | maxVerticalScrollPosition : Number [только для чтения]
Определяет максимальное положение по вертикали при прокрутке текущего содержимого (в пикселах). | BaseScrollPane | |
![]() | mouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши. | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши. | InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | |
![]() | mouseX : Number [только для чтения]
Указывает координату x положения курсора мыши (в пикселах). | DisplayObject | |
![]() | mouseY : Number [только для чтения]
Указывает координату y положения курсора мыши (в пикселах). | DisplayObject | |
![]() | name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
![]() | numChildren : int [только для чтения]
Возвращает число потомков данного объекта. | DisplayObjectContainer | |
![]() | opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
![]() | parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
![]() | root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
![]() | rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
![]() | rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
rowCount : uint
Определяет или задает число строк, видимых в списке хотя бы частично. | List | ||
rowHeight : Number
Определяет или задает высоту каждой строки списка (в пикселах). | List | ||
![]() | scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
![]() | scaleX : Number
Умножает текущую ширину компонента на коэффициент масштабирования. | UIComponent | |
![]() | scaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования. | UIComponent | |
![]() | scaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
![]() | scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
![]() | selectable : Boolean
Определяет или задает логическое значение, указывающее, можно ли выбирать элементы списка. | SelectableList | |
![]() | selectedIndex : int
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента. | SelectableList | |
![]() | selectedIndices : Array
Определяет или задает массив, содержащий элементы, которые выбраны из списка, допускающего выбор нескольких элементов. | SelectableList | |
![]() | selectedItem : Object
Определяет или задает элемент, выбранный в списке, допускающем выбор одного элемента. | SelectableList | |
![]() | selectedItems : Array
Определяет или задает массив, содержащий объекты для элементов, которые выбраны из списка, допускающего выбор нескольких элементов. | SelectableList | |
![]() | soundTransform : SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
![]() | stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
![]() | tabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab. | DisplayObjectContainer | |
![]() | tabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab. | InteractiveObject | |
![]() | tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
![]() | textSnapshot : TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() | transform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
![]() | useBitmapScrolling : Boolean
При значении true свойству cacheAsBitmap для прокручиваемого содержимого устанавливается значение true. При значении false данное значение отключается. | BaseScrollPane | |
![]() | useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
![]() | version : String = "3.0.0.15"
Номер версии компонентов. | UIComponent | |
![]() | verticalLineScrollSize : Number
Определяет или задает значение, показывающее число пикселов, на которое производится прокрутка по вертикали при щелчке стрелки прокрутки. | BaseScrollPane | |
![]() | verticalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок вертикальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки. | BaseScrollPane | |
![]() | verticalScrollBar : ScrollBar [только для чтения]
Определяет ссылку на вертикальную полосу прокрутки. | BaseScrollPane | |
![]() | verticalScrollPolicy : String
Определяет или задает значение, показывающее состояние вертикальной полосы прокрутки. | BaseScrollPane | |
![]() | verticalScrollPosition : Number
Определяет или задает значение, показывающее положение вертикальной полосы прокрутки на панели прокрутки (в пикселах). | BaseScrollPane | |
![]() | visible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента. | UIComponent | |
![]() | width : Number
Определяет или задает ширину компонента (в пикселах). | UIComponent | |
![]() | x : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера. | UIComponent | |
![]() | y : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера. | UIComponent | |
![]() | z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject |
Метод | Определено | ||
---|---|---|---|
List()
Создает новый экземпляр компонента List. | List | ||
![]() |
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. | EventDispatcher | |
![]() |
Добавляет элемент в конец списка элементов. | SelectableList | |
![]() |
Вставляет элемент в положении списка, заданном индексом. | SelectableList | |
![]() |
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой. | DisplayObjectContainer | |
![]() |
Удаляет стиль, установленный для средств визуализации списка. | SelectableList | |
![]() |
Удаляет элемент, выбранный в списке в настоящий момент, и устанавливает свойство selectedIndex в значение -1. | SelectableList | |
![]() |
Удаляет свойство style для экземпляра компонента. | UIComponent | |
![]() |
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
![]() |
Передает событие в поток событий. | EventDispatcher | |
![]() |
Отображает или скрывает индикатор фокуса этого компонента. | UIComponent | |
![]() |
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow). | UIComponent | |
![]() | DisplayObject | ||
![]() |
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
![]() |
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | |
![]() |
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
![]() |
Возвращает позицию индекса для дочернего экземпляра DisplayObject. | DisplayObjectContainer | |
![]() | DisplayObject | ||
![]() |
Возвращает объект, который в настоящее время имеет фокус. | UIComponent | |
![]() |
Возвращает элемент в положении, заданном индексом. | SelectableList | |
![]() |
Возвращает индекс следующего элемента в объекте dataProvider, где первый символ метки совпадает с указанным символом строки. | SelectableList | |
![]() |
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур. | DisplayObject | |
![]() |
Возвращает стиль, установленный для средств визуализации списка. | SelectableList | |
![]() |
Возвращает свойство style, установленное в последовательности для поиска стилей компонента. | UIComponent | |
[статические]
Возвращает карту стилей по умолчанию для текущего компонента. | List | ||
![]() |
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные). | DisplayObject | |
![]() |
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним. | DisplayObject | |
![]() |
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
![]() |
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное. | UIComponent | |
![]() |
Аннулирует указанное средство визуализации элементов. | SelectableList | |
![]() |
Аннулирует средство визуализации для элемента в заданном положении индекса. | SelectableList | |
![]() |
Аннулирует весь список и инициирует обновление всех элементов списка. | SelectableList | |
![]() |
Проверяет, выбран ли указанный элемент списка. | SelectableList | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Возвращает интерфейс ICellRenderer для заданного объекта элемента, если таковой существует. | SelectableList | |
Возвращает строку, которая должна отображаться средством визуализации для указанного объекта данных на основе свойств labelField и labelFunction. | List | ||
![]() |
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
![]() | [статические]
Объединяет стили из нескольких классов в одном объекте. | UIComponent | |
![]() |
Перемещает компонент в указанное положение в пределах его родительского компонента. | UIComponent | |
![]() | DisplayObject | ||
![]() | DisplayObject | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Удаляет все элементы из списка. | SelectableList | |
![]() |
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
![]() |
Удаляет указанный элемент из списка. | SelectableList | |
![]() |
Удаляет элемент в заданном положении индекса. | SelectableList | |
![]() |
Заменяет элемент в положении, заданном индексом, другим элементом. | SelectableList | |
Прокручивает список до элемента с указанным индексом. | List | ||
![]() |
Прокручивает список до элемента, индекс которого определяется текущим значением свойства selectedIndex. | SelectableList | |
![]() |
Изменяет положение существующего потомка в DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Задает фокус на этот компонент. | UIComponent | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Задает стиль средств визуализации списка. | SelectableList | |
![]() |
Задает указанную высоту и ширину компонента. | UIComponent | |
![]() |
Задает свойство style для экземпляра компонента. | UIComponent | |
![]() |
Сортирует элементы, предоставляемые текущим поставщиком данных. | SelectableList | |
![]() |
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям. | SelectableList | |
![]() |
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
![]() |
Завершает метод startDrag(). | Sprite | |
![]() |
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта. | DisplayObjectContainer | |
![]() |
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков. | DisplayObjectContainer | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости. | UIComponent | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа. | EventDispatcher |
iconField | свойство |
iconField:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает поле элемента, содержащее значок для данного элемента.
Примечание. Свойство iconField
не используется, если свойству iconFunction
присвоена функция обратного вызова.
Значение по умолчанию "icon"
public function get iconField():String
public function set iconField(value:String):void
RedBox
, в свойствах которого включен параметр "Экспорт для ActionScript":import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { iconSource:RedBox, label:"Item 1" } ); dp.addItem( { iconSource:RedBox, label:"Item 2" } ); dp.addItem( { iconSource:RedBox, label:"Item 3" } ); var list:List = new List(); list.iconField = "iconSource"; list.dataProvider = dp; addChild(list);
iconFunction | свойство |
iconFunction:Function
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает функцию, используемую для получения значка элемента.
Примечание. Свойство iconField
не используется, если свойству iconFunction
присвоена функция обратного вызова.
Значение по умолчанию null
public function get iconFunction():Function
public function set iconFunction(value:Function):void
iconFunction
, присваивающее значок ограниченному числу элементов в списке. Чтобы этот пример правильно выполнялся, в библиотеке должен существовать символ с именем RedBox
, в свойствах которого включен параметр "Экспорт для ActionScript": import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { label:"Item 1" } ); dp.addItem( { label:"Item 2" } ); dp.addItem( { label:"Item 3" } ); var list:List = new List(); list.iconFunction = determineIcon; list.dataProvider = dp; addChild(list); function determineIcon(item:Object):String { if(item.label == "Item 2") { return "RedBox"; } else { return null; } }
labelField | свойство |
labelField:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает имя поля в объекте dataProvider
, отображаемое в качестве метки поля TextInput и раскрывающегося списка.
Этот компонент по умолчанию показывает свойство label
для каждого элемента dataProvider
. Если элементы dataProvider
не содержат свойство label
, свойство labelField
можно задать, чтобы воспользоваться другим свойством.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Значение по умолчанию "label"
public function get labelField():String
public function set labelField(value:String):void
См. также
abbreviatedLabel
, а не свойством по умолчанию label
:import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { abbreviatedLabel:"NY", label:"New York" } ); dp.addItem( { abbreviatedLabel:"CA", label:"California" } ); dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } ); dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } ); dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } ); var list:List = new List(); list.setSize(40,100); list.labelField = "abbreviatedLabel" list.dataProvider = dp; addChild(list);
labelFunction | свойство |
labelFunction:Function
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает функцию, используемую для получения метки элемента.
Этот компонент по умолчанию показывает свойство label
для элемента dataProvider
. Но некоторые наборы данных могут не иметь поля label
или иметь поле, значение которого можно использовать в качестве метки без изменений. Так, например, в определенном наборе данных могут храниться полные имена, но их поддержка выполняется с помощью полей lastName
и firstName
. В подобном случае данное свойство можно использовать для установки функции обратного вызова, которая объединяет значения полей lastName
и firstName
в показываемой строке полного имени.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Значение по умолчанию null
public function get labelFunction():Function
public function set labelFunction(value:Function):void
labelFunction
списка присваивается функция, которая форматирует строку, показываемую в каждой ячейке:
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
rowCount | свойство |
rowCount:uint
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает число строк, видимых в списке хотя бы частично.
public function get rowCount():uint
public function set rowCount(value:uint):void
rowCount
:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); var i:uint; for(i=0; i<100; i++) { dp.addItem( { label: "Item " + i } ); } var list:List = new List(); list.setSize(100,300); list.dataProvider = dp; addChild(list); trace(list.rowCount); // 15
rowCount
, основанного на текущем значении ползунка:
import fl.controls.Slider; import fl.controls.List; import fl.data.DataProvider; import fl.events.SliderEvent; var dp:DataProvider = new DataProvider(); var i:int; for (i=0; i<8; i++) { dp.addItem({label:"Item " + i}); } var mySlider:Slider = new Slider(); mySlider.move(10, 10); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 2; mySlider.maximum = 9; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myList:List = new List(); myList.dataProvider = dp; myList.move(mySlider.x, mySlider.y + 20); myList.setSize(100, 50); addChild(myList); function changeHandler(event:SliderEvent):void { myList.rowCount = event.value; }
rowHeight | свойство |
rowHeight:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает высоту каждой строки списка (в пикселах).
Значение по умолчанию 20
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Конструктор |
public function List()
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Создает новый экземпляр компонента List.
getStyleDefinition | () | метод |
public static function getStyleDefinition():Object
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat
содержит значение null
или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle()
по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat
, выбранный по умолчанию для указанного компонента:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Объект стилей по умолчанию.
|
См. также
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; }
itemToLabel | () | метод |
override public function itemToLabel(item:Object):String
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Извлекает строку, показываемую средством визуализации для указанного объекта данных, исходя из значений свойств labelField
и labelFunction
.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Параметры
item:Object — Объект, создаваемый путем визуализации.
|
String — Отображаемая строка на основе данных.
|
import fl.controls.List; import fl.data.DataProvider; import fl.events.ListEvent; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({label:"Carrot", price:0.43}); myDataProvider.addItem({label:"Tomato", price:0.34}); myDataProvider.addItem({label:"Blueberry", price:0.72}); myDataProvider.addItem({label:"Turnip", price:0.24}); var myList:List = new List(); myList.setSize(300,80); myList.dataProvider = myDataProvider; myList.labelFunction = myLabelFunction; myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel); addChild(myList); function myLabelFunction(item:Object):String { return item.label + " - Current price: ($" + item.price.toFixed(2) + ")"; } function announceLabel(e:ListEvent):void { var list:List = e.target as List; var item:Object = e.item; trace("Label: " + item.label); trace("Label displayed: " + list.itemToLabel(item)); }
scrollToIndex | () | метод |
override public function scrollToIndex(newCaretIndex:int):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Прокручивает список до элемента с указанным индексом. Если индекс выходит за пределы диапазона, положение прокрутки не меняется.
Параметры
newCaretIndex:int — Положение индекса, до которого выполняется прокрутка.
|
package { import flash.display.Sprite public class ListExample extends Sprite { import flash.events.*; import fl.data.DataProvider; import fl.controls.List import fl.controls.Label import fl.controls.Button private var clearButton:Button; private var availableItems:List; private var selectedItemList:List; private var selectedItemsList:List; public function ListExample() { createComponents(); setupComponents(); } private function setupComponents():void { var dp:Array = new Array(); var i:uint; var count:uint = availableItems.rowCount * 2; for (i = 0; i < count; i++) { dp.push({label:"Item " + i}); } availableItems.allowMultipleSelection = true; availableItems.dataProvider = new DataProvider(dp); availableItems.dataProvider = new DataProvider(dp); availableItems.addEventListener(Event.CHANGE, updateLists); clearButton.addEventListener(MouseEvent.CLICK, clearHandler); } private function clearHandler(event:MouseEvent):void { availableItems.clearSelection(); // clear data providers selectedItemList.dataProvider = new DataProvider(); selectedItemsList.dataProvider = new DataProvider(); } private function updateLists(e:Event):void { selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider(); selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems); } private function createComponents():void { clearButton = new Button(); availableItems = new List(); selectedItemList = new List(); selectedItemsList = new List(); var availableItemsLabel:Label = new Label(); var selectedItemListLabel:Label = new Label(); var selectedItemsListLabel:Label = new Label(); clearButton.move(10,142); availableItems.move(10,32); selectedItemList.move(120,32); selectedItemsList.move(230,32); availableItemsLabel.move(10,10); selectedItemListLabel.move(120,10); selectedItemsListLabel.move(230,10); clearButton.label = "Clear Selection" availableItemsLabel.text = "Available Items"; selectedItemListLabel.text = "Selected Item"; selectedItemsListLabel.text = "All Selected Items"; addChild(clearButton); addChild(availableItems); addChild(selectedItemList); addChild(selectedItemsList); addChild(availableItemsLabel); addChild(selectedItemListLabel); addChild(selectedItemsListLabel); } } }