UIComponent  - AS3 Flex

Вспомогательное средство доступа для свойства description в объекте accessibilityProperties этого UIComponent.

Получатель возвращает accessibilityProperties.description или "", если accessibilityProperties равно null. Установщик сначала проверяет, установлено ли accessibilityProperties на null, и в случае такой установки задает его для нового экземпляра AccessibilityProperties. Затем он устанавливает accessibilityProperties.description.

Вспомогательное средство доступа для свойства silent в объекте accessibilityProperties этого UIComponent.

Следует учесть, что значение accessibilityEnabled противоположно значению silent: accessibilityEnabled является true при silent равном false.

Получатель возвращает accessibilityProperties.silent или true, если accessibilityProperties равно null. Установщик сначала проверяет, установлено ли accessibilityProperties на null, и в случае такой установки задает его для нового экземпляра AccessibilityProperties. Затем он устанавливает accessibilityProperties.silent.

Вспомогательное средство доступа для свойства name в объекте accessibilityProperties этого UIComponent.

Получатель возвращает accessibilityProperties.name или "", если accessibilityProperties равно null. Установщик сначала проверяет, установлено ли accessibilityProperties на null, и в случае такой установки задает его для нового экземпляра AccessibilityProperties. Затем он устанавливает accessibilityProperties.name.

Вспомогательное средство доступа для свойства shortcut в объекте accessibilityProperties этого UIComponent.

Получатель возвращает accessibilityProperties.shortcut или "", если accessibilityProperties равно null. Установщик сначала проверяет, установлено ли accessibilityProperties на null, и в случае такой установки задает его для нового экземпляра AccessibilityProperties. Затем он устанавливает accessibilityProperties.shortcut.

Список эффектов, в настоящее время воспроизводимых в компоненте, например массив экземпляров EffectInstance.

Объект-делегат, выполняющий обработку функций, связанных с автоматизацией.

Значение true, если этот компонент доступен для автоматизации; в противном случае – false.

Имя, которое можно использовать в качестве идентификатора этого объекта.

Владелец этого компонента в целях автоматизации.

Вышестоящий элемент этого компонента в целях автоматизации.

Реализация интерфейса IAutomationTabularData, который можно использовать для извлечения данных.

Это значение, как правило, соответствует отображению объекта и может быть удобным для соотнесения идентификатора с объектом, поскольку отображено в приложении.

Значение true, если этот компонент является видимым для автоматизации; в противном случае – false.

Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. Чтобы установить для свойства значение по умолчанию undefined, в MXML используется директива @Clear(), а в коде ActionScript - значение undefined. Например, в коде MXML baseline.s2="@Clear()" снимает ограничение baseline в состоянии s2. Или в коде ActionScript, где button.baseline = undefined снимает ограничение baseline для button.

По умолчанию целевым объектом привязки является верхний край области содержимого контейнера. В макетах с расширенными ограничениями, целевой объект может быть строкой ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате: "anchorTargetName:value". Например, "row1:10".

Координата Y базовой линии первой строки текста компонента.

Это свойство используется для реализации стиля ограничения baseline. Это свойство также используется для выравнивания метки FormItem относительно элементов управления в FormItem.

Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. Чтобы установить для свойства значение по умолчанию undefined, в MXML используется директива @Clear(), а в коде ActionScript - значение undefined. Например, в коде MXML bottom.s2="@Clear()" снимает ограничение bottom в состоянии s2. Или в коде ActionScript, где button.bottom = undefined снимает ограничение bottom для button.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями, целевой объект может быть строкой ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате: "anchorTargetName:value". Например, "row1:10".

Используется в Flex для предложения кэширования растровых изображений объекта. Если для cachePolicy установлено значение UIComponentCachePolicy.AUTO, то используется cacheHeuristic для управления свойством объекта cacheAsBitmap.

Определяет политику кэширования растровых изображений для этого объекта. Возможными значениями в MXML являются on, off и auto (по умолчанию).

Возможными значениями в ActionScript являются UIComponentCachePolicy.ON, UIComponentCachePolicy.OFF и UIComponentCachePolicy.AUTO (по умолчанию).

• Значение UIComponentCachePolicy.ON означает, что объект всегда кэшируется как растровое изображение.
• Значение UIComponentCachePolicy.OFF означает, что объект никогда не кэшируется как растровое изображение.
• Значение UIComponentCachePolicy.AUTO означает, что вопрос о том, должен ли объект кэшироваться как растровое изображение, в инфраструктуре решается эвристическим путем.

Значением по умолчанию является UIComponentCachePolicy.AUTO.

Имя класса этого экземпляра, например Button.

Эта строка не включает имя пакета. Если требуется включить также и имя пакета, выполняется вызов метода getQualifiedClassName() из пакета flash.utils. Этот метод возвращает строку, например "mx.controls::Button".

