| Пакет | mx.styles |
| Класс | public class AdvancedStyleClient |
| Наследование | AdvancedStyleClient EventDispatcher Object |
| Реализует | IAdvancedStyleClient, IFlexModule, IMXMLObject |
| Подклассы | GlobalizationBase, Sort, SortField |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
IAdvancedStyleClient. Базовый класс предоставляет реализации методов и свойств, требуемых для участия объекта в подсистеме стиля.
В дополнение к интерфейсу IAdvancedStyleClient этот объект также реализует интерфейсы IFlexModule и IMXMLObject. Интерфейс IMXMLObject содержит метод initialized, который вызывается при создании экземпляра класса, использующего объявление MXML. Реализация метода initialized, предоставленная этим классом, добавит экземпляр класса в объект документа, содержащий объявление MXML. Для получения дополнительной информации см. описание метода initilized.
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
| className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| id : String
Идентификатор компонента. | AdvancedStyleClient | ||
| inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | ||
| moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | ||
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | ||
| styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом. | AdvancedStyleClient | ||
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | AdvancedStyleClient | ||
| styleName : Object
Источник значений стиля данного объекта. | AdvancedStyleClient | ||
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | AdvancedStyleClient | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | AdvancedStyleClient | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Удаляет свойство style для экземпляра компонента. | AdvancedStyleClient | ||
![]() |
Посылает событие в поток событий. | EventDispatcher | |
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует. | AdvancedStyleClient | ||
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | AdvancedStyleClient | ||
Возвращает true, если для currentCSSState не указано значение null. | AdvancedStyleClient | ||
![]() |
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML. | AdvancedStyleClient | ||
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Возвращает значение true, если cssState совпадает с currentCSSState. | AdvancedStyleClient | ||
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | AdvancedStyleClient | ||
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля. | AdvancedStyleClient | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle(). | AdvancedStyleClient | ||
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | AdvancedStyleClient | ||
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
Задает свойство style для экземпляра компонента. | AdvancedStyleClient | ||
Обеспечивает обнаружение изменений в свойствах стиля. | AdvancedStyleClient | ||
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | AdvancedStyleClient | ||
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
className | свойство |
id | свойство |
inheritingStyles | свойство |
inheritingStyles:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем.
Реализация
public function get inheritingStyles():Object public function set inheritingStyles(value:Object):voidmoduleFactory | свойство |
moduleFactory:IFlexModuleFactory| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем.
Реализация
public function get moduleFactory():IFlexModuleFactory public function set moduleFactory(value:IFlexModuleFactory):voidnonInheritingStyles | свойство |
nonInheritingStyles:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Начало цепочки этого компонента с ненаследуемыми стилями. Метод getStyle() имеет доступ к nonInheritingStyles[styleName] для поиска всей связанной с прототипом цепочки. Этот объект настраивается initProtoChain(). Как правило, разработчикам не требуется вызывать это свойство напрямую.
Реализация
public function get nonInheritingStyles():Object public function set nonInheritingStyles(value:Object):voidstyleDeclaration | свойство |
styleDeclaration:CSSStyleDeclaration| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Объявление стиля, которое содержит действующие стили, объявленные этим объектом.
Реализация
public function get styleDeclaration():CSSStyleDeclaration public function set styleDeclaration(value:CSSStyleDeclaration):voidСвязанные элементы API
styleManager | свойство |
styleManager:IStyleManager2 [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает экземпляр StyleManager, используемый этим компонентом.
Реализация
public function get styleManager():IStyleManager2styleName | свойство |
styleName:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Источник значений стиля данного объекта. Значение свойства styleName может относиться к одному из трех возможных типов:
- String, например headerStyle. String определяет селектор класса, указанный в таблице стилей CSS.
- CSSStyleDeclaration, например
StyleManager.getStyleDeclaration(".headerStyle"). - UIComponent. Объект, реализующий этот интерфейс, наследует все значения стиля компонента UIComponent, на который выполняется ссылка.
Реализация
public function get styleName():Object public function set styleName(value:Object):voidstyleParent | свойство |
styleParent:IAdvancedStyleClient| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. Вышестоящий узел должен также быть IAdvancedStyleClient для участия в расширенных объявлениях стиля.
Реализация
public function get styleParent():IAdvancedStyleClient public function set styleParent(value:IAdvancedStyleClient):voidAdvancedStyleClient | () | Конструктор |
public function AdvancedStyleClient()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Конструктор.
clearStyle | () | метод |
public function clearStyle(styleProp:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Удаляет свойство style для экземпляра компонента.
Это не обязательно приводит к тому, что метод getStyle() возвращает значение undefined.
Параметры
styleProp:String — Имя свойства стиля.
|
getClassStyleDeclarations | () | метод |
public function getClassStyleDeclarations():Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.
Например, предположим, что компонент MyButton применяется для расширения компонента Button. Вначале метод обеспечивает поиск селектора MyButton, затем производится поиск селектора типа Button и, в завершении, поиск селектора типа UIComponent.
ВозвращаетArray — Массив объектов CSSStyleDeclaration.
|
getStyle | () | метод |
public function getStyle(styleProp:String):*| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
Один и тот же метод используется для получения свойства style любого типа, таким образом, возвращаемое значение может являться Boolean, String, Number, int, uint (для цвета RGB), Class (для темы оформления) или объектом любого типа. Поэтому вид возврата указывается как *.
При получении определенного свойства style появляется информация о его типе, и часто требуется сохранить результат в переменной этого типа. Для этого можно использовать либо оператор as, либо неявное преобразование. Например:
var backgroundColor:uint = getStyle("backgroundColor") as int;
or
var backgroundColor:uint = int(getStyle("backgroundColor"));
Если свойство style не было установлено в любом месте цепочки поиска стиля, метод возвращает getStyle() значение undefined. Следует отметить, что значение undefined является специальным значением, которое не совпадает со значением false, пустой строкой (""), NaN, 0 или null. Значение действительного стиля не может быть undefined. Для проверки того, было ли задано значение, можно использовать статический метод StyleManager.isValidStyleValue().
Параметры
styleProp:String — Имя свойства стиля.
|
* — Значение стиля.
|
hasCSSState | () | метод |
public function hasCSSState():Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает true, если для currentCSSState не указано значение null. Этот метод обычно не вызывается напрямую. Вызов выполняет метод mx.styles.CSSCondition.matchesStyleClient().
Компоненты Spark используют состояние своих тем оформления в качестве псевдосостояния. Компоненты Halo используют свойство currentState.
Boolean — Возвращает true, если для currentCSSState не указано значение null. currentCSSState совпадает с currentState по умолчанию. Если состояние не существует, возвращается false.
|
initialized | () | метод |
public function initialized(document:Object, id:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML. Вызывается после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML.
Если документ, в котором создан этот объект, является UIComponent, например Application, Module и т. д., то для добавления этого объекта к списку клиентов с невизуальным стилем UIComponent вызывается метод addStyleClient UIComponent. В этом случае объект может наследовать стили из документа.
Параметры
document:Object — Документ MXML, создавший этот объект.
| |
id:String — Идентификатор, используемый объектом документа в качестве ссылки на этот объект.
|
matchesCSSState | () | метод |
public function matchesCSSState(cssState:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает true, если cssState совпадает с currentCSSState. Этот метод обычно не вызывается напрямую. Вызов выполняет метод mx.styles.CSSCondition.matchesStyleClient().
Компоненты Spark используют состояние своих тем оформления в качестве псевдосостояния. Компоненты Halo используют свойство currentState.
Параметры
cssState:String — Возможное значение CSSCondition.value. Оно представляет текущее состояние этого компонента, используемое для установления соответствия с псевдоселекторами CSS.
|
Boolean — true, если cssState совпадает с currentCSSState. currentCSSState совпадает с currentState по умолчанию. Если состояние не существует, возвращается null.
|
matchesCSSType | () | метод |
public function matchesCSSType(cssType:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). Этот метод обычно не вызывается напрямую. Вызов выполняет метод mx.styles.CSSCondition.matchesStyleClient().
Параметры
cssType:String — Объект CSSSelector.
|
Boolean — true, если cssType находится в иерархии полных селекторов типа.
|
notifyStyleChangeInChildren | () | метод |
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля. Клиент с невизуальным стилем (то есть клиент стиля, который не является DisplayObject) не имеет нижестоящих элементов, поэтому этот метод не воздействует на клиенты с невизуальным стилем.
Параметры
styleProp:String — Имя свойства стиля.
| |
recursive:Boolean — Указывает, следует ли распространять изменения стиля для нижестоящих элементов этих нижестоящих элементов.
|
regenerateStyleCache | () | метод |
public function regenerateStyleCache(recursive:Boolean):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle().
Параметры
recursive:Boolean — Обеспечивает повторное создание первичных цепочек нижестоящих элементов.
|
registerEffects | () | метод |
public function registerEffects(effects:Array):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.
Параметры
effects:Array — Массив строк имен эффектов.
|
setStyle | () | метод |
public function setStyle(styleProp:String, newValue:*):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Задает свойство style для экземпляра компонента.
Оно может переопределить стиль, который был задан на глобальном уровне.
Вызов метода setStyle() может привести к снижению производительности. Используйте его только в случае необходимости.
Параметры
styleProp:String — Имя свойства стиля.
| |
newValue:* — Новое значение стиля.
|
styleChanged | () | метод |
public function styleChanged(styleProp:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обеспечивает обнаружение изменений в свойствах стиля. После установки любого свойства стиля в программе Flex выполняется вызов метода styleChanged() и передача в него имени установленного стиля.
Это усовершенствованный метод, который можно переопределить при создании подкласса AdvancedStyleClient. При создании пользовательского класса можно переопределить метод styleChanged(), чтобы проверить переданное в него имя стиля и соответствующим образом обработать изменение. Это позволяет отменять заданное по умолчанию поведение существующего стиля или добавить собственные пользовательские свойства стиля.
Параметры
styleProp:String — Имя свойства стиля или значение null, если все стили для этого клиента стиля были изменены.
|
stylesInitialized | () | метод |
public function stylesInitialized():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства