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

CSSStyleDeclaration  - AS3 Flex

Пакетmx.styles
Классpublic class CSSStyleDeclaration
НаследованиеCSSStyleDeclaration Inheritance EventDispatcher Inheritance Object
Подклассы AdvancedDataGridColumn, DataGridColumn

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

Класс CSSStyleDeclaration представляет набор правил стиля CSS. Компилятор MXML автоматически генерирует один объект CSSStyleDeclaration для каждого селектора в файлах CSS, связанных с приложением Flex.

Правило CSS, например

      Button { color: #FF0000 }
  
влияет на каждый экземпляр класса Button; аналогичный селектору класс Button называется селектором типа и не должен начинаться с точки.

Правило CSS, например

      .redButton { color: #FF0000 }
  
влияет только на компоненты, свойство styleName которых устанавливается как redButton; аналогичный селектору класс .redButton называется селектором класса и должен начинаться с точки.

Можно получить доступ к автоматически создаваемым объектам CSSStyleDeclaration, использующим метод StyleManager.getStyleDeclaration() при передаче либо селектора типа

  var buttonDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration("Button");
  
, либо селектора класса
  var redButtonStyleDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration(".redButton");
  

Для получения, установки и удаления свойств style в CSSStyleDeclaration можно использовать методы getStyle(), setStyle() и clearStyle().

Кроме того, можно динамически создать и установить CSSStyleDeclaration с использованием метода StyleManager.setStyleDeclaration():

  var newStyleDeclaration:CSSStyleDeclaration = new CSSStyleDeclaration(".bigMargins");
  newStyleDeclaration.defaultFactory = function():void
  {
      leftMargin = 50;
      rightMargin = 50;
  }
  StyleManager.setStyleDeclaration(".bigMargins", newStyleDeclaration, true);
  

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  defaultFactory : Function
Эта функция, если она не имеет значения null, обычно автоматически генерируется компилятором MXML.
CSSStyleDeclaration
  factory : Function
Эта функция, если она не имеет значения null, обычно автоматически генерируется компилятором MXML.
CSSStyleDeclaration
  overrides : Object
При динамическом вызове метода setStyle() для объекта UIComponent или CSSStyleDeclaration этот объект сохраняет установленные пары «имя-значение»; они переопределяют соответствующие пары в объектах, которые создаются посредством методов, указанных defaultFactory и свойствами factory.
CSSStyleDeclaration
  selector : CSSSelector
Это свойство является базовым селектором в потенциальной цепочке селекторов и условий, используемых для установления соответствия между объявлениями стилями CSS и компонентами.
CSSStyleDeclaration
  selectorIndex : int = 0
Порядок, в котором этот CSSStyleDeclaration был добавлен к StyleManager.
CSSStyleDeclaration
  specificity : int
[только для чтения] Определяет приоритеты в случае применения нескольких объявлений стиля в отношении компонента.
CSSStyleDeclaration
  subject : String
[только для чтения] Тема описывает имя компонента, который может являться потенциальным совпадением для этого объявления стиля.
CSSStyleDeclaration
Общедоступные методы
 МетодОпределено
  
CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)
Конструктор.
CSSStyleDeclaration
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
Очищает свойства стиля этого объекта CSSStyleDeclaration.
CSSStyleDeclaration
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
getStyle(styleProp:String):*
Получает значение для указанного свойства style в соответствии с определением исключительно для этого объекта CSSStyleDeclaration.
CSSStyleDeclaration
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Определяет, применяется ли это объявление стиля в отношении данного компонента, на основе соответствия селекторной цепочки.
CSSStyleDeclaration
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setStyle(styleProp:String, newValue:*):void
Устанавливает свойство style для этого CSSStyleDeclaration.
CSSStyleDeclaration
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве

defaultFactory

свойство
defaultFactory:Function

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

Эта функция, если она не имеет значения null, обычно автоматически генерируется компилятором MXML. Это приводит к копированию простого объекта, например { leftMargin: 10, rightMargin: 10 }, содержащего пары «имя-значение» для свойства style; данный объект используется для формирования узла цепочки прототипов для поиска свойств style.

Если этот CSSStyleDeclaration принадлежит объекту UIComponent, записанному в MXML, эта функция кодирует атрибуты стиля, указанные в корневом теге определения компонента.

Если UIComponent был записан в ActionScript, для этого свойства устанавливается значение null.



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

factory

свойство 
factory:Function

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

Эта функция, если она не имеет значения null, обычно автоматически генерируется компилятором MXML. Это приводит к копированию простого объекта, например { leftMargin: 10, rightMargin: 10 }, содержащего пары «имя-значение» для свойства style; данный объект используется для формирования узла цепочки прототипов для поиска свойств style.

Если этот CSSStyleDeclaration принадлежит объекту UIComponent, данная функция кодирует атрибуты стиля, указанные в MXML для экземпляра этого компонента.



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

overrides

свойство 
overrides:Object

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

При динамическом вызове метода setStyle() для UIComponent или CSSStyleDeclaration этот объект сохраняет установленные пары «имя-значение»; они переопределяют соответствующие пары в объектах, которые создаются посредством методов, указанных defaultFactory и свойствами factory.



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

selector

свойство 
selector:CSSSelector

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

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



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

selectorIndex

свойство 
public var selectorIndex:int = 0

Порядок, в котором этот CSSStyleDeclaration был добавлен к StyleManager. MatchStyleDeclarations должен возвратить объявления согласно порядку, в котором они были объявлены

specificity

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

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

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



Реализация
    public function get specificity():int

subject

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

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

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



Реализация
    public function get subject():String
Сведения о конструкторе

CSSStyleDeclaration

()Конструктор
public function CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)

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

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

