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

StyleProxy  - AS3 Flex

Пакетmx.styles
Классpublic class StyleProxy
НаследованиеStyleProxy Inheritance Object
Реализует IAdvancedStyleClient

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

Вставляет объект, реализующий интерфейс IAdvancedStyleClient. Этот интерфейс поддерживает свойство filterMap, содержащее пары «стиль-источник/стиль-целевой объект».

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



Общедоступные свойства
 СвойствоОпределено
  className : String
[только для чтения] Имя класса компонента.
StyleProxy
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  filterMap : Object
Набор пар String.
StyleProxy
  id : String
[только для чтения] Идентификатор компонента.
StyleProxy
  inheritingStyles : Object
Объект, содержащий наследуемые стили для этого компонента.
StyleProxy
  nonInheritingStyles : Object
Объект, содержащий ненаследуемые стили для этого компонента.
StyleProxy
  source : IStyleClient
Объект, реализующий интерфейс IStyleClient.
StyleProxy
  styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом.
StyleProxy
  styleName : Object
Источник значений стиля данного объекта.
StyleProxy
  styleParent : IAdvancedStyleClient
Вышестоящий узел IAdvancedStyleClient.
StyleProxy
Общедоступные методы
 МетодОпределено
  
StyleProxy(source:IStyleClient, filterMap:Object)
Конструктор.
StyleProxy
  
Удаляет свойство style для экземпляра компонента.
StyleProxy
  
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.
StyleProxy
  
getStyle(styleProp:String):*
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
StyleProxy
  
Возвращает true, если для currentCSSState не указано значение null.
StyleProxy
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Возвращает значение true, если cssState совпадает с currentCSSState.
StyleProxy
  
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом).
StyleProxy
  
Обеспечивает распространение изменений стиля для нижестоящих элементов этого компонента.
StyleProxy
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle().
StyleProxy
  
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.
StyleProxy
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setStyle(styleProp:String, newValue:*):void
Задает свойство style для экземпляра компонента.
StyleProxy
  
Вызывается при изменении значения свойства стиля.
StyleProxy
  
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.
StyleProxy
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

className

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

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

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



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

filterMap

свойство 
filterMap:Object

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

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



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

id

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

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

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



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

inheritingStyles

свойство 
inheritingStyles:Object

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

Объект, содержащий наследуемые стили для этого компонента.



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

nonInheritingStyles

свойство 
nonInheritingStyles:Object

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

Объект, содержащий ненаследуемые стили для этого компонента.



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

source

свойство 
source:IStyleClient

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

Объект, реализующий интерфейс IStyleClient. Это объект прокси.



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

styleDeclaration

свойство 
styleDeclaration:CSSStyleDeclaration

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

Объявление стиля, которое содержит действующие стили, объявленные этим объектом.



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

styleName

свойство 
styleName:Object

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

Источник значений стиля данного объекта. Значение свойства 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
Версии среды выполнения: Flash Player 10, AIR 1.5

Вышестоящий узел IAdvancedStyleClient. Как правило, это свойство не устанавливается напрямую. Оно устанавливается методами addChild, addChildAt, removeChild и removeChildAt методов flash.display.DisplayObjectContainer, mx.core.UIComponent.addStyleClient() и mx.core.UIComponent.removeStyleClient(). Если значение присваивается этому свойству напрямую, без вызова одного из вышеуказанных методов, экземпляр класса, который реализует этот интерфейс, не будет наследовать стили из UIComponent или DisplayObject. Также если значение устанавливается для свойства напрямую, без предварительного удаления объекта из текущего вышестоящего узла с помощью методов, указанных выше, может произойти утечка памяти.



Реализация
    public function get styleParent():IAdvancedStyleClient
    public function set styleParent(value:IAdvancedStyleClient):void
Сведения о конструкторе

StyleProxy

()Конструктор
public function StyleProxy(source:IStyleClient, filterMap:Object)

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

Конструктор.

Параметры
source:IStyleClient — Объект, реализующий интерфейс IStyleClient.
 
filterMap:Object — Набор стилей для передачи из источника в подчиненный компонент.
Сведения о методе

clearStyle

()метод
public function clearStyle(styleProp:String):void

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

Удаляет свойство style для экземпляра компонента.

Это не обязательно приводит к тому, что метод getStyle() возвращает значение undefined.

Параметры

styleProp:String — Имя свойства стиля.

getClassStyleDeclarations

()метод 
public function getClassStyleDeclarations():Array

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

Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.

Например, предположим, что компонент MyButton применяется для расширения компонента Button. Вначале метод обеспечивает поиск селектора MyButton, затем производится поиск селектора типа Button и, в завершении, поиск селектора типа UIComponent.

Возвращает
Array — Массив объектов CSSStyleDeclaration.

getStyle

()метод 
public function getStyle(styleProp:String):*

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

Получает свойство 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.

matchesCSSState

()метод 
public function matchesCSSState(cssState:String):Boolean

Язык версии: ActionScript 3.0
Версия продукта: Flex 4
Версии среды выполнения: Flash Player 10, AIR 1.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
Версии среды выполнения: Flash Player 10, AIR 1.5

Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). Этот метод обычно не вызывается напрямую. Вызов выполняет метод mx.styles.CSSCondition.matchesStyleClient().

Параметры

cssType:String — Объект CSSSelector.

Возвращает
Booleantrue, если cssType находится в иерархии полных селекторов типа.

notifyStyleChangeInChildren

()метод 
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void

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

Обеспечивает распространение изменений стиля для нижестоящих элементов этого компонента.

Параметры

styleProp:String — Имя свойства стиля.
 
recursive:Boolean — Указывает, следует ли распространять изменения стиля для нижестоящих элементов этих нижестоящих элементов.

regenerateStyleCache

()метод 
public function regenerateStyleCache(recursive:Boolean):void

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

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

Параметры

recursive:Boolean — Обеспечивает повторное создание первичных цепочек нижестоящих элементов.

registerEffects

()метод 
public function registerEffects(effects:Array):void

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

Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.

Параметры

effects:Array — Массив строк имен эффектов.

setStyle

()метод 
public function setStyle(styleProp:String, newValue:*):void

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

Задает свойство style для экземпляра компонента.

Оно может переопределить стиль, который был задан на глобальном уровне.

Вызов метода setStyle() может привести к снижению производительности. Используйте его только в случае необходимости.

Параметры

styleProp:String — Имя свойства стиля.
 
newValue:* — Новое значение стиля.

styleChanged

()метод 
public function styleChanged(styleProp:String):void

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

Вызывается при изменении значения свойства стиля.

Параметры

styleProp:String — Имя измененного свойства стиля.

stylesInitialized

()метод 
public function stylesInitialized():void

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

Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.





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

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