Пакет | mx.styles |
Класс | public class StyleManager |
Наследование | StyleManager Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
- какие свойства стиля CSS наследует класс;
- какие свойства стиля являются цветами и поэтому требуют специальной обработки;
- список строк, которые являются псевдонимами для значений цветов.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
selectors : Array Устарело с 4.0: Используйте IStyleManager2.selectors on a style manager instance [статические] [только для чтения]
Возвращает массив, состоящий из всех селекторов CSS, зарегистрированных в StyleManager. | StyleManager |
Метод | Определено | ||
---|---|---|---|
Устарело с 4.0: Используйте IStyleManager2.clearStyleDeclaration on a style manager instance [статические]
Очищает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.getColorName on a style manager instance [статические]
Возвращает числовое значение цвета RGB, соответствующее указанной строке цвета. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.getColorNames on a style manager instance [статические]
Преобразовывает каждый элемент массива цветов из имени цвета в числовое значение цвета RGB. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.getStyleDeclaration on a style manager instance [статические]
Получает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS. | StyleManager | ||
[статические]
Возвращает менеджер стиля для объекта. | StyleManager | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Устарело с 4.0: Используйте IStyleManager2.isColorName on a style manager instance [статические]
Выполняет проверку того, является ли данная строка псевдонимом значения цвета. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.isInheritingStyle on a style manager instance [статические]
Выполняет проверку наследования стиля. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.isInheritingTextFormatStyle on a style manager instance [статические]
Выполняет проверку наследования TextFormat. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.isParentDisplayListInvalidatingStyle on a style manager instance [статические]
Выполняет проверку того, влияет ли этот стиль на нижестоящий контейнер компонента таким образом, что этот контейнер изменяется в случае изменения данного стиля. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.isParentSizeInvalidatingStyle on a style manager instance [статические]
Выполняет проверку того, изменяет ли стиль размер нижестоящего контейнера компонента. | StyleManager | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Устарело с 4.0: Используйте IStyleManager2.isSizeInvalidatingStyle on a style manager instance [статические]
Выполняет проверку того, изменяет ли стиль размер компонента. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.isValidStyleValue on a style manager instance [статические]
Определяет, является ли указанный параметр допустимым свойством style. | StyleManager | ||
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher Устарело с 4.0: Используйте IStyleManager2.loadStyleDeclarations on a style manager instance [статические]
Загружает стиль SWF. | StyleManager | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Устарело с 4.0: Используйте IStyleManager2.registerColorName on a style manager instance [статические]
Добавляет имя цвета в список псевдонимов цветов. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.registerInheritingStyle on a style manager instance [статические]
Добавляет имя цвета в список стилей, которые могут наследовать значения вышестоящих элементов. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.registerParentDisplayListInvalidatingStyle on a style manager instance [статические]
Добавляет имя стиля в список стилей, которые могут влиять на внешний вид или макет нижестоящего контейнера компонента. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.registerParentSizeInvalidatingStyle on a style manager instance [статические]
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер нижестоящего контейнера компонента. | StyleManager | ||
Устарело с 4.0: Используйте IStyleManager2.registerSizeInvalidatingStyle on a style manager instance [статические]
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер компонента. | StyleManager | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Устарело с 4.0: Используйте IStyleManager2.setStyleDeclaration on a style manager instance [статические]
Устанавливает объект CSSStyleDeclaration, в котором сохраняются правила для указанного селектора CSS. | StyleManager | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Устарело с 4.0: Используйте IStyleManager2.unloadStyleDeclarations on a style manager instance [статические]
Выгружает стиль SWF. | StyleManager | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
NOT_A_COLOR : uint = 0xFFFFFFFF [статические]
Метод getColorName() возвращает это значение, если передаваемая строка не является допустимым именем цвета. | StyleManager |
selectors | свойство |
selectors:Array
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив, состоящий из всех селекторов CSS, зарегистрированных в StyleManager. Можно передать элементы этого массива в метод getStyleDeclaration()
для получения соответствующего объекта CSSStyleDeclaration. Имена селекторов класса начинаются с точки.
Реализация
public static function get selectors():Array
clearStyleDeclaration | () | метод |
public static 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 static 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 static 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 static 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 .
|
getStyleManager | () | метод |
public static function getStyleManager(moduleFactory:IFlexModuleFactory):IStyleManager2
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает менеджер стиля для объекта.
Параметры
moduleFactory:IFlexModuleFactory — Фабрика модулей объекта, для которого необходим этот менеджер стилей. Если значение null, возвращается менеджер стилей верхнего уровня.
|
IStyleManager2 — менеджер стиля для указанной фабрики модулей.
|
isColorName | () | метод |
public static 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 static function isInheritingStyle(styleName:String):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет проверку наследования стиля.
Параметры
styleName:String — Имя стиля, подлежащее проверке наследования.
|
Boolean — Возвращает значение true , если указанный стиль наследуется.
|
isInheritingTextFormatStyle | () | метод |
public static function isInheritingTextFormatStyle(styleName:String):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет проверку наследования TextFormat.
Параметры
styleName:String — Имя стиля, подлежащее проверке наследования.
|
Boolean — Возвращает значение true , если указанный стиль TextFormat наследуется.
|
isParentDisplayListInvalidatingStyle | () | метод |
public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет проверку того, влияет ли этот стиль на нижестоящий контейнер компонента таким образом, что этот контейнер изменяется в случае изменения данного стиля.
Если один из этих стилей устанавливается с помощью setStyle()
, для нижестоящего контейнера компонента автоматически вызывается метод invalidateDisplayList()
, что приводит к изменению внешнего вида и/или макета соответствующих нижестоящих элементов.
Параметры
styleName:String — Имя стиля, подлежащего проверке.
|
Boolean — Возвращает значение true , если указанный стиль может влиять на внешний вид или макет нижестоящего контейнера компонента.
|
isParentSizeInvalidatingStyle | () | метод |
public static function isParentSizeInvalidatingStyle(styleName:String):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет проверку того, изменяет ли стиль размер нижестоящего контейнера компонента.
Если один из этих стилей устанавливается с помощью setStyle()
, для нижестоящего контейнера компонента автоматически вызывается метод invalidateSize()
, что приводит к повторному вычислению его измеренного размера на более позднем этапе.
Параметры
styleName:String — Имя стиля, подлежащего проверке.
|
Boolean — Возвращает значение true , если указанный стиль может влиять на измеренный размер нижестоящего контейнера компонента.
|
isSizeInvalidatingStyle | () | метод |
public static function isSizeInvalidatingStyle(styleName:String):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет проверку того, изменяет ли стиль размер компонента.
Если один из этих стилей устанавливается с помощью setStyle()
, для компонента автоматически вызывается метод invalidateSize()
, что приводит к повторному вычислению его измеренного размера на более позднем этапе.
Параметры
styleName:String — Имя стиля, подлежащего проверке.
|
Boolean — Возвращает значение true , если указанный стиль может влиять на измеренный размер компонента.
|
isValidStyleValue | () | метод |
public static 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 static function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | 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 static 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 static function registerInheritingStyle(styleName:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет имя цвета в список стилей, которые могут наследовать значения вышестоящих элементов.
Примечание. Убедитесь, что повторяющиеся имена стилей не используются, поскольку, при наследовании уже используемого стиля, возникающие конфликты имен могут привести к снижению производительности системы,.
Параметры
styleName:String — Имя стиля, добавляемое в список стилей, которые могут наследовать значения.
|
registerParentDisplayListInvalidatingStyle | () | метод |
public static function registerParentDisplayListInvalidatingStyle(styleName:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет имя стиля в список стилей, которые могут влиять на внешний вид или макет нижестоящего контейнера компонента. Если один из этих стилей устанавливается с помощью setStyle()
, для нижестоящего контейнера компонента автоматически вызывается метод invalidateDisplayList()
, что приводит к изменению внешнего вида и/или макета соответствующих нижестоящих элементов.
Параметры
styleName:String — Имя стиля, подлежащего регистрации.
|
registerParentSizeInvalidatingStyle | () | метод |
public static function registerParentSizeInvalidatingStyle(styleName:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер нижестоящего контейнера компонента.
Если один из этих стилей устанавливается с помощью setStyle()
, для нижестоящего контейнера компонента автоматически вызывается метод invalidateSize()
, что приводит к повторному вычислению его измеренного размера на более позднем этапе.
Параметры
styleName:String — Имя стиля, подлежащего регистрации.
|
registerSizeInvalidatingStyle | () | метод |
public static function registerSizeInvalidatingStyle(styleName:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет имя стиля в список стилей, которые могут влиять на измеренный размер компонента. Если один из этих стилей устанавливается с помощью setStyle()
, для компонента автоматически вызывается метод invalidateSize()
, что приводит к повторному вычислению его измеренного размера на более позднем этапе.
Параметры
styleName:String — Имя стиля, добавляемого в список.
|
setStyleDeclaration | () | метод |
public static 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 позволяет избежать немедленного обновления стилей в приложении.
Стили обновляются при следующем вызове одного из перечисленных ниже методов со свойством
Как правило, при многократном вызове одного из этих методов значение При вызове метода |
unloadStyleDeclarations | () | метод |
public static 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
NOT_A_COLOR | Константа |
public static const NOT_A_COLOR:uint = 0xFFFFFFFF
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Метод getColorName()
возвращает это значение, если передаваемая строка не является допустимым именем цвета.
Tue Jun 12 2018, 11:34 AM Z