Параметры
selector:Object (default = null) — - если селектор является селектором CSSSelector, то поддерживаются расширенные селекторы CSS. Если для селектора используется String, то поддерживаются только простые селекторы CSS. Если String начинается с точки, этот объект интерпретируется как универсальный селектор класса, в противном случае он представляет простой селектор типа. Если значение не равно null, этот CSSStyleDeclaration будет зарегистрирован с помощью StyleManager.
 
styleManager:IStyleManager2 (default = null) — - Менеджер стиля для установки этого объявления. Если styleManager имеет значение null, используется менеджер стиля верхнего уровня.
 
autoRegisterWithStyleManager:Boolean (default = true) — - Если true, установите селектор в styleManager. Селектор будет установлен только в том случае, если оба значения, selector и styleManager, не равны null.
Сведения о методе

clearStyle

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

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

Очищает свойства стиля этого объекта CSSStyleDeclaration. Это аналогично установке значения стиля undefined.

Параметры

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

getStyle

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

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

Получает значение для указанного свойства style в соответствии с определением исключительно для этого объекта CSSStyleDeclaration.

Возвращаемое значение может быть значением любого типа.

Допустимыми значениями стиля могут являться значения null, "", false, NaN и 0, но не значение undefined, поскольку это означает, что указанный стиль не установлен для данного CSSStyleDeclaration. Для проверки того, какое значение возвращается, можно использовать метод StyleManager.isValidStyleValue().

Параметры

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

Возвращает
* — Значение указанного свойства style, если оно установлено, в противном случае – undefined.

matchesStyleClient

()метод 
public function matchesStyleClient(object:IAdvancedStyleClient):Boolean

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

Определяет, применяется ли это объявление стиля в отношении данного компонента, на основе соответствия селекторной цепочки.

Параметры

object:IAdvancedStyleClient — Компонент для сопоставления объявления стиля.

Возвращает
Boolean — true, если это объявление стиля применяется в отношении компонента, в противном случае – false.

setStyle

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

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

Устанавливает свойство style для этого CSSStyleDeclaration.

Параметры

styleProp:String — Имя свойства стиля.
 
newValue:* — Значение свойства style. Это значение может быть любого типа. Допустимыми значениями стиля могут являться значения null, "", false, NaN и 0, но не значение undefined. Установка для свойства style значения undefined аналогична вызову метода clearStyle().





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

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