Возвращает координату x положения курсора мыши в текущей системе координат. Координаты содержимого указывают позицию пиксела относительно верхнего левого угла содержимого компонента и включают всю область содержимого компонента, в том числе области, которые в настоящее время отсечены и доступ к которым возможен при прокрутке компонента.

Возвращает координату y положения курсора мыши в текущей системе координат. Координаты содержимого указывают позицию пиксела относительно верхнего левого угла содержимого компонента и включают всю область содержимого компонента, в том числе области, которые в настоящее время отсечены и доступ к которым возможен при прокрутке компонента.

Состояние, используемое при сопоставлении псевдоселекторов CSS. По умолчанию используется currentState.

Текущее состояние представления компонента. Установить на "" или null для сброса компонента до базового состояния.

При использовании этого свойства для установки состояния компонента Flex применяет любой определенный переход. Можно также использовать метод setCurrentState() для установки текущего состояния; этот метод может при необходимости изменять состояния, не применяя переход.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие currentStateChange .

Связанные элементы API

Получает FocusManager, управляющий курсором для этого компонента и компонентов, находящихся на том же уровне иерархии. Каждое окно верхнего уровня имеет собственный экземпляр CursorManager; используйте этот метод для обращения к гарантировано верному экземпляру.

Определяет порядок отображения элементов внутри контейнеров. Элементы в Groups упорядочиваются на основании свойства depth, при этом элементы с самой большой «глубиной» отображаются на заднем плане, а с меньшей – на переднем. Элементы с одинаковой «глубиной» отобразятся в порядке добавления к контейнеру.

Ссылка на UIComponentDescriptor (при его наличии), использованный методом createComponentFromDescriptor() для создания этого экземпляра UIComponent. Если этот экземпляр UIComponent не создавался из дескриптора, то значение этого свойства равно null.

Связанные элементы API

Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом.

Если DesignLayer присвоен, в визуальном элементе необходимо учитывать значение видимости и значение альфа-канала вышестоящего слоя в конечном итоге при передаче собственного эффективного значения видимости или значения альфа-канала в резервный DisplayObject (если применимо).

Визуальный элемент должен предусматривать прослушивание уведомлений layerPropertyChange из связанного вышестоящего элемента слоя. При изменении effectiveAlpha или effectiveVisibility слоя элемент должен выполнять вычисление собственного эффективного значения видимости (альфа-канала) и соответственно его применять.

Это свойство не должно устанавливаться непосредственно в MXML.

Свойство designLayer не используется для элемента управления z-порядка, см. depth.

Ссылка на объект документа, связанный с этим UIComponent. Объект документа представляет собой Object на самом верху иерархии приложения Flex, компонента MXML или компонента AS.

Определяет, получает ли объект UIComponent события doubleClick. Значением по умолчанию является false. Это означает, что объект UIComponent не получает события doubleClick.

Свойство mouseEnabled должно быть также установлено на true. Это значение по умолчанию для объекта, получающего события doubleClick.

Значением по умолчанию является false.

Возможность использования компонента пользователем. После установки свойства enabled на false некоторые компоненты по-прежнему отвечают на использование мыши, например на событие mouseOver. В результате для полного отключения UIComponents требуется установить значение свойства mouseEnabled на false. При установке свойства enabled на false для контейнера Flex затемняет цвет контейнера и всех его нижестоящих элементов, а также блокирует ввод данных пользователем в контейнер и во все нижестоящие элементы.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие enabledChanged .

Текст, отображаемый рекомендацией ошибки компонента при контроле компонента классом Validator и сбое проверки.

Можно использовать свойство errorString для определения ошибки при проверке для компонента без фактического использования класса Validator. При записи строкового значения в свойство errorString Flex выводит красную рамку вокруг компонента для индикации ошибки при проверке, а при наведении курсора мыши на компонент строка появляется во всплывающей подсказке как сообщение об ошибке при проверке, как при обнаружении средством проверки ошибки при проверке.

Для удаления ошибки при проверке запишите пустую строку «» в свойство errorString.

Обратите внимание, что запись значения в свойство errorString не запускает событие valid или invalid; изменяется только цвет границы и появляется сообщение об ошибке при проверке.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие errorStringChanged .

Число, указывающее явную высоту компонента в пикселях в виде координат компонента.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleY влияет на значение true explicitHeight относительно его вышестоящего элемента.

При установке свойства height для этого свойство также устанавливается указанное значение высоты.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explicitHeightChanged .

Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

Как правило, разработчики не устанавливают свойство explicitMaxHeight. Вместо этого они устанавливают значение свойства maxHeight, которое устанавливает свойство explicitMaxHeight. Значение maxHeight не изменяется.

