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

IStyleManager  - AS3 Flex

Пакетmx.styles
Интерфейсpublic interface IStyleManager

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

Класс IStyleManager определяет следующее:
  • какие свойства стиля CSS наследует класс;
  • какие свойства стиля являются цветами и поэтому требуют специальной обработки;
  • список строк, которые являются псевдонимами для значений цветов.
Этот интерфейс использовался в Flex 2.0.1. В Flex 3 вместо него используется IStyleManager2.

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



Общедоступные методы
 МетодОпределено
  
Очищает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.
IStyleManager
  
Возвращает числовое значение цвета RGB, соответствующее указанной строке цвета.
IStyleManager
  
Преобразовывает каждый элемент массива цветов из имени цвета в числовое значение цвета RGB.
IStyleManager
  
Получает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.
IStyleManager
  
Выполняет проверку того, является ли данная строка псевдонимом значения цвета.
IStyleManager
  
Выполняет проверку наследования стиля.
IStyleManager
  
Выполняет проверку наследования TextFormat.
IStyleManager
  
Выполняет проверку того, влияет ли этот стиль на нижестоящий контейнер компонента таким образом, что этот контейнер изменяется в случае изменения данного стиля.
IStyleManager
  
Выполняет проверку того, изменяет ли стиль размер нижестоящего контейнера компонента.
IStyleManager
  
Выполняет проверку того, изменяет ли стиль размер компонента.
IStyleManager
  
Определяет, является ли указанный параметр допустимым свойством style.
IStyleManager
  
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Загружает стиль SWF.
IStyleManager
  
registerColorName(colorName:String, colorValue:uint):void
Добавляет имя цвета в список псевдонимов цветов.
IStyleManager
  
Добавляет имя цвета в список стилей, которые могут наследовать значения вышестоящих элементов.
IStyleManager
  
Добавляет имя стиля в список стилей, которые могут влиять на внешний вид или макет нижестоящего контейнера компонента.
IStyleManager
  
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер нижестоящего контейнера компонента.
IStyleManager
  
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер компонента.
IStyleManager
  
setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
Устанавливает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.
IStyleManager
  
Выгружает стиль SWF.
IStyleManager
Сведения о методе

clearStyleDeclaration

()метод
public function clearStyleDeclaration(selector:String, update:Boolean):void

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

Очищает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.

Если указанный селектор является селектором класса (например, .bigMargins или .myStyle), имя свойства selector должно начинаться с точки (.).

Если указанный селектор является селектором типа (например, Button), имя свойства selector не должно начинаться с точки.

Селектор global подобен селектору типа и не начинается с точки.

Параметры

selector:String — Имя очищаемого селектора CSS.
 
update:Boolean — Значение true приводит к немедленному обновлению стилей. Значение false позволяет избежать немедленного обновления стилей в приложении. Для получения дополнительной информации об этом методе см. описание метода setStyleDeclaration().

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

getColorName

()метод 
public function getColorName(colorName:Object):uint

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

Возвращает числовое значение цвета RGB, соответствующее указанной строке цвета. Строка цвета может содержать либо не зависящее от регистра имя цвета, например red, Blue или haloGreen; шестнадцатеричное значение, например 0xFF0000, или шестнадцатеричную строку, начинающуюся с #, например #FF0000.

Этот метод возвращает значение uint, например 4521830, представляющее цвет. Можно преобразовать это значение uint в шестнадцатеричное значение путем передачи числовой основы (в данном случае – 16), в метод toString() класса uint, как показано в следующем примере:

      import mx.styles.StyleManager;
      private function getNewColorName():void {
          StyleManager.registerColorName("soylentGreen",0x44FF66);
          trace(StyleManager.getColorName("soylentGreen").toString(16));
      }
      

Параметры

colorName:Object — Имя цвета.

Возвращает
uint — Возвращает значение uint, представляющее значение цвета, или NOT_A_COLOR, если значение colorName свойства не является псевдонимом цвета.

getColorNames

()метод 
public function getColorNames(colors:Array):void

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

Преобразовывает каждый элемент массива цветов из имени цвета в числовое значение цвета RGB. Каждая строка цвета может либо содержать не зависящее от регистра имя цвета, например red, Blue или haloGreen; шестнадцатеричное значение, например 0xFF0000, либо являться шестнадцатеричной строкой, начинающейся с #, например #FF0000.

Параметры

colors:Array — Массив имен цветов.

getStyleDeclaration

()метод 
public function getStyleDeclaration(selector:String):CSSStyleDeclaration

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

Получает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.

