Пакет | 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):void
moduleFactory | свойство |
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):void
nonInheritingStyles | свойство |
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):void
styleDeclaration | свойство |
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():IStyleManager2
styleName | свойство |
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):void
styleParent | свойство |
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):void
AdvancedStyleClient | () | Конструктор |
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