Если в ходе создания макета свойство maxHeight установлено разработчиком приложения явно, используется значение explicitMaxHeight. В противном случае используется значение по умолчанию для maxHeight.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleY влияет на значение true maxHeight относительно его вышестоящего элемента. Некоторые компоненты не имеют теоретической границы по высоте. В таких случаях их значение maxHeight будет установлено на UIComponent.DEFAULT_MAX_HEIGHT.

Значением по умолчанию является NaN.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explicitMaxHeightChanged .

Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

Как правило, разработчики приложений не устанавливают свойство explicitMaxWidth. Вместо этого они устанавливают значение свойства maxWidth, которое устанавливает свойство explicitMaxWidth. Значение maxWidth не изменяется.

Если в ходе создания макета свойство maxWidth образом установлено разработчиком приложения явно, используется значение explicitMaxWidth. В противном случае используется значение по умолчанию для maxWidth.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleX влияет на значение true maxWidth относительно его вышестоящего элемента. Некоторые компоненты не имеют теоретической границы по ширине. В таких случаях их значение maxWidth будет установлено на UIComponent.DEFAULT_MAX_WIDTH.

Значением по умолчанию является NaN.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explicitMaxWidthChanged .

Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

Как правило, разработчики приложений не устанавливают свойство explicitMinHeight. Вместо этого они устанавливают значение свойства minHeight, которое устанавливает свойство explicitMinHeight. Значение minHeight не изменяется.

Если в ходе создания макета свойство minHeight установлено разработчиком приложения явно, используется значение explicitMinHeight. В противном случае используется значение по умолчанию measuredMinHeight.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleY влияет на значение true minHeight относительно его вышестоящего элемента.

Значением по умолчанию является NaN.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explictMinHeightChanged .

Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

Как правило, разработчики приложений не устанавливают свойство explicitMinWidth. Вместо этого они устанавливают значение свойства minWidth, которое устанавливают свойство explicitMinWidth. Значение minWidth не изменяется.

Если в ходе создания макета свойство minWidth установлено разработчиком приложения явно, используется значение explicitMinWidth. В противном случае используется значение measuredMinWidth.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleX влияет на значение true minWidth относительно его вышестоящего элемента.

Значением по умолчанию является NaN.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explicitMinWidthChanged .

Число, указывающее явную ширину компонента в пикселях в виде координат компонента.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleX влияет на значение true explicitWidth относительно его вышестоящего элемента.

При установке свойства width это свойство также устанавливается на указанное значение.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие explicitWidthChanged .

Контекстное меню для этого UIComponent.

Значением по умолчанию является null.

Указывает, может ли компонент получить фокус при выборе вкладки с ним. Можно установить focusEnabled на false, если UIComponent используется в качестве подчиненного компонента для другого компонента так, чтобы внешний компонент стал сущностью, которая может получить фокус. Если это свойство имеет значение false, фокус будет передан в первый вышестоящий элемент, в котором focusEnable установлено на true.

Значением по умолчанию является true, за исключением компонента spark.components.Scroller. Для этого компонента используется значение по умолчанию false.

Связанные элементы API

Получает FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. Каждый всплывающий элемент имеет собственный цикл фокуса и, соответственно, собственный экземпляр FocusManager. С помощью этого метода можно удостовериться, что выполняется обращение к верному экземпляру.

Область фокусировки, связанная с этим объектом Объект имеет область фокусировки, если один из его нижестоящих элементов имеет фокус.

Возвращает значение true, если UIComponent имеет какое-либо свойство transform, отличное от перемещения (x, y)

Флаг, который указывает, могут ли нижестоящие объекты получить фокус.

Примечание. Это аналогично свойству tabChildren, используемому в Flash Player. Свойство hasFocusableChildren используется с приложениями Flex. Не следует использовать свойство tabChildren.

Обычно это свойство – false, потому что большинство компонентов получает фокус непосредственно на себя или делегирует фокус на отдельный внутренний подчиненный компонент и отображается так, как будто фокус наведен на этот компонент. Например, элемент управления TextInput содержит фокусируемый нижестоящий элемент управления RichEditableText, но когда на подчиненный компонент RichEditableText фактически наводится фокус, он отображается так, как будто фокус наведен на TextInput. TextInput устанавливает hasFocusableChildren на значение false, потому что TextInput считается компонентом, у которого есть фокус. Его внутренняя структура – абстракция.

Обычно только компоненты навигатора, например TabNavigator и Accordion, имеют этот флаг со значением true, потому что они получают фокус при нажатии на клавишу Tab. Фокус переходит на компоненты в нижестоящих контейнерах при дальнейших нажатиях на клавишу Tab.

Значением по умолчанию является false, за исключением компонента spark.components.Scroller. Для этого компонента используется значение по умолчанию true.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие hasFocusableChildrenChange .

Связанные элементы API

