| Пакет | spark.components.gridClasses |
| Интерфейс | public interface IGridItemRenderer extends IDataRenderer , IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Средство реализации | DefaultGridItemRenderer, GridItemRenderer, UITextFieldGridItemRenderer |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Все свойства средства визуализации элементов устанавливаются во время выполнения метода updateDisplayList() его вышестоящего элемента. После установки свойств вызывается методprepare() средства визуализации элементов. Реализация IGridItemRenderer должна изменить метод prepare(), чтобы окончательно отредактировать его свойства или любой аспект его визуальных элементов. Как правило, метод prepare() используется для настройки визуальных элементов средства визуализации на основе свойства data.
Если средство визуализации элементов больше не требуется, так как оно будет добавлено к внутреннему свободному списку многократно используемых средств визуализации или больше не будет использоваться, вызывается метод discard() в IGridItemRenderer.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | IVisualElement | |
| baseline : Object
Вертикальное смещение в пикселях от целевого объекта привязки к положению базовой линии элемента управления. | ILayoutElement | |
| baselinePosition : Number [только для чтения]
Координата Y базовой линии первой строки текста компонента. | ILayoutElement | |
| bottom : Object
Вертикальное смещение в пикселях от нижнего края компонента к нижнему краю целевого объекта привязки. | ILayoutElement | |
| column : GridColumn
Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов. | IGridItemRenderer | ||
| columnIndex : int [только для чтения]
Индекс столбца для ячейки этого средства визуализации элементов. | IGridItemRenderer | ||
| data : Object
Данные для отображения или редактирования. | IDataRenderer | |
| depth : Number
Определяет порядок отображения элементов внутри контейнеров. | IVisualElement | |
| designLayer : DesignLayer
Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом. | IVisualElement | |
| down : Boolean
Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. | IGridItemRenderer | ||
| dragging : Boolean
Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. | IGridItemRenderer | ||
| grid : Grid [только для чтения]
Сетка, связанная с этим средством визуализации элементов; как правило, является значением column.grid. | IGridItemRenderer | ||
| hasLayoutMatrix3D : Boolean [только для чтения]
Содержит true, если элемент имеет трехмерную матрицу. | ILayoutElement | |
| height : Number
Указывает высоту экранного объекта в пикселях. | IVisualElement | |
| horizontalCenter : Object
Горизонтальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки. | ILayoutElement | |
| hovered : Boolean
Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS. | IGridItemRenderer | ||
| includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | ILayoutElement | |
| is3D : Boolean [только для чтения]
Содержит true, если элемент представлен в трехмерной графике. | IVisualElement | |
| label : String
String для отображения в средстве визуализации. | IGridItemRenderer | ||
| layoutDirection : String
Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование). | ILayoutDirectionElement | |
| left : Object
Горизонтальное смещение в пикселях от левого края компонента к левому краю целевого объекта привязки. | ILayoutElement | |
| owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | IVisualElement | |
| parent : DisplayObjectContainer [только для чтения]
Вышестоящий контейнер или компонент данного компонента. | IVisualElement | |
| percentHeight : Number
Указывает высоту компонента в виде процента от размера вышестоящего элемента. | ILayoutElement | |
| percentWidth : Number
Указывает ширину компонента в виде процента от размера вышестоящего элемента. | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта. | IVisualElement | |
| right : Object
Горизонтальное смещение в пикселях от правого края компонента к правому краю целевого объекта привязки. | ILayoutElement | |
| rowIndex : int
Отсчитываемый от нуля индекс строки визуализируемой ячейки. | IGridItemRenderer | ||
| selected : Boolean
Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора. | IGridItemRenderer | ||
| showsCaret : Boolean
Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки. | IGridItemRenderer | ||
| top : Object
Вертикальное смещение в пикселях от верхнего края компонента к верхнему краю целевого объекта привязки. | ILayoutElement | |
| verticalCenter : Object
Вертикальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки. | ILayoutElement | |
| visible : Boolean
Управляет видимостью данного визуального элемента. | IVisualElement | |
| width : Number
Указывает ширину экранного объекта в пикселях. | IVisualElement | |
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IVisualElement | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IVisualElement | |
| Метод | Определено | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым. | IGridItemRenderer | ||
|
Посылает событие в поток событий. | IEventDispatcher | |
|
Возвращает координату Х границ элемента для указанного размера элемента. | ILayoutElement | |
|
Возвращает координату Y границ элемента при указанном размере элемента. | ILayoutElement | |
|
Возвращает высоту макета элемента. | ILayoutElement | |
|
Возвращает ширину макета элемента. | ILayoutElement | |
|
Возвращает координату Х, используемую элементом для отображения на экране. | ILayoutElement | |
|
Возвращает координату Y, используемую элементом для отображения на экране. | ILayoutElement | |
|
Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня. | ILayoutElement | |
|
Возвращает преобразование макета Matrix3D для этого элемента. | ILayoutElement | |
|
Возвращает максимальную высоту элемента. | ILayoutElement | |
|
Возвращает максимальную ширину элемента. | ILayoutElement | |
|
Возвращает минимальную высоту элемента. | ILayoutElement | |
|
Возвращает минимальную ширину элемента. | ILayoutElement | |
|
Возвращает предпочтительную высоту элемента. | ILayoutElement | |
|
Возвращает предпочтительную ширину элемента. | ILayoutElement | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | |
|
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | ILayoutDirectionElement | |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации. | IGridItemRenderer | ||
|
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | |
|
Устанавливает координаты, используемые элементом для отображения на экране. | ILayoutElement | |
|
Устанавливает размер макета элемента. | ILayoutElement | |
|
Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | ILayoutElement | |
|
Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | ILayoutElement | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. | ILayoutElement | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher | |
column | свойство |
column:GridColumn| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов.
Реализация
public function get column():GridColumn public function set column(value:GridColumn):voidcolumnIndex | свойство |
down | свойство |
down:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. Для свойства down восстанавливается значение false, когда пользователь отпускает кнопку мыши или больше не касается сенсорного экрана, а также если курсор или точка касания выходит за пределы ячейки сетки.
В отличие от средства визуализации элементов списка, средство визуализации элементов сетки не отвечает монопольно за отображение индикатора down. Сетка визуализирует индикатор down для выделенной строки или ячейки. Визуальные свойства средства визуализации элементов могут изменяться при нажатии.
Реализация
public function get down():Boolean public function set down(value:Boolean):voiddragging | свойство |
dragging:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. В настоящее время элемент управления Spark DataGrid не поддерживает перетаскивание.
Реализация
public function get dragging():Boolean public function set dragging(value:Boolean):voidgrid | свойство |
hovered | свойство |
hovered:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS.
В отличие от средства визуализации элементов списка, средства визуализации элементов сетки не отвечают монопольно за отображение того, что на средство визуализации элементов или строку, к которой оно принадлежит, наведен курсор мыши. Сетка автоматически отображает компонент темы оформления hoverIndicator для строки или ячейки, на которую наведен курсор мыши. Свойства средств визуализации элементов сетки могут изменяться, если на них наведен курсор мыши.
Реализация
public function get hovered():Boolean public function set hovered(value:Boolean):voidlabel | свойство |
label:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
String для отображения в средстве визуализации.
Класс GridItemRenderer автоматически копирует значение этого свойства в свойство text своего элемента labelDisplay, если этот элемент был указан. Сетка устанавливает label для значения, возвращенного методом itemToLabel() столбца.
Реализация
public function get label():String public function set label(value:String):voidСвязанные элементы API
rowIndex | свойство |
selected | свойство |
selected:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора.
В отличие от средства визуализации списка, средства визуализации элементов сетки не отвечают монопольно за отображение того, что они являются частью выбранной области. Сетка автоматически отображает компонент темы оформления selectionIndicator для выбранных строк или ячеек. Средство визуализации элементов может также изменить свои визуальные свойства для выражения того, что оно является компонентом выбора.
Реализация
public function get selected():Boolean public function set selected(value:Boolean):voidshowsCaret | свойство |
showsCaret:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки.
В отличие от средства визуализации элементов списка, средства визуализации элементов сетки не отвечают монопольно за отображение того, что их соответствующие ячейки или строки содержат символ вставки. Сетка автоматически отображает компонент темы оформления caretIndicator для строки или ячейки, содержащей символ вставки. Средство визуализации элементов также может изменить свои визуальные свойства для выражения того, что оно содержит символ вставки.
Реализация
public function get showsCaret():Boolean public function set showsCaret(value:Boolean):voiddiscard | () | метод |
public function discard(willBeRecycled:Boolean):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым. Если для параметра willBeRecycled устанавливается значение true, то владелец добавляет это средство визуализации к внутреннему свободному списку для повторного использования. Реализации могут использовать этот метод, чтобы удалить любые свойства средства визуализации, которые больше не являются необходимыми.
Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.
Параметры
willBeRecycled:Boolean — true, если это средство визуализации будет добавлено к внутреннему свободному списку владельца для повторного использования.
|
prepare | () | метод |
public function prepare(hasBeenRecycled:Boolean):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации. Для параметра hasBeenRecycled устанавливается значение false, если это средство визуализации не использовалось ранее, т. е. используется впервые. Метод вызывается непосредственно перед тем, как средство визуализации станет видимым, и при каждом его отображении вследствие изменения свойства средства визуализации или явного запроса на повторное отображение.
Этот метод можно использовать для настройки всех визуальных элементов и свойств средства визуализации. Использование этого метода может быть более эффективным, чем привязка свойств data к свойствам визуальных элементов. Примечание. Поскольку метод prepare() вызывается достаточно часто, очень важно обеспечить эффективность его кода.
Метод prepare() может многократно вызываться перед вызовом метода discard().
Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.
Параметры
hasBeenRecycled:Boolean — true, если это средство визуализации используется повторно.
|
Tue Jun 12 2018, 11:34 AM Z