Если параметр selector начинается с точки (.), возвращаемый CSSStyleDeclaration является селектором класса и применяется только к тем экземплярам, свойство styleName которых определяет этот селектор (исключая точку). Например, селектор класса .bigMargins применяется в отношении любого UIComponent, свойство styleName которого имеет значение bigMargins.

Если параметр selector не начинается с точки (.), возвращаемый CSSStyleDeclaration является селектором типа и применяется в отношении всех экземпляров этого типа. Например, селектор типа Button применяется в отношении всех экземпляров Button и соответствующих подклассов.

Селектор global подобен селектору типа и не начинается с точки.

Параметры

selector:String — Имя селектора CSS.

Возвращает
CSSStyleDeclaration — Объявление стиля, имя которого соответствует свойству selector.

isColorName

()метод 
public function isColorName(colorName:String):Boolean

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

Выполняет проверку того, является ли данная строка псевдонимом значения цвета. Например, по умолчанию строка blue является псевдонимом для 0x0000FF.

Параметры

colorName:String — Имя цвета, подлежащее проверке. Этот параметр не зависит от регистра.

Возвращает
Boolean — Возвращает true, если colorName является псевдонимом цвета.

isInheritingStyle

()метод 
public function isInheritingStyle(styleName:String):Boolean

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

Выполняет проверку наследования стиля.

Параметры

styleName:String — Имя стиля, подлежащее проверке наследования.

Возвращает
Boolean — Возвращает значение true, если указанный стиль наследуется.

isInheritingTextFormatStyle

()метод 
public function isInheritingTextFormatStyle(styleName:String):Boolean

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

Выполняет проверку наследования TextFormat.

Параметры

styleName:String — Имя стиля, подлежащее проверке наследования.

Возвращает
Boolean — Возвращает значение true, если указанный стиль TextFormat наследуется.

isParentDisplayListInvalidatingStyle

()метод 
public function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

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

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

Если один из этих стилей устанавливается с помощью setStyle(), для нижестоящего контейнера компонента автоматически вызывается метод invalidateDisplayList(), что приводит к изменению внешнего вида и/или макета соответствующих нижестоящих элементов.

Параметры

styleName:String — Имя стиля, подлежащего проверке.

Возвращает
Boolean — Возвращает значение true, если указанный стиль может влиять на внешний вид или макет нижестоящего контейнера компонента.

isParentSizeInvalidatingStyle

()метод 
public function isParentSizeInvalidatingStyle(styleName:String):Boolean

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

Выполняет проверку того, изменяет ли стиль размер нижестоящего контейнера компонента.

Если один из этих стилей устанавливается с помощью setStyle(), для нижестоящего контейнера компонента автоматически вызывается метод invalidateSize(), что приводит к повторному вычислению его измеренного размера на более позднем этапе.

Параметры

styleName:String — Имя стиля, подлежащего проверке.

Возвращает
Boolean — Возвращает значение true, если указанный стиль может влиять на измеренный размер нижестоящего контейнера компонента.

isSizeInvalidatingStyle

()метод 
public function isSizeInvalidatingStyle(styleName:String):Boolean

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

Выполняет проверку того, изменяет ли стиль размер компонента.

Если один из этих стилей устанавливается с помощью setStyle(), для компонента автоматически вызывается метод invalidateSize(), что приводит к повторному вычислению его измеренного размера на более позднем этапе.

Параметры

styleName:String — Имя стиля, подлежащего проверке.

Возвращает
Boolean — Возвращает значение true, если указанный стиль может влиять на измеренный размер компонента.

isValidStyleValue

()метод 
public function isValidStyleValue(value:*):Boolean

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

Определяет, является ли указанный параметр допустимым свойством style. Например:

      trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());
      

Такой подход является целесообразным, поскольку для некоторых стилей могут быть установлены такие значения, как 0, NaN, пустая строка ("") или null, что может привести к неуспешному завершению проверки if (value).

Параметры

value:* — Тестируемое свойство style.

Возвращает
Boolean — При передаче в этот метод значения, возвращаемого при вызове метода getStyle(), возвращается значение true, если стиль был установлен; в противном случае возвращается значение false.

loadStyleDeclarations

()метод 
public function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

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

Загружает стиль SWF.

Параметры

url:String — Местоположение стиля SWF.
 
update:Boolean (default = true) — Значение true приводит к немедленному обновлению стилей. Значение false позволяет избежать немедленного обновления стилей в приложении. Этот параметр является необязательным и по умолчанию имеет значение true. Для получения дополнительной информации об этом параметре см. описание метода setStyleDeclaration().
 
trustContent:Boolean (default = false) — Устарело, более не используется. Это дополнительный параметр, по умолчанию его значением является false.
 
applicationDomain:ApplicationDomain (default = null) — ApplicationDomain передается в метод load() класса IModuleInfo, который выполняет загрузку стиля SWF. Это дополнительный параметр и по умолчанию его значение null.
 
