You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by ah...@apache.org on 2016/02/13 01:14:22 UTC
[15/37] git commit: [flex-asjs] [refs/heads/spark] - copy of many
flex-sdk classes,
modified to try to compile on top of the FlexJS base classes. A COMPILE::LATER
flag is used to comment out features like multi-swf support and a few other
features that
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/1f6418c4/frameworks/projects/MX/src/main/flex/mx/styles/StyleManager.as
----------------------------------------------------------------------
diff --git a/frameworks/projects/MX/src/main/flex/mx/styles/StyleManager.as b/frameworks/projects/MX/src/main/flex/mx/styles/StyleManager.as
new file mode 100644
index 0000000..7f1ac1c
--- /dev/null
+++ b/frameworks/projects/MX/src/main/flex/mx/styles/StyleManager.as
@@ -0,0 +1,834 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+package mx.styles
+{
+
+import org.apache.flex.events.IEventDispatcher;
+COMPILE::LATER
+{
+ import flash.system.ApplicationDomain;
+ import flash.system.SecurityDomain;
+ import flash.utils.Dictionary;
+}
+
+import mx.core.FlexVersion;
+import mx.core.IFlexModuleFactory;
+import mx.core.Singleton;
+import mx.core.mx_internal;
+import mx.managers.SystemManagerGlobals;
+
+/**
+ * The StyleManager class manages the following:
+ * <ul>
+ * <li>Which CSS style properties the class inherits</li>
+ * <li>Which style properties are colors, and therefore get special handling</li>
+ * <li>A list of strings that are aliases for color values</li>
+ * </ul>
+ *
+ * @see mx.styles.CSSStyleDeclaration
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+public class StyleManager
+{
+ include "../core/Version.as";
+
+ //--------------------------------------------------------------------------
+ //
+ // Class constants
+ //
+ //--------------------------------------------------------------------------
+
+ /**
+ * The <code>getColorName()</code> method returns this value if the passed-in
+ * String is not a legitimate color name.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ public static const NOT_A_COLOR:uint = 0xFFFFFFFF;
+
+ //--------------------------------------------------------------------------
+ //
+ // Class variables
+ //
+ //--------------------------------------------------------------------------
+
+ /**
+ * @private
+ * Linker dependency on implementation class.
+ */
+ private static var implClassDependency:StyleManagerImpl;
+
+ /**
+ * @private
+ * Storage for the impl getter.
+ * This gets initialized on first access,
+ * not at static initialization time, in order to ensure
+ * that the Singleton registry has already been initialized.
+ */
+ private static var _impl:IStyleManager2;
+
+ /**
+ * @private
+ * The singleton instance of StyleManagerImpl which was
+ * registered as implementing the IStyleManager2 interface.
+ */
+ private static function get impl():IStyleManager2
+ {
+ if (!_impl)
+ {
+ _impl = IStyleManager2(
+ Singleton.getInstance("mx.styles::IStyleManager2"));
+ }
+
+ return _impl;
+ }
+
+ //--------------------------------------------------------------------------
+ //
+ // Class methods
+ //
+ //--------------------------------------------------------------------------
+
+ /**
+ * @private
+ * Dictionary that maps a moduleFactory to its associated styleManager
+ */
+ COMPILE::LATER
+ private static var styleManagerDictionary:Dictionary;
+
+ /**
+ * Returns the style manager for an object.
+ *
+ * @param moduleFactory The module factory of an object you want the
+ * style manager for. If null, the top-level style manager is returned.
+ *
+ * @return the style manager for the given module factory.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 10
+ * @playerversion AIR 1.5
+ * @productversion Flex 4
+ */
+ public static function getStyleManager(moduleFactory:IFlexModuleFactory):IStyleManager2
+ {
+ COMPILE::LATER
+ {
+ if (!moduleFactory)
+ {
+ moduleFactory = SystemManagerGlobals.topLevelSystemManagers[0];
+ // trace("no style manager specified, using top-level style manager");
+ }
+
+ if (!styleManagerDictionary)
+ styleManagerDictionary = new Dictionary(true);
+
+ var styleManager:IStyleManager2;
+ var dictionary:Dictionary = styleManagerDictionary[moduleFactory];
+ if (dictionary == null)
+ {
+ styleManager = IStyleManager2(moduleFactory.getImplementation("mx.styles::IStyleManager2"));
+ if (styleManager == null)
+ {
+ // All Flex 4 swfs should have a style manager.
+ // In the transition to multiple style managers, use the top-level style manager.
+ // trace("no style manager found");
+ styleManager = impl;
+ }
+
+ dictionary = new Dictionary(true);
+ styleManagerDictionary[moduleFactory] = dictionary;
+ dictionary[styleManager] = 1;
+ }
+ else
+ {
+ for (var o:Object in dictionary)
+ {
+ styleManager = o as IStyleManager2;
+ break;
+ }
+ }
+
+ return styleManager;
+
+ }
+ return impl; // just for now
+ }
+
+ /**
+ * @private
+ * The root of all proto chains used for looking up styles.
+ * This object is initialized once by initProtoChainRoots() and
+ * then updated by calls to setStyle() on the global CSSStyleDeclaration.
+ * It is accessed by code that needs to construct proto chains,
+ * such as the initProtoChain() method of UIComponent.
+ */
+ [Deprecated(replacement="IStyleManager2.stylesRoot on a style manager instance",
+ since="4.0")]
+ mx_internal static function get stylesRoot():Object
+ {
+ return impl.stylesRoot;
+ }
+ mx_internal static function set stylesRoot(value:Object):void
+ {
+ impl.stylesRoot = value;
+ }
+
+ /**
+ * @private
+ * Set of inheriting non-color styles.
+ * This is not the complete set from CSS.
+ * Some of the omitted we don't support at all,
+ * others may be added later as needed.
+ * The method registerInheritingStyle() adds to this set
+ * and isInheritingStyle() queries this set.
+ */
+ [Deprecated(replacement="IStyleManager2.inheritingStyles on a style manager instance",
+ since="4.0")]
+ mx_internal static function get inheritingStyles():Object
+ {
+ return impl.inheritingStyles;
+ }
+ mx_internal static function set inheritingStyles(value:Object):void
+ {
+ impl.inheritingStyles = value;
+ }
+
+ /**
+ * @private
+ */
+ [Deprecated(replacement="IStyleManager2.typeHierarchyCache on a style manager instance",
+ since="4.0")]
+ mx_internal static function get typeHierarchyCache():Object
+ {
+ return impl.typeHierarchyCache;
+ }
+ mx_internal static function set typeHierarchyCache(value:Object):void
+ {
+ impl.typeHierarchyCache = value;
+ }
+
+ /**
+ * @private
+ */
+ [Deprecated(replacement="IStyleManager2.typeSelectorCache on a style manager instance",
+ since="4.0")]
+ mx_internal static function get typeSelectorCache():Object
+ {
+ return impl.typeSelectorCache;
+ }
+ mx_internal static function set typeSelectorCache(value:Object):void
+ {
+ impl.typeSelectorCache = value;
+ }
+
+ /**
+ * @private
+ * This method is called by code autogenerated by the MXML compiler,
+ * after StyleManager.styles is popuplated with CSSStyleDeclarations.
+ */
+ [Deprecated(replacement="IStyleManager2.initProtoChainRoots on a style manager instance",
+ since="4.0")]
+ mx_internal static function initProtoChainRoots():void
+ {
+ impl.initProtoChainRoots();
+ }
+
+ /**
+ * Returns an Array of all the CSS selectors that are registered with the StyleManager.
+ * You can pass items in this Array to the <code>getStyleDeclaration()</code> method to get the corresponding CSSStyleDeclaration object.
+ * Class selectors are prepended with a period.
+ *
+ * @return An Array of all of the selectors
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.selectors on a style manager instance",
+ since="4.0")]
+ public static function get selectors():Array
+ {
+ return impl.selectors;
+ }
+
+ /**
+ * Gets the CSSStyleDeclaration object that stores the rules
+ * for the specified CSS selector.
+ *
+ * <p>If the <code>selector</code> parameter starts with a period (.),
+ * the returned CSSStyleDeclaration is a class selector and applies only to those instances
+ * whose <code>styleName</code> property specifies that selector
+ * (not including the period).
+ * For example, the class selector <code>".bigMargins"</code>
+ * applies to any UIComponent whose <code>styleName</code>
+ * is <code>"bigMargins"</code>.</p>
+ *
+ * <p>If the <code>selector</code> parameter does not start with a period,
+ * the returned CSSStyleDeclaration is a type selector and applies to all instances
+ * of that type.
+ * For example, the type selector <code>"Button"</code>
+ * applies to all instances of Button and its subclasses.</p>
+ *
+ * <p>The <code>global</code> selector is similar to a type selector
+ * and does not start with a period.</p>
+ *
+ * @param selector The name of the CSS selector.
+ *
+ * @return The style declaration whose name matches the <code>selector</code> property.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.getStyleDeclaration on a style manager instance",
+ since="4.0")]
+ public static function getStyleDeclaration(
+ selector:String):CSSStyleDeclaration
+ {
+ return impl.getStyleDeclaration(selector);
+ }
+
+ /**
+ * Sets the CSSStyleDeclaration object that stores the rules
+ * for the specified CSS selector.
+ *
+ * <p>If the <code>selector</code> parameter starts with a period (.),
+ * the specified selector is a "class selector" and applies only to those instances
+ * whose <code>styleName</code> property specifies that selector
+ * (not including the period).
+ * For example, the class selector <code>".bigMargins"</code>
+ * applies to any UIComponent whose <code>styleName</code>
+ * is <code>"bigMargins"</code>.</p>
+ *
+ * <p>If the <code>selector</code> parameter does not start with a period,
+ * the specified selector is a "type selector" and applies to all instances
+ * of that type.
+ * For example, the type selector <code>"Button"</code>
+ * applies to all instances of Button and its subclasses.</p>
+ *
+ * <p>The <code>global</code> selector is similar to a type selector
+ * and does not start with a period.</p>
+ *
+ * @param selector The name of the CSS selector.
+ * @param styleDeclaration The new style declaration.
+ * @param update Set to <code>true</code> to force an immediate update of the styles; internally, Flex
+ * calls the <code>styleChanged()</code> method of UIComponent.
+ * Set to <code>false</code> to avoid an immediate update of the styles in the application.
+ *
+ * <p>The styles will be updated the next time one of the following methods is called with
+ * the <code>update</code> property set to <code>true</code>:
+ * <ul>
+ * <li><code>clearStyleDeclaration()</code></li>
+ * <li><code>loadStyleDeclarations()</code></li>
+ * <li><code>setStyleDeclaration()</code></li>
+ * <li><code>unloadStyleDeclarations()</code></li>
+ * </ul>
+ * </p>
+ *
+ * <p>Typically, if you call the one of these methods multiple times,
+ * you set this property to <code>true</code> only on the last call,
+ * so that Flex does not call the <code>styleChanged()</code> method multiple times.</p>
+ *
+ * <p>If you call the <code>getStyle()</code> method, Flex returns the style value
+ * that was last applied to the UIComponent through a call to the <code>styleChanged()</code> method.
+ * The component's appearance might not reflect the value returned by the <code>getStyle()</code> method. This occurs
+ * because one of these style declaration methods might not yet have been called with the
+ * <code>update</code> property set to <code>true</code>.</p>
+ *
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.setStyleDeclaration on a style manager instance",
+ since="4.0")]
+ public static function setStyleDeclaration(
+ selector:String,
+ styleDeclaration:CSSStyleDeclaration,
+ update:Boolean):void
+ {
+ impl.setStyleDeclaration(selector, styleDeclaration, update);
+ }
+
+ /**
+ * Clears the CSSStyleDeclaration object that stores the rules
+ * for the specified CSS selector.
+ *
+ * <p>If the specified selector is a class selector (for example, ".bigMargins" or ".myStyle"),
+ * you must be sure to start the
+ * <code>selector</code> property with a period (.).</p>
+ *
+ * <p>If the specified selector is a type selector (for example, "Button"), do not start the
+ * <code>selector</code> property with a period.</p>
+ *
+ * <p>The <code>global</code> selector is similar to a type selector
+ * and does not start with a period.</p>
+ *
+ * @param selector The name of the CSS selector to clear.
+ * @param update Set to <code>true</code> to force an immediate update of the styles.
+ * Set to <code>false</code> to avoid an immediate update of the styles in the application.
+ * For more information about this method, see the description in the <code>setStyleDeclaration()</code>
+ * method.
+ *
+ * @see #setStyleDeclaration()
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.clearStyleDeclaration on a style manager instance",
+ since="4.0")]
+ public static function clearStyleDeclaration(selector:String,
+ update:Boolean):void
+ {
+ impl.clearStyleDeclaration(selector, update);
+ }
+
+ /**
+ * @private
+ * After an entire selector is added, replaced, or removed,
+ * this method updates all the DisplayList trees.
+ */
+ [Deprecated(replacement="IStyleManager2.styleDeclarationsChanged on a style manager instance",
+ since="4.0")]
+ mx_internal static function styleDeclarationsChanged():void
+ {
+ impl.styleDeclarationsChanged();
+ }
+
+ /**
+ * Adds to the list of styles that can inherit values
+ * from their parents.
+ *
+ * <p><b>Note:</b> Ensure that you avoid using duplicate style names, as name
+ * collisions can result in decreased performance if a style that is
+ * already used becomes inheriting.</p>
+ *
+ * @param styleName The name of the style that is added to the list of styles that can inherit values.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.registerInheritingStyle on a style manager instance",
+ since="4.0")]
+ public static function registerInheritingStyle(styleName:String):void
+ {
+ impl.registerInheritingStyle(styleName);
+ }
+
+ /**
+ * Tests to see if a style is inheriting.
+ *
+ * @param styleName The name of the style that you test to see if it is inheriting.
+ *
+ * @return Returns <code>true</code> if the specified style is inheriting.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isInheritingStyle on a style manager instance",
+ since="4.0")]
+ public static function isInheritingStyle(styleName:String):Boolean
+ {
+ return impl.isInheritingStyle(styleName);
+ }
+
+ /**
+ * Test to see if a TextFormat style is inheriting.
+ *
+ * @param styleName The name of the style that you test to see if it is inheriting.
+ *
+ * @return Returns <code>true</code> if the specified TextFormat style
+ * is inheriting.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isInheritingTextFormatStyle on a style manager instance",
+ since="4.0")]
+ public static function isInheritingTextFormatStyle(styleName:String):Boolean
+ {
+ return impl.isInheritingTextFormatStyle(styleName);
+ }
+
+ /**
+ * Adds to the list of styles which may affect the measured size
+ * of the component.
+ * When one of these styles is set with <code>setStyle()</code>,
+ * the <code>invalidateSize()</code> method is automatically called on the component
+ * to make its measured size get recalculated later.
+ *
+ * @param styleName The name of the style that you add to the list.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.registerSizeInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function registerSizeInvalidatingStyle(styleName:String):void
+ {
+ impl.registerSizeInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Tests to see if a style changes the size of a component.
+ *
+ * <p>When one of these styles is set with the <code>setStyle()</code> method,
+ * the <code>invalidateSize()</code> method is automatically called on the component
+ * to make its measured size get recalculated later.</p>
+ *
+ * @param styleName The name of the style to test.
+ *
+ * @return Returns <code>true</code> if the specified style is one
+ * which may affect the measured size of the component.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isSizeInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function isSizeInvalidatingStyle(styleName:String):Boolean
+ {
+ return impl.isSizeInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Adds to the list of styles which may affect the measured size
+ * of the component's parent container.
+ * <p>When one of these styles is set with <code>setStyle()</code>,
+ * the <code>invalidateSize()</code> method is automatically called on the component's
+ * parent container to make its measured size get recalculated
+ * later.</p>
+ *
+ * @param styleName The name of the style to register.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.registerParentSizeInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function registerParentSizeInvalidatingStyle(styleName:String):void
+ {
+ impl.registerParentSizeInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Tests to see if the style changes the size of the component's parent container.
+ *
+ * <p>When one of these styles is set with <code>setStyle()</code>,
+ * the <code>invalidateSize()</code> method is automatically called on the component's
+ * parent container to make its measured size get recalculated
+ * later.</p>
+ *
+ * @param styleName The name of the style to test.
+ *
+ * @return Returns <code>true</code> if the specified style is one
+ * which may affect the measured size of the component's
+ * parent container.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isParentSizeInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function isParentSizeInvalidatingStyle(styleName:String):Boolean
+ {
+ return impl.isParentSizeInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Adds to the list of styles which may affect the appearance
+ * or layout of the component's parent container.
+ * When one of these styles is set with <code>setStyle()</code>,
+ * the <code>invalidateDisplayList()</code> method is auomatically called on the component's
+ * parent container to make it redraw and/or relayout its children.
+ *
+ * @param styleName The name of the style to register.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.registerParentDisplayListInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function registerParentDisplayListInvalidatingStyle(
+ styleName:String):void
+ {
+ impl.registerParentDisplayListInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Tests to see if this style affects the component's parent container in
+ * such a way as to require that the parent container redraws itself when this style changes.
+ *
+ * <p>When one of these styles is set with <code>setStyle()</code>,
+ * the <code>invalidateDisplayList()</code> method is auomatically called on the component's
+ * parent container to make it redraw and/or relayout its children.</p>
+ *
+ * @param styleName The name of the style to test.
+ *
+ * @return Returns <code>true</code> if the specified style is one
+ * which may affect the appearance or layout of the component's
+ * parent container.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isParentDisplayListInvalidatingStyle on a style manager instance",
+ since="4.0")]
+ public static function isParentDisplayListInvalidatingStyle(
+ styleName:String):Boolean
+ {
+ return impl.isParentDisplayListInvalidatingStyle(styleName);
+ }
+
+ /**
+ * Adds a color name to the list of aliases for colors.
+ *
+ * @param colorName The name of the color to add to the list; for example, "blue".
+ * If you later access this color name, the value is not case-sensitive.
+ *
+ * @param colorValue Color value, for example, 0x0000FF.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.registerColorName on a style manager instance",
+ since="4.0")]
+ public static function registerColorName(colorName:String, colorValue:uint):void
+ {
+ impl.registerColorName(colorName, colorValue);
+ }
+
+ /**
+ * Tests to see if the given String is an alias for a color value. For example,
+ * by default, the String "blue" is an alias for 0x0000FF.
+ *
+ * @param colorName The color name to test. This parameter is not case-sensitive.
+ *
+ * @return Returns <code>true</code> if <code>colorName</code> is an alias
+ * for a color.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isColorName on a style manager instance",
+ since="4.0")]
+ public static function isColorName(colorName:String):Boolean
+ {
+ return impl.isColorName(colorName);
+ }
+
+ /**
+ * Returns the numeric RGB color value that corresponds to the
+ * specified color string.
+ * The color string can be either a case-insensitive color name
+ * such as <code>"red"</code>, <code>"Blue"</code>, or
+ * <code>"haloGreen"</code>, a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
+ * such as <code>"#FF0000"</code>.
+ *
+ * <p>This method returns a uint, such as 4521830, that represents a color. You can convert
+ * this uint to a hexadecimal value by passing the numeric base (in this case, 16), to
+ * the uint class's <code>toString()</code> method, as the following example shows:</p>
+ * <pre>
+ * import mx.styles.StyleManager;
+ * private function getNewColorName():void {
+ * StyleManager.registerColorName("soylentGreen",0x44FF66);
+ * trace(StyleManager.getColorName("soylentGreen").toString(16));
+ * }
+ * </pre>
+ *
+ * @param colorName The color name.
+ *
+ * @return Returns a uint that represents the color value or <code>NOT_A_COLOR</code>
+ * if the value of the <code>colorName</code> property is not an alias for a color.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.getColorName on a style manager instance",
+ since="4.0")]
+ public static function getColorName(colorName:Object):uint
+ {
+ return impl.getColorName(colorName);
+ }
+
+ /**
+ * Converts each element of the colors Array from a color name
+ * to a numeric RGB color value.
+ * Each color String can be either a case-insensitive color name
+ * such as <code>"red"</code>, <code>"Blue"</code>, or
+ * <code>"haloGreen"</code>, a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
+ * such as <code>"#FF0000"</code>..
+ *
+ * @param colors An Array of color names.
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.getColorNames on a style manager instance",
+ since="4.0")]
+ public static function getColorNames(colors:Array /* of Number or String */):void
+ {
+ impl.getColorNames(colors);
+ }
+
+ /**
+ * Determines if a specified parameter is a valid style property. For example:
+ *
+ * <pre>
+ * trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());
+ * </pre>
+ *
+ * <p>This can be useful because some styles can be set to values
+ * such as 0, <code>NaN</code>,
+ * the empty String (<code>""</code>), or <code>null</code>, which can
+ * cause an <code>if (value)</code> test to fail.</p>
+ *
+ * @param value The style property to test.
+ *
+ * @return If you pass the value returned by a <code>getStyle()</code> method call
+ * to this method, it returns <code>true</code> if the style
+ * was set and <code>false</code> if it was not set.
+ *
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.isValidStyleValue on a style manager instance",
+ since="4.0")]
+ public static function isValidStyleValue(value:*):Boolean
+ {
+ return impl.isValidStyleValue(value);
+ }
+
+ /**
+ * Loads a style SWF.
+ *
+ * @param url Location of the style SWF.
+ *
+ * @param update Set to <code>true</code> to force
+ * an immediate update of the styles.
+ * Set to <code>false</code> to avoid an immediate update
+ * of the styles in the application.
+ * This parameter is optional and defaults to <code>true</code>
+ * For more information about this parameter, see the description
+ * in the <code>setStyleDeclaration()</code> method.
+ *
+ * @param trustContent Obsolete, no longer used.
+ * This parameter is optional and defaults to <code>false</code>.
+ *
+ * @param applicationDomain The ApplicationDomain passed to the
+ * <code>load()</code> method of the IModuleInfo that loads the style SWF.
+ * This parameter is optional and defaults to <code>null</code>.
+ *
+ * @param securityDomain The SecurityDomain passed to the
+ * <code>load()</code> method of the IModuleInfo that loads the style SWF.
+ * This parameter is optional and defaults to <code>null</code>.
+ *
+ * @return An IEventDispatcher implementation that supports
+ * StyleEvent.PROGRESS, StyleEvent.COMPLETE, and
+ * StyleEvent.ERROR.
+ *
+ * @see #setStyleDeclaration()
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.loadStyleDeclarations on a style manager instance",
+ since="4.0")]
+ COMPILE::LATER
+ public static function loadStyleDeclarations(
+ url:String, update:Boolean = true,
+ trustContent:Boolean = false,
+ applicationDomain:ApplicationDomain = null,
+ securityDomain:SecurityDomain = null):IEventDispatcher
+ {
+ return impl.loadStyleDeclarations2(url, update,
+ applicationDomain, securityDomain);
+ }
+
+ /**
+ * Unloads a style SWF.
+ *
+ * @param url Location of the style SWF.
+ * @param update Set to <code>true</code> to force an immediate update of the styles.
+ * Set to <code>false</code> to avoid an immediate update of the styles in the application.
+ * For more information about this method, see the description in the <code>setStyleDeclaration()</code>
+ * method.
+ *
+ * @see #setStyleDeclaration()
+ *
+ * @langversion 3.0
+ * @playerversion Flash 9
+ * @playerversion AIR 1.1
+ * @productversion Flex 3
+ */
+ [Deprecated(replacement="IStyleManager2.unloadStyleDeclarations on a style manager instance",
+ since="4.0")]
+ COMPILE::LATER
+ public static function unloadStyleDeclarations(
+ url:String, update:Boolean = true):void
+ {
+ impl.unloadStyleDeclarations(url, update);
+ }
+}
+
+}