Пакет | fl.controls |
Класс | public class List |
Наследование | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Реализует | IFocusManagerComponent |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Компонент List состоит из элементов, строк и поставщика данных, которые описываются следующим образом:
- Элемент: объект ActionScript, который обычно содержит свойство
label
с описанием и свойствоdata
, где хранятся данные, связанные с этим элементом. - Строка: компонент, который применяется для показа элемента.
- Поставщик данных: компонент, который моделирует элементы, показываемые компонентом List.
По умолчанию компонент List использует класс CellRenderer для обеспечения строк, в которых выполняется показ элементов списка. Эти строки можно использовать программным методом; обычно это происходит путем создания подклассов класса CellRenderer. Класс CellRenderer реализует интерфейс ICellRenderer, который предоставляет набор свойств и методов, используемых компонентом List для манипуляции строками, а также отправки данных и информации о состоянии в каждую строку для показа. В нее включены сведения о размере и выделении данных.
Компонент List обеспечивает методы, которые оказывают влияние на поставщика данных (например, методы addItem()
и removeItem()
). Эти и другие методы можно использовать для манипуляции данными любого массива, который существует в том же кадре, что и компонент List и последующей трансляции изменений в нескольких представлениях. Если компонент List не имеет внешнего поставщика данных, эти методы автоматически создают экземпляр поставщика данных и предоставляют его с помощью свойства List.dataProvider
. Компонент List визуализирует каждую строку с помощью спрайта, в котором реализован интерфейс ICellRenderer. Чтобы указать это средство визуализации, воспользуйтесь свойством List.cellRenderer
. Можно также создать или загрузить с сервера экземпляр Array, а затем использовать его в качестве модели данных для нескольких списков, полей со списком, сеток данных и т.д.
Свойство | Определено | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | ||
allowMultipleSelection : Boolean
Определяет логическое значение, указывающее, можно ли одновременно выбрать несколько элементов списка. | SelectableList | ||
alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | ||
blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | ||
blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | ||
buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | ||
cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | 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 | ||
metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | ||
mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | ||
numChildren : int [только для чтения]
Возвращает число дочерних элементов данного объекта. | DisplayObjectContainer | ||
opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | ||
parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | ||
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 | ||
softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | ||
stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | ||
tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | ||
tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | ||
tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | ||
useBitmapScrolling : Boolean
При значении true свойству cacheAsBitmap для прокручиваемого содержимого устанавливается значение true. При значении false данное значение отключается. | BaseScrollPane | ||
useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | ||
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() с заданной точкой point. | DisplayObjectContainer | ||
Удаляет стиль, установленный для средств визуализации списка. | SelectableList | ||
Удаляет элемент, выбранный в списке в настоящий момент, и устанавливает свойство selectedIndex в значение -1. | SelectableList | ||
Удаляет свойство style для экземпляра компонента. | UIComponent | ||
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | ||
Посылает событие в поток событий. | EventDispatcher | ||
Отображает или скрывает индикатор фокуса этого компонента. | UIComponent | ||
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow). | UIComponent | ||
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | ||
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | ||
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | ||
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | ||
Возвращает объект, который в настоящее время имеет фокус. | UIComponent | ||
Возвращает элемент в положении, заданном индексом. | SelectableList | ||
Возвращает индекс следующего элемента в объекте dataProvider, где первый символ метки совпадает с указанным символом строки. | SelectableList | ||
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | ||
Возвращает стиль, установленный для средств визуализации списка. | SelectableList | ||
Возвращает свойство style, установленное в последовательности для поиска стилей компонента. | UIComponent | ||
[статические]
Возвращает карту стилей по умолчанию для текущего компонента. | List | ||
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | ||
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | ||
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | ||
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное. | UIComponent | ||
Аннулирует указанное средство визуализации элементов. | SelectableList | ||
Аннулирует средство визуализации для элемента в заданном положении индекса. | SelectableList | ||
Аннулирует весь список и инициирует обновление всех элементов списка. | SelectableList | ||
Проверяет, выбран ли указанный элемент списка. | SelectableList | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Возвращает интерфейс ICellRenderer для заданного объекта элемента, если таковой существует. | SelectableList | ||
[переопределить]
Возвращает строку, которая должна отображаться средством визуализации для указанного объекта данных на основе свойств labelField и labelFunction. | List | ||
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | ||
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | ||
[статические]
Объединяет стили из нескольких классов в одном объекте. | UIComponent | ||
Перемещает компонент в указанное положение в пределах его родительского компонента. | UIComponent | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет все элементы из списка. | SelectableList | ||
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Удаляет указанный элемент из списка. | SelectableList | ||
Удаляет элемент в заданном положении индекса. | SelectableList | ||
Заменяет элемент в положении, заданном индексом, другим элементом. | SelectableList | ||
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
[переопределить]
Прокручивает список до элемента с указанным индексом. | List | ||
Прокручивает список до элемента, индекс которого определяется текущим значением свойства selectedIndex. | SelectableList | ||
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | DisplayObjectContainer | ||
Задает фокус на этот компонент. | UIComponent | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Задает стиль средств визуализации списка. | SelectableList | ||
Задает указанную высоту и ширину компонента. | UIComponent | ||
Задает свойство style для экземпляра компонента. | UIComponent | ||
Сортирует элементы, предоставляемые текущим поставщиком данных. | SelectableList | ||
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям. | SelectableList | ||
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | ||
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | ||
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | ||
Завершает метод startDrag(). | Sprite | ||
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | ||
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | ||
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | DisplayObjectContainer | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости. | UIComponent | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
iconField | свойство |
iconField:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает имя поля в объекте dataProvider
, отображаемое в качестве метки поля TextInput и раскрывающегося списка.
Этот компонент по умолчанию показывает свойство label
для каждого элемента dataProvider
. Если элементы dataProvider
не содержат свойство label
, свойство labelField
можно задать, чтобы воспользоваться другим свойством.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Значением по умолчанию является "label".
Реализация
public function get labelField():String
public function set labelField(value:String):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает число строк, видимых в списке хотя бы частично.
Реализация
override public function get rowCount():uint
override 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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает высоту каждой строки списка (в пикселах).
Значением по умолчанию является 20.
Реализация
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Конструктор |
public function List()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Создает новый экземпляр компонента List.
getStyleDefinition | () | метод |
public static function getStyleDefinition():Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat
содержит значение null
или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle()
по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat
, выбранный по умолчанию для указанного компонента:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Объект стилей по умолчанию.
|
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Прокручивает список до элемента с указанным индексом. Если индекс выходит за пределы диапазона, положение прокрутки не меняется.
Параметры
newCaretIndex:int — Положение индекса, до которого выполняется прокрутка.
|
- Добавьте в библиотеку классы List, Button и Label.
- Сохраните этот код под именем ListExample.as в том же каталоге, где и FLA-файл.
- Присвойте параметру DocumentClass в FLA-файле значение ListExample.
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.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); } } }
Tue Jun 12 2018, 11:34 AM Z