securityDomain:SecurityDomain (default = null) — SecurityDomain передается в метод load() класса IModuleInfo, который выполняет загрузку стиля SWF. Это дополнительный параметр и по умолчанию его значение null.

Возвращает
IEventDispatcher — Реализация IEventDispatcher, обеспечивающая поддержку StyleEvent.PROGRESS, StyleEvent.COMPLETE и StyleEvent.ERROR.

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

registerColorName

()метод 
public function registerColorName(colorName:String, colorValue:uint):void

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

Добавляет имя цвета в список псевдонимов цветов.

Параметры

colorName:String — Имя цвета, добавляемое в список; например blue. При последующем использовании этого имени цвета его значение не зависит от регистра.
 
colorValue:uint — Значение цвета, например 0x0000FF.

registerInheritingStyle

()метод 
public function registerInheritingStyle(styleName:String):void

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

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

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

Параметры

styleName:String — Имя стиля, добавляемое в список стилей, которые могут наследовать значения.

registerParentDisplayListInvalidatingStyle

()метод 
public function registerParentDisplayListInvalidatingStyle(styleName:String):void

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

Добавляет имя стиля в список стилей, которые могут влиять на внешний вид или макет нижестоящего контейнера компонента. Если один из этих стилей устанавливается с помощью setStyle(), для нижестоящего контейнера компонента автоматически вызывается метод invalidateDisplayList(), что приводит к изменению внешнего вида и/или макета соответствующих нижестоящих элементов.

Параметры

styleName:String — Имя стиля, подлежащего регистрации.

registerParentSizeInvalidatingStyle

()метод 
public function registerParentSizeInvalidatingStyle(styleName:String):void

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

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

Если один из этих стилей устанавливается с помощью setStyle(), для нижестоящего контейнера компонента автоматически вызывается метод invalidateSize(), что приводит к повторному вычислению его измеренного размера на более позднем этапе.

Параметры

styleName:String — Имя стиля, подлежащего регистрации.

registerSizeInvalidatingStyle

()метод 
public function registerSizeInvalidatingStyle(styleName:String):void

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

Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер компонента. Если один из этих стилей устанавливается с помощью setStyle(), для компонента автоматически вызывается метод invalidateSize(), что приводит к повторному вычислению его измеренного размера на более позднем этапе.

Параметры

styleName:String — Имя стиля, добавляемого в список.

setStyleDeclaration

()метод 
public function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void

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

Устанавливает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS.

Если параметр selector начинается с точки (.), указанный селектор является селектором класса и применяется только к тем экземплярам, свойство styleName которых определяет этот селектор (исключая точку). Например, селектор класса .bigMargins применяется в отношении любого UIComponent, свойство styleName которого имеет значение bigMargins.

Если параметр selector не начинается с точки (.), указанный селектор является селектором типа и применяется в отношении всех экземпляров этого типа. Например, селектор типа Button применяется в отношении всех экземпляров Button и соответствующих подклассов.

Селектор global подобен селектору типа и не начинается с точки.

Параметры

selector:String — Имя селектора CSS.
 
styleDeclaration:CSSStyleDeclaration — Объявление нового стиля.
 
update:Boolean — Значение true приводит к немедленному обновлению стилей; на внутреннем уровне Flex вызывает метод styleChanged() объекта UIComponent. Значение false позволяет избежать немедленного обновления стилей в приложении.

Стили обновляются при следующем вызове одного из перечисленных ниже методов со свойством update, имеющим значение true:

  • clearStyleDeclaration()
  • loadStyleDeclarations()
  • setStyleDeclaration()
  • unloadStyleDeclarations()

Как правило, при многократном вызове одного из этих методов значение true для данного свойства устанавливается только при последнем вызове, это позволяет избежать многократного вызова метода styleChanged() приложением Flex.

При вызове метода getStyle() Flex возвращает значение стиля, который последним применялся в отношении UIComponent, посредством вызова метода styleChanged(). Внешний вид компонента может не отражать значение, возвращаемое методом getStyle(). Это происходит по той причине, что один из этих методов объявления стиля, возможно, еще не был вызван со свойством update, имеющим значение true.

unloadStyleDeclarations

()метод 
public function unloadStyleDeclarations(url:String, update:Boolean = true):void

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

Выгружает стиль SWF.

Параметры

url:String — Местоположение стиля SWF.
 
update:Boolean (default = true) — Значение true приводит к немедленному обновлению стилей. Значение false позволяет избежать немедленного обновления стилей в приложении. Для получения дополнительной информации об этом методе см. описание метода setStyleDeclaration().

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





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

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