Содержит true, если элемент имеет трехмерную матрицу.

hasLayoutMatrix3D используется вместо вызова и исследования значения getLayoutMatrix3D() возвращаемых данных, так как этот метод возвращает действительную матрицу, даже если элемент используется в двухмерной графике.

Число, указывающее высоту компонента в координатах вышестоящего контейнера в пикселях. По умолчанию используется значение 0, однако это свойство содержит фактическую высоту компонента после того, как Flex завершит установку размеров компонентов в приложении.

Примечание. Можно указать процентное значение в атрибуте MXML height, например height=100%, но нельзя использовать процентное значение в свойстве height в ActionScript. Вместо этого используйте свойство percentHeight.

Настройка этого свойства приводит к отправке события resize. Для получения дополнительной информации о моменте отправки этого события см. событие resize.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие heightChanged .

Связанные элементы API

Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. Чтобы установить для свойства значение по умолчанию undefined, в MXML используется директива @Clear(), а в коде ActionScript - значение undefined. Например, в коде MXML horizontalCenter.s2="@Clear()" снимает ограничение horizontalCenter в состоянии s2. Или в коде ActionScript, где button.horizontalCenter = undefined снимает ограничение horizontalCenter для button.

Целевым объектом привязки по умолчанию является сам контейнер.

В макетах с расширенными ограничениями целевым объектом привязки может быть столбец ограничения. В этом случае областью содержимого является пространство между предыдущим столбцом (или стороной контейнера) и целевым столбцом.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "constraintColumnId:value". Например, "col1:10".

Идентификатор компонента. Это значение становится именем экземпляра объекта и не должно содержать символов пробела или специальных символов. Каждый компонент во всем приложении должен иметь уникальный идентификатор.

Если приложение будет тестироваться инструментальными средствами третьей стороны, каждому компоненту необходимо присвоить значимый идентификатор. Инструменты тестирования используют идентификаторы для представления элементов управления в своих сценариях, и значимое имя поможет сценариям стать более удобочитаемыми. Например, установите для кнопки значение submit_button, а не b1 или button1.

Указывает, включается ли этот компонент в макет вышестоящего контейнера. Если значение true, объект включается в макет соответствующего вышестоящего контейнера, и его размер и расположение определяются вышестоящим контейнером в соответствии с правилами его макета. Если значение false, размер и расположение объекта не зависят от макета соответствующего вышестоящего контейнера.

Значением по умолчанию является true.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие includeInLayoutChanged .

Начало этой цепочки компонентов с ненаследуемыми стилями. Метод getStyle() имеет доступ к inheritingStyles[styleName] для поиска всей связанной с прототипом цепочки. Этот объект настраивается initProtoChain(). Как правило, разработчикам не требуется вызывать это свойство напрямую.

Флаг, определяющий, прошел ли объект все три фазы создания макета: обязательство, измерение и создание макета (при условии, что все они требовались).

Индекс повторяемого компонента. Если компонент отсутствует в Repeater, значение равно -1.

Массив, содержащий индексы, требуемые для создания ссылки на этот UIComponent из собственного документа. Массив является пустым, пока этот объект UIComponent находится внутри одного или нескольких Repeater. Первый элемент соответствует самому крайнему Repeater. Например, если id является b, а instanceIndices является [2,4], ссылкой в вышестоящем документе будет b[2][4].

Содержит true, если элемент представлен в трехмерной графике. Данный элемент может использоваться в трехмерной графике, поскольку он имеет свойства трехмерного преобразования, последующие смещения при трехмерном преобразовании его макета или и то, и другое.

Содержит true, если этот экземпляр UIComponent является объектом документа. Это означает, что он находится наверху иерархии приложения Flex, компонента MXML или компонента ActionScript.

Установите значение true в PopUpManager для указания того, что компонент имеет всплывающую подсказку.

Матрица преобразования, которая используется для вычисления макета компонента относительно соответствующих элементов одного уровня. Эта матрица определяется трехмерными свойствами компонента (включают двухмерные свойства, такие как x, y, rotation, scaleX, scaleY, transformX, transformY, так же, как и rotationX, rotationY, scaleZ, z и transformZ.

Большая часть компонентов не имеет трехмерных свойств преобразования, для которых они установлены.

Эта матрица макета объединена со значениями свойства postLayoutTransformOffsets для определения последней вычисленной матрицы компонента.

Связанные элементы API

Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. Для того чтобы использовать значение по умолчанию undefined вместо зависящего от состояния значения свойства, используется директива @Clear() в MXML. Например, в коде MXML left.s2="@Clear()" снимает ограничение left в состоянии s2. Или в коде ActionScript, где button.left = undefined снимает ограничение left для button.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями целевым объектом может быть столбец ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "anchorTargetName:value". Например, "col1:10".