flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From aha...@apache.org
Subject [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
Date Sat, 13 Feb 2016 00:14:22 GMT
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);
+    }
+}
+
+}


Mime
View raw message