Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.styles 

AdvancedStyleClient  - AS3 Flex

Пакетmx.styles
Классpublic class AdvancedStyleClient
НаследованиеAdvancedStyleClient Inheritance EventDispatcher Inheritance 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
 Inheritedconstructor : 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
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
Удаляет свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.
AdvancedStyleClient
  
getStyle(styleProp:String):*
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
AdvancedStyleClient
  
Возвращает true, если для currentCSSState не указано значение null.
AdvancedStyleClient
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML.
AdvancedStyleClient
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Возвращает значение true, если cssState совпадает с currentCSSState.
AdvancedStyleClient
  
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом).
AdvancedStyleClient
  
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля.
AdvancedStyleClient
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle().
AdvancedStyleClient
  
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setStyle(styleProp:String, newValue:*):void
Задает свойство style для экземпляра компонента.
AdvancedStyleClient
  
Обеспечивает обнаружение изменений в свойствах стиля.
AdvancedStyleClient
  
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.
AdvancedStyleClient
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве

className

свойство
className:String  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Имя класса компонента.



Реализация
    public function get className():String

id

свойство 
id:String

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10, AIR 2.5

Идентификатор компонента.



Реализация
    public function get id():String
    public function set id(value:String):void

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.

Возвращает
Booleantrue, если 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.

Возвращает
Booleantrue, если 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 при первой инициализации стиля компонента.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.