| Пакет | spark.components.gridClasses |
| Класс | public class GridItemRenderer |
| Наследование | GridItemRenderer  Group GroupBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Реализует | IGridItemRenderer |
| Подклассы | AXMEnterpriseGridHeaderRenderer, DataGridItemRenderer, DefaultGridHeaderRenderer, DefaultGridHeaderRenderer |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Средства визуализации элементов связаны с каждым столбцом сетки. Средство визуализации элементов устанавливается для столбца с помощью свойства GridColumn.itemRenderer.
По умолчанию средство визуализации элементов не усекается в соответствии с границами ячейки. Если средство визуализации выходит за границы ячейки, установите для clipAndEnableScrolling значение true, чтобы выполнить усечение средства визуализации в соответствии с границами ячейки.
Переходы в средствах визуализации элементов DataGrid не поддерживаются. В классе GridItemRenderer выключено свойство transitions, поэтому установка этого свойства не будет иметь эффект.
Рекомендации по повышению производительности
Производительность прокрутки и запуска DataGrid непосредственно зависит от сложности средства визуализации элементов и количества таких средств, отображаемых в средстве прокрутки DataGrid. Поскольку пользовательские экземпляры GridItemRenderer постоянно используются, очень важно сделать их определения как можно более простыми и эффективными.
Если действия средства визуализации ограничены отображением одной или нескольких строк текста, разработчикам следует обратить внимание на класс DefaultItemRenderer, который выполняет эти действия более продуктивно. Использование класса UITextFieldGridItemRenderer вместо развертываемого в Windows приложения позволяет повысить производительность работы. Наиболее эффективным способом использования GridItemRenderer для отображения dataField элемента GridColumn в виде текста является присвоение элементу отображения текста GridItemRenderer значения id="labelDisplay". Компонент labelDisplay должен являться подклассом TextBase, например Label или RichText. Этот подход можно использовать вместо DefaultGridItemRenderer, если средство визуализации элементов содержит дополнительные элементы, которые не зависят от его данных, например границы или другие графические элементы.
Если средство визуализации элементов содержит несколько визуальных элементов, свойства которых зависят от его данных, для определения значений этих свойств можно использовать привязку данных. Этот подход возвращает удобный для чтения и использования код MXML, производительность которого может быть достаточно высокой при условии ограничения количества видимых средств визуализации элементов (см. свойства requestedRowCount и requestedColumnCount элемента DataGrid). Самым эффективным способом настройки такого типа средств визуализации элементов является внесение необходимых изменений в метод prepare(). Поскольку метод prepare() вызывается при каждом отображении средства визуализации элементов, очень важно, чтобы код этого метода был максимально эффективным. Если средство визуализации элементов сохраняет состояние, например кэширует внутренние значения, для удаления состояния используется метод discard(). Метод discard() вызывается при каждом перемещении средства визуализации элементов во внутренний свободный список DataGrid, откуда возможно его повторное использование.
Элементы GridItemRenderer должны быть максимально простыми. Для достижения максимальной производительности необходимо минимизировать количество компонентов и уменьшить глубину иерархии. Если допустимо, для определения макета вместо ограничений следует использовать явные позиции и размеры. Высокая производительность DataGrid обеспечивается значением по умолчанию variableRowHeight="false", а также значениями по умолчанию showDataTips="false" и clipAndEnableScrolling="false".
Описанные здесь примеры различных конфигураций GridItemRenderer доступны в разделе примеров.
Свойство MXML по умолчаниюmxmlContent
Связанные элементы API
spark.components.DataGrid
spark.components.Grid
spark.components.gridClasses.GridColumn
spark.components.gridClasses.GridColumn.itemRenderer
spark.skins.spark.DefaultGridItemRenderer
spark.components.Grid
spark.components.gridClasses.GridColumn
spark.components.gridClasses.GridColumn.itemRenderer
spark.skins.spark.DefaultGridItemRenderer
Общедоступные свойства
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityDescription : String
Вспомогательное средство доступа для свойства description в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityEnabled : Boolean
Вспомогательное средство доступа для свойства silent в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | |
| accessibilityName : String
Вспомогательное средство доступа для свойства name в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| accessibilityShortcut : String
Вспомогательное средство доступа для свойства shortcut в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| activeEffects : Array [только для чтения]
Список эффектов, в настоящее время воспроизводимых в компоненте, например массив экземпляров EffectInstance. | UIComponent | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| autoLayout : Boolean
При значении true измерение и макет выполняются при изменении позиции или размера нижестоящего элемента. | GroupBase | |
| automationDelegate : Object
Объект-делегат, выполняющий обработку функций, связанных с автоматизацией. | UIComponent | |
| automationEnabled : Boolean [только для чтения]
Значение true, если этот компонент доступен для автоматизации; в противном случае – false. | UIComponent | |
| automationName : String
Имя, которое можно использовать в качестве идентификатора этого объекта. | UIComponent | |
| automationOwner : DisplayObjectContainer [только для чтения]
Владелец этого компонента в целях автоматизации. | UIComponent | |
| automationParent : DisplayObjectContainer [только для чтения]
Вышестоящий элемент этого компонента в целях автоматизации. | UIComponent | |
| automationTabularData : Object [только для чтения]
Реализация интерфейса IAutomationTabularData, который можно использовать для извлечения данных. | UIComponent | |
| automationValue : Array [только для чтения]
Это значение, как правило, соответствует отображению объекта и может быть удобным для соотнесения идентификатора с объектом, поскольку отображено в приложении. | UIComponent | |
| automationVisible : Boolean [только для чтения]
Значение true, если этот компонент является видимым для автоматизации; в противном случае – false. | UIComponent | |
| baseline : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| baselinePosition : Number [переопределить] [только для чтения]
Координата Y базовой линии первой строки текста компонента. | Group | |
| baselinePositionElement : IVisualElement
Элемент, используемый для вычисления baselinePosition GroupBase.
| Group | |
| blendMode : String [переопределить]
Значение класса BlendMode, задающее режим наложения. | Group | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| bottom : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| cacheHeuristic : Boolean [только для записи]
Используется в Flex для предложения кэширования растровых изображений объекта. | UIComponent | |
| cachePolicy : String
Определяет политику кэширования растровых изображений для этого объекта. | UIComponent | |
| className : String [только для чтения]
Имя класса этого экземпляра, например Button. | UIComponent | |
| clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | GroupBase | |
| column : GridColumn
Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов. | GridItemRenderer | ||
| columnIndex : int [только для чтения]
Индекс столбца для ячейки этого средства визуализации элементов. | GridItemRenderer | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contentHeight : Number [только для чтения]
Высота содержимого области просмотра. | GroupBase | |
| contentMouseX : Number [только для чтения]
Возвращает координату x положения курсора мыши в текущей системе координат. | UIComponent | |
| contentMouseY : Number [только для чтения]
Возвращает координату y положения курсора мыши в текущей системе координат. | UIComponent | |
| contentWidth : Number [только для чтения]
Ширина содержимого области просмотра. | GroupBase | |
| contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
| currentState : String
Текущее состояние представления компонента. | UIComponent | |
| cursorManager : ICursorManager [только для чтения]
Получает FocusManager, управляющий курсором для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
| data : Object
Значение элемента поставщика данных для строки сетки, соответствующей средству визуализации элементов. | GridItemRenderer | ||
| depth : Number
Определяет порядок отображения элементов внутри контейнеров. | UIComponent | |
| descriptor : UIComponentDescriptor
Ссылка на UIComponentDescriptor (при его наличии), использованный методом createComponentFromDescriptor() для создания этого экземпляра UIComponent. | UIComponent | |
| designLayer : DesignLayer
Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом. | UIComponent | |
| document : Object
Ссылка на объект документа, связанный с этим UIComponent. | UIComponent | |
| doubleClickEnabled : Boolean [переопределить]
Определяет, получает ли объект UIComponent события doubleClick. | UIComponent | |
| down : Boolean
Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. | GridItemRenderer | ||
| dragging : Boolean
Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. | GridItemRenderer | ||
| dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен. | Sprite | |
| enabled : Boolean
Возможность использования компонента пользователем. | UIComponent | |
| errorString : String
Текст, отображаемый рекомендацией ошибки компонента при контроле компонента классом Validator и сбое проверки. | UIComponent | |
| explicitHeight : Number
Число, указывающее явную высоту компонента в пикселях в виде координат компонента. | UIComponent | |
| explicitMaxHeight : Number
Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMaxWidth : Number
Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMinHeight : Number
Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMinWidth : Number
Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitWidth : Number
Число, указывающее явную ширину компонента в пикселях в виде координат компонента. | UIComponent | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| flexContextMenu : IFlexContextMenu
Контекстное меню для этого UIComponent. | UIComponent | |
| focusEnabled : Boolean
Указывает, может ли компонент получить фокус при выборе вкладки с ним. | UIComponent | |
| focusManager : IFocusManager
Получает FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
| focusPane : Sprite
Область фокусировки, связанная с этим объектом | UIComponent | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
| graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
| grid : Grid [только для чтения]
Возвращает сетку, связанную с этим средством визуализации элементов. | GridItemRenderer | ||
| hasFocusableChildren : Boolean
Флаг, который указывает, могут ли нижестоящие объекты получить фокус. | UIComponent | |
| hasLayoutMatrix3D : Boolean [только для чтения]
Содержит true, если элемент имеет трехмерную матрицу. | UIComponent | |
| height : Number [переопределить]
Число, указывающее высоту компонента в координатах вышестоящего контейнера в пикселях. | UIComponent | |
| hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
| horizontalCenter : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| horizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | GroupBase | |
| hovered : Boolean
Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS. | GridItemRenderer | ||
| id : String
Идентификатор компонента. | UIComponent | |
| includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | UIComponent | |
| inheritingStyles : Object
Начало этой цепочки компонентов с ненаследуемыми стилями. | UIComponent | |
| initialized : Boolean
Флаг, определяющий, прошел ли объект все три фазы создания макета: обязательство, измерение и создание макета (при условии, что все они требовались). | UIComponent | |
| instanceIndex : int [только для чтения]
Индекс повторяемого компонента. | UIComponent | |
| instanceIndices : Array
Массив, содержащий индексы, требуемые для создания ссылки на этот UIComponent из собственного документа. | UIComponent | |
| is3D : Boolean [только для чтения]
Содержит true, если элемент представлен в трехмерной графике. | UIComponent | |
| isDocument : Boolean [только для чтения]
Содержит true, если этот экземпляр UIComponent является объектом документа. | UIComponent | |
| isPopUp : Boolean
Установите значение true в PopUpManager для указания того, что компонент имеет всплывающую подсказку. | UIComponent | |
| label : String
String для отображения в средстве визуализации. | GridItemRenderer | ||
| labelDisplay : spark.components.supportClasses:TextBase
Дополнительный визуальный компонент в средстве визуализации элементов для отображения свойства label. | GridItemRenderer | ||
| layout : LayoutBase
Объект layout для этого контейнера. | GroupBase | |
| layoutMatrix3D : Matrix3D [только для записи]
Матрица преобразования, которая используется для вычисления макета компонента относительно соответствующих элементов одного уровня. | UIComponent | |
| left : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| luminosityClip : Boolean
Свойство, управляющее тем, будет ли маска свечения отсекать маскируемое содержимое. | GroupBase | |
| luminosityInvert : Boolean
Свойство, управляющее вычислением значения цветов RGB графического элемента, использующего маску свечения. | GroupBase | |
| maintainProjectionCenter : Boolean
При значении true компонент будет сохранять свою матрицу проекции выровненной по центру своей ограничительной рамки. | UIComponent | |
| mask : DisplayObject [переопределить]
Устанавливает маску. | GroupBase | |
| maskType : String
Тип маски. | GroupBase | |
| maxHeight : Number
Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| maxWidth : Number
Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| measuredHeight : Number
Высота компонента в пикселях по умолчанию. | UIComponent | |
| measuredMinHeight : Number
Минимальная высота компонента по умолчанию в пикселях. | UIComponent | |
| measuredMinWidth : Number
Минимальная ширина компонента по умолчанию в пикселях. | UIComponent | |
| measuredWidth : Number
Ширина компонента в пикселях по умолчанию. | UIComponent | |
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| minHeight : Number
Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| minWidth : Number
Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| moduleFactory : IFlexModuleFactory
Фабрика модулей применяется в качестве контекста для использования встроенных шрифтов и для поиска менеджера стиля, который управляет стилями этого компонента. | UIComponent | |
| mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | |
| mouseEnabledWhereTransparent : Boolean
Установка значения true для этого свойства обеспечивает отвечаемость всех границ Group на события мыши, такие как щелчок и наведение. | GroupBase | |
| mouseFocusEnabled : Boolean
Можно ли получить фокус при нажатии элемента. | UIComponent | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mxmlContent : Array [только для записи]
Визуальные нижестоящие элементы содержимого для этого Group. | Group | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | |
| nestLevel : int
Глубина этого объекта в иерархии включения. | UIComponent | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | UIComponent | |
| numAutomationChildren : int [только для чтения]
Число нижестоящих элементов автоматизации, содержащихся в этом контейнере. | UIComponent | |
| numElements : int [только для чтения]
Количество визуальных элементов в данном контейнере. | GroupBase | |
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| overlay : DisplayLayer [только для чтения]
Плоскость перекрытия для этой группы. | GroupBase | |
| owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | UIComponent | |
| parent : DisplayObjectContainer [переопределить] [только для чтения]
Вышестоящий контейнер или компонент данного компонента. | UIComponent | |
| parentApplication : Object [только для чтения]
Ссылка на объект приложения, содержащего этот экземпляр UIComponent. | UIComponent | |
| parentDocument : Object [только для чтения]
Ссылка на вышестоящий объект документа для этого UIComponent. | UIComponent | |
| percentHeight : Number
Указывает высоту компонента в виде процента от размера вышестоящего элемента. | UIComponent | |
| percentWidth : Number
Указывает ширину компонента в виде процента от размера вышестоящего элемента. | UIComponent | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта. | UIComponent | |
| processedDescriptors : Boolean
Установлено на true после немедленного или отложенного создания нижестоящих элементов в зависимости от выполняемого действия. | UIComponent | |
| repeater : IRepeater [только для чтения]
Ссылка на объект Repeater в вышестоящем документе, создающем этот UIComponent. | UIComponent | |
| repeaterIndex : int [только для чтения]
Индекс элемента в поставщике данных Repeater, создавшего этот UIComponent. | UIComponent | |
| repeaterIndices : Array
Массив, содержащий индексы элементов в поставщике данных Repeater в вышестоящем документе, создавшем этот UIComponent. | UIComponent | |
| repeaters : Array
Массив, содержащий ссылки на объекты Repeater в вышестоящем документе, создавшем этот UIComponent. | UIComponent | |
| resizeMode : String
ResizeMode для этого контейнера. | GroupBase | |
| right : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number [переопределить]
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | UIComponent | |
| rotationX : Number [переопределить]
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | UIComponent | |
| rotationY : Number [переопределить]
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | UIComponent | |
| rotationZ : Number [переопределить]
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | UIComponent | |
| rowIndex : int
Отсчитываемый от нуля индекс строки визуализируемой ячейки. | GridItemRenderer | ||
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleGridBottom : Number
Указывает нижнюю координату сетки масштабирования. | Group | |
| scaleGridLeft : Number
Указывает левую координату сетки масштабирования. | Group | |
| scaleGridRight : Number
Указывает правую координату сетки масштабирования. | Group | |
| scaleGridTop : Number
Указывает верхнюю координату сетки масштабирования. | Group | |
| scaleX : Number [переопределить]
Число, определяющее коэффициент горизонтального масштабирования. | UIComponent | |
| scaleY : Number [переопределить]
Число, определяющее коэффициент вертикального масштабирования. | UIComponent | |
| scaleZ : Number [переопределить]
Число, определяющее коэффициент масштабирования по оси Z. | UIComponent | |
| screen : Rectangle [только для чтения]
Возвращает объект, который содержит размер и позицию основной поверхности изображения для этого объекта. | UIComponent | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| selected : Boolean
Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора. | GridItemRenderer | ||
| showInAutomationHierarchy : Boolean
Флаг, который определяет, показан ли объект автоматизации в иерархии автоматизации. | UIComponent | |
| showsCaret : Boolean
Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки. | GridItemRenderer | ||
| softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| states : Array
Состояния представления, представленные для этого компонента. | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
Обеспечивает хранение встроенных наследуемых стилей этого объекта. | UIComponent | |
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | UIComponent | |
| styleName : Object
Стиль класса, используемый этим компонентом. | UIComponent | |
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | UIComponent | |
| systemManager : ISystemManager
Возвращает объект SystemManager, используемый этим компонентом. | UIComponent | |
| tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | |
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | |
| tabFocusEnabled : Boolean
Флаг, который указывает, может ли этот объект получить фокус при использовании клавиши TAB. Это аналогично свойству tabEnabled, используемому в Flash Player. Обычно это значение – true для компонентов обработки ввода с клавиатуры, но некоторые компоненты панелей управления установлены на значение false, потому что они не должны забирать на себя фокус другого компонента, например редактора. | UIComponent | |
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
| toolTip : String
Текст, отображаемый в ToolTip. | UIComponent | |
| top : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| transform : flash.geom:Transform [переопределить]
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | UIComponent | |
| transformX : Number
Устанавливает координату x для центра преобразования компонента. | UIComponent | |
| transformY : Number
Устанавливает координату y для центра преобразования компонента. | UIComponent | |
| transformZ : Number
Устанавливает координату z для центра преобразования компонента. | UIComponent | |
| tweeningProperties : Array
Массив свойств, анимация которых выполняется в данный момент на этом объекте. | UIComponent | |
| uid : String
Уникальный идентификатор для объекта. | UIComponent | |
| updateCompletePendingFlag : Boolean
Флаг, определяющий, прошел ли объект все три фазы проверки макета (при условии, что все они требовались). | UIComponent | |
| useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
| validationSubField : String
Используется средством проверки для связывания подчиненного поля с этим компонентом. | UIComponent | |
| verticalCenter : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| verticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | GroupBase | |
| visible : Boolean [переопределить]
Определяет видимость экранного объекта. | UIComponent | |
| width : Number [переопределить]
Число, указывающее ширину компонента в координатах вышестоящего контейнера в пикселях. | UIComponent | |
| x : Number [переопределить]
Число, указывающее горизонтальную позицию компонента в пикселях внутри его вышестоящего контейнера. | UIComponent | |
| y : Number [переопределить]
Число, указывающее вертикальную позицию компонента в пикселях внутри его вышестоящего контейнера. | UIComponent | |
| z : Number [переопределить]
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного вышестоящего контейнера. | UIComponent | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | GridItemRenderer | ||
|
Добавляет визуальный элемент к этому контейнеру. | Group | |
|
Добавляет визуальный элемент к этому контейнеру. | Group | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Добавляет клиент с невизуальным стилем в экземпляр компонента. | UIComponent | |
|
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | |
|
Ставит в очередь функцию для последующего вызова. | UIComponent | |
|
Удаляет свойство style для экземпляра компонента. | UIComponent | |
|
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
|
Определяет, является ли указанный IVisualElement нижестоящим элементом экземпляра контейнера или самим экземпляром. | GroupBase | |
|
Преобразует объект Point из координат содержимого в глобальные координаты. | UIComponent | |
|
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | |
|
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | |
|
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | |
|
Создает ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | |
|
Удаляет ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | |
|
Возвращается к объекту UITextFormat, соответствующему текстовым стилям для этого UIComponent. | UIComponent | |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым. | GridItemRenderer | ||
| [переопределить]
Посылает событие в поток событий. | UIComponent | |
|
Отображает или скрывает индикатор фокуса вокруг этого компонента. | UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Обеспечивает отображение прямоугольника в объекте Graphics указанной темы оформления программным способом. | UIComponent | |
|
Вызывается экземпляром эффекта по завершении воспроизведения эффекта в компоненте. | UIComponent | |
|
Вызывается экземпляром эффекта при запуске воспроизведения эффекта в компоненте. | UIComponent | |
|
Завершает все воспроизводимые в настоящее время эффекты на компоненте. | UIComponent | |
|
Выполняет все привязки, для которых объект UIComponent является адресом назначения. | UIComponent | |
|
Вызывается после завершения печати. | UIComponent | |
|
Предоставляет объект автоматизации с указанным индексом. | UIComponent | |
|
Обеспечивает список объектов автоматизации. | UIComponent | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает координату Х границ элемента для указанного размера элемента. | UIComponent | |
|
Возвращает координату Y границ элемента при указанном размере элемента. | UIComponent | |
|
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
|
Выполняет поиск селекторов типа для этого экземпляра UIComponent. | UIComponent | |
|
Возвращает значение ограничения макета, идентичное значению получения стиля ограничения для этого компонента. | UIComponent | |
|
Возвращает визуальный элемент по заданному индексу. | GroupBase | |
|
Возвращает позицию индекса визуального элемента. | GroupBase | |
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную высоту
| UIComponent | |
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную ширину
| UIComponent | |
|
Получает объект, который в настоящее время имеет фокус. | UIComponent | |
|
Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки. | GroupBase | |
|
Возвращает высоту макета элемента. | UIComponent | |
|
Возвращает ширину макета элемента. | UIComponent | |
|
Возвращает координату Х, используемую элементом для отображения на экране. | UIComponent | |
|
Возвращает координату Y, используемую элементом для отображения на экране. | UIComponent | |
|
Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня. | UIComponent | |
|
Возвращает преобразование макета Matrix3D для этого элемента. | UIComponent | |
|
Возвращает максимальную высоту элемента. | UIComponent | |
|
Возвращает максимальную ширину элемента. | UIComponent | |
|
Возвращает минимальную высоту элемента. | UIComponent | |
|
Возвращает минимальную ширину элемента. | UIComponent | |
|
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Возвращает предпочтительную высоту элемента. | UIComponent | |
|
Возвращает предпочтительную ширину элемента. | UIComponent | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Возвращает элемент в dataProvider, использованный указанным Repeater для создания этого Repeater, или null, если повторение этого Repeater не выполнено. | UIComponent | |
|
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | UIComponent | |
|
Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки. | GroupBase | |
|
Макеты, не игнорирующие флаг useVirtualLayout, используют этот метод во время updateDisplayList() для получения элементов макета, находящихся «в пределах видимости», т. е. | GroupBase | |
|
Преобразует объект Point из глобальных координат в координаты содержимого. | UIComponent | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Возвращает true, если для currentCSSState не указано значение null. | UIComponent | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Определяет, было ли указанное состояние задано в данном UIComponent. | UIComponent | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Возвращает матрицу прямоугольника, которая может быть передана в метод drawRoundRect() метод как параметр rot при рисовании горизонтального градиента. | UIComponent | |
|
Инициализирует внутреннюю структуру этого компонента. | UIComponent | |
|
Инициализирует разные свойства, которые отслеживают повторенные экземпляры этого компонента. | UIComponent | |
|
Отмечает компонент с целью вызова его метода updateDisplayList() во время последующего обновления экрана. | UIComponent | |
|
Уведомляет компонент хоста о том, что элемент изменился и должен быть повторно отображен. | Group | |
|
Уведомляет компонент хоста, что элемент был изменен и должен пройти проверку правильности свойств. | Group | |
|
Уведомление хоста о изменении слоя элементов. | Group | |
|
Уведомление компонента хоста о том, что был изменен размер элемента. | Group | |
|
Вызывается элементами компонента для указания, что свойство depth было изменено. | UIComponent | |
|
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | UIComponent | |
|
Отмечает компонент с целью вызова его метода commitProperties() во время последующего обновления экрана. | UIComponent | |
|
Отмечает компонент с целью вызова его метода measure() во время последующего обновления экрана. | UIComponent | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
|
Возвращает значение true, если cssState совпадает с currentCSSState. | UIComponent | |
|
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | UIComponent | |
|
Выполняет измерения для указанного текста HTML, который может содержать HTML-теги, например <font> и <b>. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | |
|
Выполняет измерения для указанного текста. При этом предполагается, что текст отображается в однострочном поле UITextField (или UIFTETextField) при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | |
|
Перемещает компонент в указанное положение в пределах его вышестоящего элемента. | UIComponent | |
|
Обеспечивает распространение изменений стиля для нижестоящих элементов. | UIComponent | |
|
Возвращает значение true, если цепочка свойств owner направлена от child к этому UIComponent. | UIComponent | |
|
Вызывается Flex при добавлении или удалении объекта UIComponent из вышестоящего элемента. | UIComponent | |
Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации. | GridItemRenderer | ||
|
Готовит IFlexDisplayObject к печати. | UIComponent | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Создает или восстанавливает кэш стиля CSS для этого компонента и, если параметр recursive является true, также для всех нижестоящих элементов этого компонента. | UIComponent | |
|
Обеспечить регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | UIComponent | |
|
Удаляет все визуальные элементы из контейнера. | Group | |
|
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет указанный визуальный элемент из списка нижестоящих элементов данного контейнера. | Group | |
|
Удаляет визуальный элемент из указанной позиции индекса в контейнере. | Group | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Удаляет клиент с невизуальным стилем из экземпляра компонента. | UIComponent | |
|
Воспроизводит указанное событие. | UIComponent | |
|
Вызывает виртуальную клавиатуру. | InteractiveObject | |
|
Определяет нижестоящий элемент с помощью предоставленного идентификатора. | UIComponent | |
| [статические]
Возобновляет фоновую обработку методов, поставленных в очередь callLater() после вызова suspendBackgroundProcessing(). | UIComponent | |
|
Размеры объекта. | UIComponent | |
|
Устанавливает значение ограничения макета, совпадающее со значением стиля ограничения для этого компонента. | UIComponent | |
|
Определяет свойства contentWidth и contentHeight. | GroupBase | |
|
Установить текущее состояние. | UIComponent | |
|
Изменяет позицию существующего нижестоящего элемента в визуальном контейнере. | Group | |
|
Задает фокус на этот компонент. | UIComponent | |
|
Устанавливает координаты, используемые элементом для отображения на экране. | UIComponent | |
|
Устанавливает размер макета элемента. | UIComponent | |
|
Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | |
|
Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Задает свойство style для экземпляра компонента. | UIComponent | |
|
Вызывается при изменении свойства visible. | UIComponent | |
|
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
|
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | |
|
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | |
|
Завершает метод startDrag(). | Sprite | |
|
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | |
|
Обеспечивает обнаружение изменений в свойствах стиля. | UIComponent | |
|
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | UIComponent | |
| [статические]
Блокирует фоновую обработку методов, поставленных в очередь callLater() до вызова resumeBackgroundProcessing(). | UIComponent | |
|
Меняет местами индексы двух указанных визуальных элементов. | Group | |
|
Меняет местами визуальные элементы в двух указанных позициях индекса в контейнере. | Group | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
| [переопределить]
Возвращает строку, указывающую расположение этого объекта в иерархии объектов DisplayObject в приложении. | FlexSprite | |
| 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
Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. | UIComponent | |
|
Служебный метод для преобразования точки, указанной в локальных координатах этого объекта, к ее местоположению в координатах вышестоящего узла объекта. | UIComponent | |
|
Проверяет правильность расположения и размера нижестоящих элементов и отображает различные визуальные эффекты. | UIComponent | |
|
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. | UIComponent | |
|
Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties(). | UIComponent | |
|
Проверяет правильность измеренного размера компонента. Если совместно с данным IlayoutManagerClient вызван метод LayoutManager.invalidateSize(), то при измерении будет вызван метод validateSize(). | UIComponent | |
|
Обрабатывает события valid и invalid из средства проверки, назначенного этому компоненту. | UIComponent | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Возвращает матрицу прямоугольника, которая может быть передана передать в drawRoundRect() как параметр rot при рисовании вертикального градиента. | UIComponent | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Защищенные методы
| Метод | Определено | ||
|---|---|---|---|
|
Отрегулируйте прямоугольник фокусировки. | UIComponent | |
|
Передает вычисленную матрицу, созданную из комбинации матрицы макета и смещений преобразования flash displayObject. | UIComponent | |
|
Это внутренний метод, используемый инфраструктурой Flex для поддержки эффекта Dissolve. | UIComponent | |
|
Определяет, может ли быть пропущен вызов метода measure(). | UIComponent | |
|
Выполняет окончательную обработку после создания нижестоящих объектов. | UIComponent | |
|
Обрабатывает свойства, установленные в компоненте. | UIComponent | |
| [переопределить]
Если объект макета еще не установлен, createChildren() назначает этому контейнеру стандартный объект макета BasicLayout.
| GroupBase | |
|
Создает новый объект, использующий контекст, основанный на использованном встроенном шрифте. | UIComponent | |
|
Создает объект с помощью указанной moduleFactory. | UIComponent | |
|
Вспомогательные методы для отправки PropertyChangeEvent при обновлении свойства. | UIComponent | |
|
Обработчик события вызывается, если объект UIComponent получает фокус. | UIComponent | |
|
Обработчик события вызывается, если объект UIComponent теряет фокус. | UIComponent | |
Возвращает имя состояния, которое должно быть применено к средству визуализации. | GridItemRenderer | ||
|
Инициализирует реализацию и хранение некоторых из менее часто используемых расширенных функций макета компонента. | UIComponent | |
|
Завершает инициализацию компонента. | UIComponent | |
|
Инициализирует код доступности этого компонента. | UIComponent | |
|
Вспомогательный метод, делающий недействительными размер и список отображения вышестоящего элемента, если этот объект оказывает влияние на соответствующий макет (значение includeInLayout равно true). | UIComponent | |
|
Как правило, переопределяется с помощью компонентов, содержащих объекты UITextField, где объект UITextField получает фокус. | UIComponent | |
|
Обработчик события, вызываемый для события keyDown. | UIComponent | |
|
Обработчик события, вызываемый для события keyUp. | UIComponent | |
|
Вычисляет размер по умолчанию и дополнительно минимальный размер по умолчанию для компонента. | UIComponent | |
|
Этот метод вызывается при создании UIComponent и далее при каждой передаче события change для указания какого-либо изменения локализованных ресурсов. | UIComponent | |
|
Определяет коэффициент растягивания по горизонтали и вертикали. | UIComponent | |
|
Этот метод вызывается при изменении состояния для проверки, применяются ли специфичные для состояния стили к этому компоненту. | UIComponent | |
|
Обеспечивает отображение объекта и/или определение размеров и положения его нижестоящих элементов. | UIComponent | |
События
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Передается при добавлении компонента к контейнеру как нижестоящего элемента содержимого с помощью метода addChild(), addChildAt(), addElement() или addElementAt(). | UIComponent | ||
| Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
| Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
| Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | ||
| Отправляется по завершении создания компонента, и обработки, измерения, размещения и отображения свойств. | UIComponent | ||
| Передается после изменения состояния представления. | UIComponent | ||
| Передается после изменения свойства currentState, но перед изменением состояния представления. | UIComponent | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | ||
| Передается при изменении свойства data. | GridItemRenderer | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | ||
| Передается инициатором перетаскивания (компонентом, который является источником перетаскиваемых данных) по завершении операции перетаскивания, либо после опускания перетаскиваемых данных на целевой объект, либо по завершении операции перетаскивания без опускания данных. | UIComponent | ||
| Передается целевым объектом перетаскивания, когда пользователь отпускает на нем кнопку мыши. | UIComponent | ||
| Передается компонентом при перемещении пользователем курсора мыши над компонентом в процессе операции перетаскивания. | UIComponent | ||
| Передается компонентом, когда пользователь перетаскивает данные за пределы компонента, но не опускает их на целевой объект. | UIComponent | ||
| Передается компонентом при перемещении пользователем курсора мыши при нахождении над компонентом в процессе операции перетаскивания. | UIComponent | ||
| Отправляется инициатором перетаскивания после начала операции перетаскивания. | UIComponent | ||
| Отправляется по завершении эффекта. | UIComponent | ||
| Отправляется непосредственно перед запуском эффекта. | UIComponent | ||
| Отправляется после завершения эффекта, которое выполняется только после вызова метода stop(). | UIComponent | ||
| Отправляется при добавлении визуального элемента в держатель содержимого. | Group | ||
| Отправляется при удалении визуального элемента из держателя содержимого. | Group | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
| Отправляется после входа компонента в состояние представления. | UIComponent | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
| Отправляется непосредственно перед выходом компонента из состояния представления. | UIComponent | ||
| Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | ||
| Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | ||
| [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
| Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | ||
| Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Возникает при изменении состояния объекта с «Видимый» на «Невидимый». | UIComponent | ||
| Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | ||
| Передается по окончании создания компонента и установки всех свойств инициализации. | UIComponent | ||
| Отправляется, когда компонент контролируется средством проверки, и при проверке произошел сбой. | UIComponent | ||
| Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Передается из компонента, открытого с использованием PopUpManager, когда пользователь щелкает кнопкой мыши вне его пределов. | UIComponent | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | ||
| Передается из компонента, открытого с помощью PopUpManager, при прокручивании пользователем колеса мыши вне его пределов. | UIComponent | ||
| Передается при перемещении объекта. | UIComponent | ||
| Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | ||
| Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | ||
| Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | ||
| Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | ||
| Передается в начале последовательности инициализации компонента. | UIComponent | ||
| Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | ||
| Передается при удалении компонента из контейнера как нижестоящего элемента содержимого с помощью метода removeChild(), removeChildAt(), removeElement() или removeElementAt(). | UIComponent | ||
| Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
| Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
| [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
| Отправляется при изменении размеров компонента. | UIComponent | ||
| Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | ||
| Передается при изменении состояния объекта с «Невидимый» на «Видимый». | UIComponent | ||
| Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | ||
| Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | ||
| Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | ||
| Отправляется после перехода компонента в новое состояние и завершения воспроизведения анимации перехода в это состояние. | UIComponent | ||
| Отправляется, когда компонент прерывает переход в текущее состояние для переключения в новое состояние. | UIComponent | ||
| Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | ||
| Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | ||
| Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | ||
| Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | ||
| Передается компонентом перед созданием ToolTip. | UIComponent | ||
| Передается компонентом, когда ToolTip скрывается и вскоре будет удален. | UIComponent | ||
| Передается компонентом перед скрытием ToolTip. | UIComponent | ||
| Передается компонентом перед отображением ToolTip. | UIComponent | ||
| Передается компонентом при отображении ToolTip. | UIComponent | ||
| Передается компонентом с установленным свойством toolTip при наведении пользователем курсора мыши. | UIComponent | ||
| Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Неотменяемое событие, которое отправляется компонентом при завершении реагирования на касание пользователя | UIComponent | ||
| Неотменяемое событие, которое отправляется компонентом в начале реагирования на касание пользователя | UIComponent | ||
| Отменяемое событие, которое отправляется компонентом при попытке реагирования на касание пользователя | UIComponent | ||
| Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется при вызове объектом методов commitProperties(), measure() и updateDisplayList() (при необходимости). | UIComponent | ||
| Отправляется, когда компонент контролируется средством проверки, и проверка успешно выполнена. | UIComponent | ||
| Отправляется при изменении значений программным способом или в результате действий пользователя. | UIComponent | ||
Стили
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Общие стили
Стили тем Spark
Стили тем Гало
Mobile Theme Стили
Эффекты
Общедоступные константы
Сведения о свойстве
column | свойство |
column:GridColumn| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов.
Значением по умолчанию является null.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие columnChanged .
Реализация
public function get column():GridColumn public function set column(value:GridColumn):voidcolumnIndex | свойство |
data | свойство |
data:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Значение элемента поставщика данных для строки сетки, соответствующей средству визуализации элементов. Это значение соответствует объекту, возвращенному после вызова метода dataProvider.getItemAt(rowIndex).
Средства визуализации элементов могут изменить определение этого свойства, чтобы получить доступ к данным во всей строке сетки.
Значением по умолчанию является null.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dataChange .
Реализация
public function get data():Object public function set data(value:Object):voiddown | свойство |
down:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. Для свойства down восстанавливается значение false, когда пользователь отпускает кнопку мыши или больше не касается сенсорного экрана, а также если курсор или точка касания выходит за пределы ячейки сетки.
В отличие от средства визуализации элементов списка, средство визуализации элементов сетки не отвечает монопольно за отображение индикатора down. Сетка визуализирует индикатор down для выделенной строки или ячейки. Визуальные свойства средства визуализации элементов могут изменяться при нажатии.
Значением по умолчанию является false.
Реализация
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 не поддерживает перетаскивание.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие draggingChanged .
Реализация
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 для строки или ячейки, на которую наведен курсор мыши. Свойства средств визуализации элементов сетки могут изменяться, если на них наведен курсор мыши.
Значением по умолчанию является false.
Реализация
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() столбца.
Значением по умолчанию является "".
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelChanged .
Реализация
public function get label():String public function set label(value:String):voidlabelDisplay | свойство |
labelDisplay:spark.components.supportClasses:TextBase| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Дополнительный визуальный компонент в средстве визуализации элементов для отображения свойства label. Если это свойство используется для определения визуального компонента, то свойство text этого компонента синхронизируется со свойством label средства визуализации элементов.
Значением по умолчанию является null.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelDisplayChanged .
Реализация
public function get labelDisplay():spark.components.supportClasses:TextBase public function set labelDisplay(value:spark.components.supportClasses:TextBase):voidrowIndex | свойство |
rowIndex:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Отсчитываемый от нуля индекс строки визуализируемой ячейки.
Значением по умолчанию является -1.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие rowIndexChanged .
Реализация
public function get rowIndex():int public function set rowIndex(value:int):voidselected | свойство |
selected:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора.
В отличие от средства визуализации списка, средства визуализации элементов сетки не отвечают монопольно за отображение того, что они являются частью выбранной области. Сетка автоматически отображает компонент темы оформления selectionIndicator для выбранных строк или ячеек. Средство визуализации элементов может также изменить свои визуальные свойства для выражения того, что оно является компонентом выбора.
Значением по умолчанию является false.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие selectedChanged .
Реализация
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 для строки или ячейки, содержащей символ вставки. Средство визуализации элементов также может изменить свои визуальные свойства для выражения того, что оно содержит символ вставки.
Значением по умолчанию является false.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие showsCaretChanged .
Реализация
public function get showsCaret():Boolean public function set showsCaret(value:Boolean):voidСведения о конструкторе
GridItemRenderer | () | Конструктор |
public function GridItemRenderer()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Конструктор.
Сведения о методе
discard | () | метод |
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, если это средство визуализации будет добавлено к внутреннему свободному списку владельца для повторного использования.
|
getCurrentRendererState | () | метод |
protected function getCurrentRendererState():String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает имя состояния, которое должно быть применено к средству визуализации. Например, основное средство визуализации элементов возвращает строки normal, hovered или selected для определения состояния средства визуализации. Если используются действия касания (или действия мыши при игнорировании выбора), также возвращаются значения down и downAndSelected.
Подкласс GridItemRenderer должен перезаписать этот метод, чтобы возвратить значение, если заданное поведение отличается от поведения по умолчанию.
Тремя основными состояниями в Flex 4.0 были "normal", "hovered" и "selected". В Flex 4.5 добавлены состояния "down" и "downAndSelected".
Ниже представлен полный набор поддерживаемых состояний (в порядке приоритета):
- dragging
- downAndSelected
- selectedAndShowsCaret
- hoveredAndShowsCaret
- normalAndShowsCaret
- down
- selected
- hovered
- normal
String — String, указывающая имя состояния, которое должно быть применено к средству визуализации.
|
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, если это средство визуализации используется повторно.
|
Сведения о событии
dataChange | Событие |
Тип объекта события:
свойство FlexEvent.type =
mx.events.FlexEventсвойство FlexEvent.type =
mx.events.FlexEvent.DATA_CHANGE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Передается при изменении свойстваdata.
FlexEvent.DATA_CHANGE определяет значение свойства type объекта события dataChange.
Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Примеры Использование этого примера
GridItemRendererExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!--
Demonstate how to control text wrapping in DataGrid GridItemRenderer item renderer.
This DataGrid example demonstrates how to control text wrapping with a simple custom item renderer
based on GridItemRenderer. All cells in this example display the same lengthy string which does
not contain newlines. Note that the Flex text components unconditionally render newline characters
that appear in the text.
The "Label Renderer" column's renderer is a custom GridItemRenderer that displays its text with
an s:Label component. We use the Label's maxDisplayedLines property to control line breaking
and to include "..." truncation when the single line of text doesn't fit.
Note also: this example's column widths and row heights are defined by the DataGrid's typicalItem.
The typical item uses explicit newlines to create a string that occupies three lines and a
reasonable column width.
-->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark">
<fx:Declarations>
<fx:String id="sampleText">Lorem Ipsum is the standard dummy text of the typesetting industry.</fx:String>
<fx:int id="maxDisplayedLines">0</fx:int>
</fx:Declarations>
<s:Panel title="Spark DataGrid Control Example which demonstrates how to control text wrapping in a GridItemRenderer"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:controlBarContent>
<s:VGroup>
<s:CheckBox id="vrh" selected="@{dataGrid.variableRowHeight}"
label="dataGrid.variableRowHeight={vrh.selected}"/>
<s:CheckBox id="lb" selected="true"
valueCommit="maxDisplayedLines=(lb.selected) ? 0 : 1"
label="labelRenderer.maxDisplayedLines={maxDisplayedLines}"/>
</s:VGroup>
</s:controlBarContent>
<s:DataGrid id="dataGrid" variableRowHeight="false" verticalCenter="0" horizontalCenter="0">
<s:columns>
<s:ArrayList>
<!--
Simple custom item renderer based on GridItemRenderer and Label.
Prevent line breaking by setting maxDisplayedLines="1".
-->
<s:GridColumn dataField="value" headerText="Label Renderer">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer>
<s:Label id="labelDisplay"
left="5" top="9" right="5" bottom="5"
maxDisplayedLines="{outerDocument.maxDisplayedLines}"/>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
</s:ArrayList>
</s:columns>
<!--
The typicalItem defines column widths and the default row height. The text
occpies two lines because we've used '\n' to introduce two newlines.
Alternatively we could have used the odd XML ' ' escape to introduce
two newlines (the value of the newline character is decimal 10).
<s:DataItem value="Lorem Ipsum sample text. Lorem Ipsum sample text. "/>
-->
<s:typicalItem>
<s:DataItem value="{'Lorem Ipsum sample text.\nLorem Ipsum sample text\n'}"/>
</s:typicalItem>
<s:ArrayCollection>
<s:DataItem value="{sampleText}"/>
<s:DataItem value="{sampleText}"/>
<s:DataItem value="{sampleText}"/>
</s:ArrayCollection>
</s:DataGrid>
</s:Panel>
</s:Application>
GridItemRendererCustomBindingExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!--
Examples of custom GridItemRenderers that use data binding to configure visual properties.
The application's control bar slider can be used to change the the dataProvider items.
The GridItemRenderer class is a Group that implements
IGridItemRenderer and can be used as the top level "container" for a
custom item renderer. Its data property is the dataProvider item for
the row the item renderer appears on and its components can configure
themselves by binding to the data property, or by overriding the
renderer's prepare() method and configuring themselves imperatively
with ActionScript code. All of the item renderers in this example
use binding, which makes the code a little easier to read and modify.
It's also less efficient than using a prepare() method override. The
performance difference is most noticeable when the DataGrid is configured
so that a large number of item renderers are visible.
DataGrid item renderers are always sized to exactly fit the cell that
they're rendering: their size matches the width of their column and the height of their row.
The DataGrid enables interactive column resizing by default, so all of
the item renderers need to defend against the possibility that their
width will become arbitrarily small. The first column's item renderer
just contains a Label. By specifying maxDisplayedLines="1" we ensure
that the Label will truncate its text to fit the width it's given.
The other columns' item renderers specify
clipAndEnableScrolling="true" which just means that their fixed size
contents will always be clipped to the bounds of the GridItemRenderer.
This property -enables- scrolling, which means that one could actually
scroll the contents of the item renderers when their width gets small,
by setting the renderer's horizontalScrollPosition property. We
do not do as much here.
The "Name" column's item renderer demonstrates a special case: if the
renderer contains a text component with id="labelDisplay", GridItemRenderer
automatically sets the labelDisplay's text property to the value
of data[column.dataField] per the GridItemRenderer label property. The
first colunm also demonstrates using the styleName property to configure
the Label's left, right, top, and fontSize styles.
The "Statistics" column's item renderer demonstrates how binding can be used to
configure the geometry of graphic elememnts. The data items' min, max, and
value properties have been normalized to the range [0 100] to keep the bindings simple.
The "Value" column's item renderer allows one to change data item's value
property with a Slider.
The "Call" column's item renderer demonstrates a slightly more complicated component
layout and it also demonstates how the data item's value can be both displayed
and edited.
-->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark">
<fx:Script>
<![CDATA[
// Incrementally change all of the date items' min, max, value, and call properties.
private function changeData(delta:Number):void
{
for each (var item:Object in dataGrid.dataProvider)
{
item.value = (item.value + delta) % 100;
item.min = item.value * 0.5;
item.max = item.value + ((100 - item.value) * 0.5);
item.call = item.value > 50;
}
}
]]>
</fx:Script>
<fx:Style>
.nameColumn {
fontSize: 18;
left: 5;
right: 5;
top: 9;
}
</fx:Style>
<s:Panel title="Spark DataGrid Control Example of custom GridItemRenderers that use data binding to configure visual properties"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:controlBarContent>
<s:HGroup verticalAlign="baseline">
<s:Label text="Shake Data"/>
<s:HSlider id="hsl" minimum="0" maximum="25" change="changeData(hsl.value)"/>
</s:HGroup>
</s:controlBarContent>
<s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5">
<s:columns>
<s:ArrayList>
<!--
By specifying id="labelDisplay" the Label component's text property is automatically
set to the renderer's label, which is effectively the value of the item's name property.
We've used styleName here to refer to a set of styles that could have also have been set inline.
-->
<s:GridColumn dataField="name" headerText="Name">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer>
<s:Label id="labelDisplay" maxDisplayedLines="1" styleName="nameColumn"/>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<!--
This column's renderer displays the item's value, min, and max properties with a simple dial
and bar chart defined with graphic primitives. The bar chart s:Rect elements specify
scaleY="-1" so that the rectangles grow from the bottom of the renderer upwards. To keep
things simple, most of the elements geometry is specified explicitly. Note also that
min, max, and value have all been normalized to [0, 100].
-->
<s:GridColumn dataField="value" headerText="Statistics">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<s:Group left="5" top="5" bottom="5">
<s:Ellipse x="0" y="0" width="30" height="30">
<s:stroke>
<s:SolidColorStroke color="0x272F32" weight="2"/>
</s:stroke>
<s:fill>
<s:SolidColor color="0x9DBDC6"/>
</s:fill>
</s:Ellipse>
<s:Line rotation="{(data.value / 100) * 360}" transformX="15" transformY="15"
xFrom="15" yFrom="15" xTo="27" yTo="15">
<s:stroke>
<s:SolidColorStroke color="0xFF3D2E" weight="3"/>
</s:stroke>
</s:Line>
<s:Rect x="40" y="30" scaleY="-1" width="15" height="{(data.min / 100) * 30}">
<s:fill>
<s:SolidColor color="0xFF3D2E"/>
</s:fill>
</s:Rect>
<s:Rect x="60" y="30" scaleY="-1" width="15" height="{(data.max / 100) * 30}">
<s:fill>
<s:SolidColor color="0xFF3D2E"/>
</s:fill>
</s:Rect>
</s:Group>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<!--
This column's renderer displays the data item's value property with a slider. The binding is specified
with "@{data.value}", which indicates that it's bidirection, so changing the slider also changes
the dataProvider item.
-->
<s:GridColumn dataField="value" headerText="Value">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<s:HSlider left="5" right="5" verticalCenter="0"
minimum="{data.min}" maximum="{data.max}" value="@{data.value}"/>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<!--
Display the boolean data item call property with a checkbox, radio button, and a text field. The
call value can be changed with the checkbox.
-->
<s:GridColumn dataField="call" headerText="Call">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<s:HGroup left="5" top="9" right="5" verticalAlign="baseline">
<s:CheckBox selected="@{data.call}"/>
<s:RadioButton selected="{data.call}" enabled="false"/>
<s:TextInput text="{data.call}" enabled="false"/>
</s:HGroup>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
</s:ArrayList>
</s:columns>
<s:ArrayCollection>
<s:DataItem min="10" max="85" value="15" name="Abrasive" price="100.11" call="false"/>
<s:DataItem min="15" max="75" value="25" name="Brush" price="110.01" call="true"/>
<s:DataItem min="30" max="65" value="45" name="Clamp" price="120.02" call="false"/>
<s:DataItem min="20" max="85" value="65" name="Drill" price="130.03" call="true"/>
<s:DataItem min="40" max="95" value="85" name="Epoxy" price="140.04" call="false"/>
<s:DataItem min="70" max="99" value="95" name="File" price="150.05" call="true"/>
<s:DataItem min="60" max="85" value="80" name="Gouge" price="160.06" call="false"/>
<s:DataItem min="40" max="70" value="60" name="Hook" price="170.07" call="true"/>
<s:DataItem min="10" max="40" value="20" name="Ink" price="180.08" call="false"/>
<s:DataItem min="5" max="30" value="10" name="Jack" price="190.09" call="true"/>
</s:ArrayCollection>
</s:DataGrid>
</s:Panel>
</s:Application>
GridItemRendererCustomPrepareExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!--
Examples of custom GridItemRenderers that use the prepare() method to configure visual properties.
This example is identical to DataGridCustomBindingRenderer.as except that instead of using
data bindings, all visual elements are configured by GridItemRenderer/prepare() method
overrides.
-->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark">
<fx:Script>
<![CDATA[
// Incrementally change all of the date items' min, max, value, and call properties.
private function changeData(delta:Number):void
{
for each (var item:Object in dataGrid.dataProvider)
{
item.value = (item.value + delta) % 100;
item.min = (item.min + delta) % 100;
item.max = (item.max + delta) % 100;
item.call = item.value > 50;
}
}
]]>
</fx:Script>
<fx:Style>
.nameColumn {
fontSize: 18;
left: 5;
right: 5;
top: 9;
}
</fx:Style>
<s:Panel title="Spark DataGrid Control Example of custom GridItemRenderers that use the prepare() method to configure visual properties"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:controlBarContent>
<s:HGroup verticalAlign="baseline">
<s:Label text="Shake Data"/>
<s:HSlider id="hsl" minimum="0" maximum="50" change="changeData(hsl.value)"/>
</s:HGroup>
</s:controlBarContent>
<s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5">
<s:columns>
<s:ArrayList>
<s:GridColumn dataField="name" headerText="Name">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer>
<fx:Script>
<![CDATA[
override public function prepare(hasBeenRecycled:Boolean):void
{
nameLabel.text = data.name;
}
]]>
</fx:Script>
<s:Label id="nameLabel" maxDisplayedLines="1" styleName="nameColumn"/>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<s:GridColumn dataField="value" headerText="Statistics">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<fx:Script>
<![CDATA[
override public function prepare(hasBeenRecycled:Boolean):void
{
valueDial.rotation = (data.value / 100) * 360;
minBar.height = (data.min / 100) * 30;
maxBar.height = (data.max / 100) * 30;
}
]]>
</fx:Script>
<s:Group left="5" top="5" bottom="5">
<s:Ellipse x="0" y="0" width="30" height="30">
<s:stroke>
<s:SolidColorStroke color="0x272F32" weight="2"/>
</s:stroke>
<s:fill>
<s:SolidColor color="0x9DBDC6"/>
</s:fill>
</s:Ellipse>
<s:Line id="valueDial" transformX="15" transformY="15"
xFrom="15" yFrom="15" xTo="27" yTo="15">
<s:stroke>
<s:SolidColorStroke color="0xFF3D2E" weight="3"/>
</s:stroke>
</s:Line>
<s:Rect id="minBar" x="40" y="30" scaleY="-1" width="15">
<s:fill>
<s:SolidColor color="0xFF3D2E"/>
</s:fill>
</s:Rect>
<s:Rect id="maxBar" x="60" y="30" scaleY="-1" width="15">
<s:fill>
<s:SolidColor color="0xFF3D2E"/>
</s:fill>
</s:Rect>
</s:Group>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<s:GridColumn dataField="value" headerText="Value">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<fx:Script>
<![CDATA[
override public function prepare(hasBeenRecycled:Boolean):void
{
valueSlider.minimum = data.min;
valueSlider.maximum = data.max;
valueSlider.value = data.value;
}
private function valueChange():void
{
data.value = valueSlider.value;
}
]]>
</fx:Script>
<s:HSlider id="valueSlider" left="5" right="5" verticalCenter="0" change="valueChange()"/>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
<s:GridColumn dataField="call" headerText="Call">
<s:itemRenderer>
<fx:Component>
<s:GridItemRenderer clipAndEnableScrolling="true">
<fx:Script>
<![CDATA[
override public function prepare(hasBeenRecycled:Boolean):void
{
callCheckBox.selected = data.call;
callRadioButton.selected = data.call;
callTextInput.text = String(data.call);
}
private function valueChange():void
{
data.call = callCheckBox.selected;
}
]]>
</fx:Script>
<s:HGroup left="5" top="9" right="5" verticalAlign="baseline">
<s:CheckBox id="callCheckBox" change="valueChange()"/>
<s:RadioButton id="callRadioButton" enabled="false"/>
<s:TextInput id="callTextInput" enabled="false"/>
</s:HGroup>
</s:GridItemRenderer>
</fx:Component>
</s:itemRenderer>
</s:GridColumn>
</s:ArrayList>
</s:columns>
<s:ArrayCollection>
<s:DataItem min="10" max="85" value="15" name="Abrasive" price="100.11" call="false"/>
<s:DataItem min="15" max="75" value="25" name="Brush" price="110.01" call="true"/>
<s:DataItem min="30" max="65" value="45" name="Clamp" price="120.02" call="false"/>
<s:DataItem min="20" max="85" value="65" name="Drill" price="130.03" call="true"/>
<s:DataItem min="40" max="95" value="85" name="Epoxy" price="140.04" call="false"/>
<s:DataItem min="70" max="99" value="95" name="File" price="150.05" call="true"/>
<s:DataItem min="60" max="85" value="80" name="Gouge" price="160.06" call="false"/>
<s:DataItem min="40" max="70" value="60" name="Hook" price="170.07" call="true"/>
<s:DataItem min="10" max="40" value="20" name="Ink" price="180.08" call="false"/>
<s:DataItem min="5" max="30" value="10" name="Jack" price="190.09" call="true"/>
</s:ArrayCollection>
</s:DataGrid>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z