incubator-flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cframp...@apache.org
Subject svn commit: r1351437 [5/12] - in /incubator/flex/trunk/frameworks/projects: automation_agent/ automation_agent/bundles/ automation_agent/bundles/da_DK/ automation_agent/bundles/de_DE/ automation_agent/bundles/en_US/ automation_agent/bundles/es_ES/ auto...
Date Mon, 18 Jun 2012 18:10:25 GMT
Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationManager.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationManager.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,225 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.events.Event;
+import flash.system.ApplicationDomain;
+import flash.utils.describeType;
+import mx.automation.Automation;
+import mx.automation.AutomationClass;
+import mx.automation.IAutomationManager;
+import mx.automation.IAutomationMethodDescriptor;
+import mx.automation.IAutomationObject;
+import mx.core.mx_internal;
+
+use namespace mx_internal;
+
+/**
+ * Basic method descriptor class. Generates descriptor from event parameters, if necessary
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public class AutomationMethodDescriptor
+	   implements IAutomationMethodDescriptor
+{
+	//--------------------------------------------------------------------------
+	//
+	//  Constructor
+	//
+	//--------------------------------------------------------------------------
+
+    /**
+     * 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function AutomationMethodDescriptor(name:String,
+                                                      asMethodName:String,
+                                                      returnType:String,
+                                                      args:Array)
+    {
+        super();
+
+        _name = name;
+        _asMethodName = asMethodName;
+        _returnType = returnType;
+        _args = args;
+    }
+
+	//--------------------------------------------------------------------------
+	//
+	//  Variables
+	//
+	//--------------------------------------------------------------------------
+
+    /**
+     *  @private
+     */
+    private var _asMethodName:String;
+    
+    /**
+     *  @private
+     */
+	private var _args:Array;
+    
+    /**
+     *  @private
+     */
+	private var _eventArgASTypesInitialized:Boolean = false;
+
+	//--------------------------------------------------------------------------
+	//
+	//  Properties
+	//
+	//--------------------------------------------------------------------------
+
+	//----------------------------------
+	//  name
+	//----------------------------------
+
+    /**
+     *  @private
+     */
+    private var _name:String;
+
+    /**
+     *  @inheritDoc
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function get name():String
+    {
+        return _name;
+    }
+
+	//----------------------------------
+	//  returnType
+	//----------------------------------
+
+    /**
+     *  @private
+     */
+    private var _returnType:String;
+
+    /**
+     *
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function get returnType():String
+    {
+        return _returnType;
+    }
+
+	//--------------------------------------------------------------------------
+	//
+	//  Methods
+	//
+	//--------------------------------------------------------------------------
+
+    /**
+     *  @inheritDoc
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function record(target:IAutomationObject, event:Event):Array
+    {
+        // Unsupported to record a method.
+        throw new Error();
+        return null;
+    }
+
+    /**
+     *  @inheritDoc
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function replay(target:IAutomationObject, args:Array):Object
+    {
+        var retVal:Object;
+        var f:Function 
+
+    	var comp:Object = target ;
+        if (comp.hasOwnProperty(_asMethodName))
+        {
+        	f = comp[_asMethodName];
+        	retVal = f.apply(target, args);
+        }
+        else
+        {
+            var delegate:Object = target.automationDelegate;
+            f = delegate[_asMethodName];
+        	retVal = f.apply(target, args);
+        }
+        	
+		return retVal;
+    }
+
+    /**
+     *  @inheritDoc
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+   public function getArgDescriptors(obj:IAutomationObject):Array
+    {
+        if (!_eventArgASTypesInitialized && obj != null)
+        {
+            // This could be optimized by getting this info when
+            // the properties for the object are initialized since
+            // it's the same DT object.
+            _eventArgASTypesInitialized = true;
+            var comp:Object = obj ;
+            // if the property not found in the object, get the delegate
+            if (!(comp.hasOwnProperty(_asMethodName)))
+            {
+               comp = obj.automationDelegate;    
+            }
+        	
+            var dt:XML = describeType(comp);
+            AutomationClass.fillInASTypesFromMethods(dt, _asMethodName, _args);
+        }
+
+        return _args;
+    }
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationMethodDescriptor.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,109 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+/**
+ * Describes a property of a test object.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public class AutomationPropertyDescriptor implements IAutomationPropertyDescriptor
+{
+
+    private var _name:String;
+    private var _forDescription:Boolean;
+    private var _forVerification:Boolean;
+    private var _defaultValue:String;
+    private var _asType:String;
+
+    /**
+     *  Constructor
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    public function AutomationPropertyDescriptor(name:String,
+                                                 forDescription:Boolean,
+                                                 forVerification:Boolean,
+                                                 defaultValue:String = null)
+    {
+        super();
+        _name = name;
+        _forDescription = forDescription;
+        _forVerification = forVerification;
+        _defaultValue = defaultValue;
+    }
+
+	/**
+	 * @private
+	 */
+    public function get name():String
+    {
+        return _name;
+    }
+    
+	/**
+	 * @private
+	 */
+    public function get forDescription():Boolean
+    {
+        return _forDescription;
+    }
+
+	/**
+	 * @private
+	 */
+    public function get forVerification():Boolean
+    {
+        return _forVerification;
+    }
+
+	/**
+	 * @private
+	 */
+    public function get defaultValue():String
+    {
+        return _defaultValue;
+    }
+    
+	/**
+	 * @private
+	 */
+    public function set asType(v:String):void
+    {
+    	_asType = v;
+    }
+
+	/**
+	 * @private
+	 */
+    public function get asType():String
+    {
+    	return _asType ;
+    }
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/AutomationPropertyDescriptor.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,151 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.events.Event;
+
+/**
+ * The IAutomationClass interface defines the interface for a component class descriptor.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationClass
+{
+
+    //----------------------------------
+    //  name
+    //----------------------------------
+    /**
+     * The class name.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get name():String;
+
+    //----------------------------------
+    //  superClassName
+    //----------------------------------
+
+    /**
+     * The name of the class's superclass.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get superClassName():String;
+ 
+    /**
+     * Returns the list of properties this class supports.
+     *
+     *  @param objForInitialization Object which can be used to find the 
+     *  ActionScript type of the properties.
+     *
+     *  @param forVerification If <code>true</code>, indicates that properties used 
+     *  for verification should be included in the return value. 
+     *
+     *  @param forDescription If <code>true</code>, indicates that properties used 
+     *  for object identitication should be included in the return value. 
+     *
+     *  @return Array containing property descriptions.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getPropertyDescriptors(objForInitialization:Object = null,
+                                           forVerification:Boolean = true,
+                                           forDescription:Boolean = true):Array;
+    
+    /**
+     *  Returns an <code>IAutomationEventDescriptor</code> object 
+     *  for the specified event object.
+     *
+     * @param event The event for which the descriptor is required.
+     * 
+     * @param The event descriptor for the event passed if one is available.
+     * Otherwise null.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getDescriptorForEvent(
+                        event:Event):IAutomationEventDescriptor;
+
+     /**
+      *  Returns an <code>IAutomationMethodDescriptorfrom</code> object
+      *  from the method's name.
+      *
+      *  @param methodName The method name for which the descriptor is required.
+      *
+      *  @return The method descriptor for the name passed if one is available. 
+      *          Otherwise, null.
+      *  
+      *  @langversion 3.0
+      *  @playerversion Flash 9
+      *  @playerversion AIR 1.1
+      *  @productversion Flex 3
+      */
+    function getDescriptorForMethodByName(
+                        methodName:String):IAutomationMethodDescriptor;
+
+     /**
+      *  Returns an <code>IAutomationEventDescriptor</code> object from the event's name.
+      *
+      *  @param eventName The event name for which the descriptor is required.
+      *
+      *  @return The event descriptor for the name passed if one is available. 
+      *          Otherwise null.
+      *  
+      *  @langversion 3.0
+      *  @playerversion Flash 9
+      *  @playerversion AIR 1.1
+      *  @productversion Flex 3
+      */
+    function getDescriptorForEventByName(
+                        eventName:String):IAutomationEventDescriptor;
+
+    /**
+     * An Object containing a map to map a property name to descriptor.
+     * The following example uses this property:
+     *
+     * <pre>var descriptor:IAutomationPropertyDescriptor = map[propertyNameMap];</pre> 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get propertyNameMap():Object;
+
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,61 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+
+/**
+ * The IAutomationClass2 interface defines the interface for a component class descriptor.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 4
+ */
+public interface IAutomationClass2 extends IAutomationClass
+{
+	//----------------------------------
+    //  previousVersionClassNames
+    //----------------------------------
+    /**
+     * An array of names of the classes that are compatible with current class.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get previousVersionClassNames():Array;
+    
+    //----------------------------------
+    //  implementationVersion
+    //----------------------------------
+    /**
+     * Version of the implementation classes. This version is supposed to be 
+     * unique for all implementation classes of a single ClassInfo tag in XML 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get implementationVersion():int;
+}
+}
\ No newline at end of file

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationClass2.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,45 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+	/**
+	 *  The IAutomationDebugTracer interface provides centralized methods
+	 *  that needs to be implemented in order to show detailed trace messages
+	 *  while debugging
+ 	 *  
+ 	 *  @langversion 3.0
+ 	 *  @playerversion Flash 9
+ 	 *  @playerversion AIR 1.1
+ 	 *  @productversion Flex 4
+	 * 
+	 */
+	
+	public interface IAutomationDebugTracer
+	{
+		/**
+		 * Traces the message
+		 * 
+		 * @param className Name of class from which the message is traced
+		 * @param methodName Name of class from which the message is traced
+		 * @param message Message to be traced
+		 */
+		function traceMessage(className:String, methodName:String, message:String):void;
+	}
+}
\ No newline at end of file

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationDebugTracer.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,68 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+/**
+ *  The IAutomationEnvironment interface provides information about the
+ *  objects and properties of automatable components needed for communicating
+ *  with agents.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationEnvironment
+{
+
+    /**
+     *  Returns the automation class corresponding to the given object.
+     *
+     *  @param obj  Instance of the delegate of a testable object.
+     * 
+     *  @return Automation class for <code>obj</code>.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getAutomationClassByInstance(obj:IAutomationObject):IAutomationClass;
+
+
+    /**
+     *  Returns the automation class for the given name.
+     *
+     *  @param Name A class name that corresponds to the value of 
+     *  the <code>AutomationClass.name</code> property.
+     * 
+     *  @return Automation class corresponding to the given name,
+     *  or <code>null</code> if none was found.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getAutomationClassByName(automationClass:String):IAutomationClass;
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEnvironment.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,122 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.events.Event;
+import mx.core.mx_internal;
+import mx.automation.events.AutomationReplayEvent;
+
+use namespace mx_internal;
+
+/**
+ *  The IAutomationEventDescriptor interface defines the interface 
+ *  for an event descriptor.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationEventDescriptor
+{
+    /**
+     *  The name of this event as the agent sees it.
+     *  The AutomationManager fills the <code>AutomationRecordEvent.name</code>
+     *  property with this name.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get name():String;
+     
+    /**
+     *  The name of the class implementing this event.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get eventClassName():String;
+     
+    /**
+     *  The value of the <code>type</code> property used for this event.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get eventType():String;
+
+    /**
+     *  Returns an Array of argument descriptors for this event.
+     *  
+     *  @param target Instance of the IAutomationObject that
+     *  supports this event.
+     *
+     *  @return Array of argument descriptors for this event.
+     *
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getArgDescriptors(target:IAutomationObject):Array;
+
+    /**
+     *  Encodes an automation event argument into an Array.
+     *
+     *  @param target Automation object on which to record the event.
+     *
+     *  @param event Automation event that is being recorded.
+     *
+     *  @return Array of property values of the event described by the PropertyDescriptors.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function record(target:IAutomationObject, event:Event):Array;
+
+    /**
+     *  Decodes an argument Array and replays the event.
+     *
+     *  @param target Automation object on which to replay the event.
+     * 
+     *  @param args Array of argument values to
+     *  be used to replay the event.
+     *
+     *  @return null
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function replay(target:IAutomationObject, args:Array):Object;
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationEventDescriptor.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,532 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.display.DisplayObject;
+import flash.events.Event;
+import flash.events.IEventDispatcher;
+
+import mx.automation.events.AutomationRecordEvent;
+import mx.automation.events.AutomationReplayEvent;
+
+/**
+ *  The IAutomationManager interface defines the interface expected 
+ *  from an AutomationManager object by the automation module.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationManager 
+        extends IEventDispatcher
+{
+    /**
+     *  Returns the next parent that is visible within the automation hierarchy.
+     *
+     *  @param obj Automation object.
+     *
+     *  @param parentToStopAt Parent of the given automation object.
+     *
+     *  @param ignoreShowInHierarchy Boolean that determines whether object is ignored 
+     *  within the automation hierarchy. The default value is <code>false</code>.    
+     *
+     *  @return Nearest parent of the object visible within the automation 
+     *          hierarchy.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getParent(obj:IAutomationObject, 
+                       parentToStopAt:IAutomationObject = null,
+                       ignoreShowInHierarchy:Boolean = false):IAutomationObject;
+        
+    /**
+     *  Returns all children of this object that are visible within the testing
+     *  hierarchy and meet the criteria in the automation part.  
+     *  If a child is not visible within the hierarchy, this method
+     *  returns the children of the invisible child.
+     *  
+     *  @param obj Object for which to get the children.
+     * 
+     *  @param part Criteria of which children to return.
+     * 
+     *  @param ignoreShowInHierarchy Boolean that determines whether object is ignored 
+     *  within the automation hierarchy. The default value is <code>false</code>.    
+     *
+     *  @return Array of children matching the criteria.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getChildrenFromIDPart(obj:IAutomationObject,
+                                   part:AutomationIDPart = null,
+                                   ignoreShowInHierarchy:Boolean = false):Array;
+
+    /**
+     *  Returns all children of this object that are visible within the testing
+     *  hierarchy. If a child is not visible within the hierarchy, 
+     *  returns the children of the invisible child.
+     *  
+     *  @param obj Object for which to get the children.
+     *
+     *  @param ignoreShowInHierarchy
+     * 
+     *  @param ignoreShowInHierarchy Boolean that determines whether object is ignored 
+     *  within the automation hierarchy. The default value is <code>false</code>.    
+     *
+     *  @return Array of children.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getChildren(obj:IAutomationObject,
+                         ignoreShowInHierarchy:Boolean = false):Array;
+    
+    /**
+     *  Returns the text to display as the description for the object.
+     *  
+     *  @param obj Automation object.
+     * 
+     *  @return Text description of the Automation object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getAutomationName(obj:IAutomationObject):String;
+
+    /**
+     *  Returns the text to display as the type of the object.
+     *
+     *  @param obj Automation object.
+     * 
+     *  @return Type of the object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getAutomationClassName(obj:IAutomationObject):String;
+
+    /**
+     *  Returns the values for a set of properties.
+     *
+     *  @param obj Object for which to get the properties.
+     * 
+     *  @param names Names of the properties to evaluate on the object.
+     * 
+     *  @param forVerification If <code>true</code>, only include verification properties.
+     * 
+     *  @param forDescription If <code>true</code>, only include description properties.
+     * 
+     *  @return Array of objects that contain each property value and descriptor.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getProperties(obj:IAutomationObject, 
+                           names:Array = null, 
+                           forVerification:Boolean = true, 
+                           forDescription:Boolean = true):Array;
+    
+    /**
+     * Returns the object implementing the IAutomationTabularData interface through which
+     * the tabular data can be obtained.
+     *
+     *  @param obj An IAutomationObject.
+     * 
+     *  @return An object implementing the IAutomationTabularData interface. 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getTabularData(obj:IAutomationObject):IAutomationTabularData;
+
+    /**
+     *  Indicates whether recording is taking place.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get recording():Boolean;
+
+    /**
+     *  Indicates whether replay is taking place.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get replaying():Boolean;
+
+    /**
+     *  Sets the automation manager to record mode.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function beginRecording():void;
+
+    /**
+     *  Takes the automation manager out of record mode.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function endRecording():void;
+
+    /**
+     *  Returns the automation object under the given coordinate.
+     *
+     *  @param x The x coordinate.
+     * 
+     *  @param y The y coordinate.
+     * 
+     *  @return Automation object at that point.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */    
+    function getElementFromPoint(x:int, y:int):IAutomationObject;
+
+    /**
+     *  The display rectangle enclosing the DisplayObject.
+     *
+     *  @param obj DisplayObject whose rectangle is desired.
+     *
+     *  @return An array of four integers: top, left, width and height.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getRectangle(obj:DisplayObject):Array;
+
+    /**
+     *  Returns <code>true</code> if an object and all of its parents are visible.
+     *  
+     *  @param obj DisplayObject.
+     *
+     *  @return <code>true</code> if an object and all of its parents are visible.
+     * 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function isVisible(obj:DisplayObject):Boolean;
+
+    /**
+     *  Resolves an id to an automation object.
+     *
+     *  @param rid Automation id of the automation object.
+     *
+     *  @param currentParent Current parent of the automation object.
+     * 
+     *  @return IAutomationObject which matches with the <code>rid</code>. 
+     *  If no object 
+     *  is found or multiple objects are found, this method throws an exception.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function resolveIDToSingleObject(rid:AutomationID, 
+                                     currentParent:IAutomationObject = null):IAutomationObject;
+
+    /**
+     *  Resolves an id to automation objects.
+     *  
+     *  @param rid Automation id of the automation object.
+     *
+     *  @param currentParent Current parent of the automation object.
+     * 
+     *  @return An Array containing all the objects matching the <code>rid</code>.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function resolveID(rid:AutomationID, 
+                       currentParent:IAutomationObject = null):Array;
+            
+    /**
+     *  Resolves an id part to an automation object within the parent.
+     *
+     *  @param parent Parent of the automation object.
+     *
+     *  @param part id part of the automation object.
+     *
+     *  @return IAutomationObject which matches with the <code>part</code>. 
+     *  If no object 
+     *  is found or multiple objects are found, throw an exception.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function resolveIDPartToSingleObject(parent:IAutomationObject,
+                                         part:AutomationIDPart):IAutomationObject;
+    
+    /**
+     *  Resolves an id part to an Array of automation objects.
+     * 
+     *  @param parent Parent of the automation object.
+     *
+     *  @param part id part of the automation object.
+     *
+     *  @return Array of automation objects which match <code>part</code>.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function resolveIDPart(parent:IAutomationObject,
+                           part:AutomationIDPart):Array;
+
+    /**
+     *  Returns an id for the given object that can be used 
+     *  with the <code>resolveID()</code> method.
+     *
+     *  @param obj Automation object.
+     *
+     *  @param relativeToParent Parent of the automation object.
+     *  
+     *  @return AutomationID object which represents the Automation object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function createID(obj:IAutomationObject, 
+                      relativeToParent:IAutomationObject = null):AutomationID;
+
+    /**
+     *  Returns an id part for the given object that can be used in the <code>resolveIDPart()</code> method.
+     * 
+     *  @param obj The automation object.
+     *
+     *  @param parent Parent of the automation object.
+     *  
+     *  @return AutomationIDPart object which represents the Automation object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function createIDPart(obj:IAutomationObject, 
+                          parent:IAutomationObject = null):AutomationIDPart;
+
+    /**
+     *  Indicates whether an automation object should be visible within
+     *  the hierarchy.
+     *
+     *  @param obj The automation object.
+     * 
+     *  @return <code>true</code> if the object should be shown within the
+     *  automation hierarchy.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function showInHierarchy(obj:IAutomationObject):Boolean;
+
+    /**
+     *  @private
+     */
+    function set automationEnvironment(env:Object):void;
+
+    /**
+     *  The automation environment for this automation manager.
+     *  The automation environment provides information about the
+     *  objects and properties of testable components needed for communicating
+     *  with agent tools.
+     *
+     *  <p>The value of this property must implement the IAutomationEnvironment interface.</p>
+     *
+     *  @see mx.automation.IAutomationEnvironment
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get automationEnvironment():Object;
+
+    /**
+     *  Increments the cache counter. The automation mechanism  
+     *  caches both an object's properties and its children. The cache
+     *  exists for both performance reasons, and so that an objects state
+     *  prior to a recording can be captured. Each call to the 
+     *  <code>incrementCacheCounter()</code> method
+     *  increments a counter and each call to the 
+     *  <code>decrementCacheCounter()</code> method 
+     *  decrements the cache counter. When the counter reaches zero the
+     *  cache is cleared. 
+     *
+     *  <p>It's important that testing tools only use the
+     *  cache when they are certain that the state of the Flex application
+     *  is frozen and the user cannot interact with it. For example,
+     *  when an automation event is recorded, a testing tool might need to make
+     *  several calls to  the <code>getChildren()</code> method or the
+     * <code>getProperties()</code> method to create a testing
+     *  script line. To do this, it would wrap all the calls up in 
+     *  start/stop cache calls.</p>
+     *
+     *  <p>Internally, the AutomationManager forcibly clears the cache
+     *  before an end-user interaction that might trigger an automation
+     *  event. It then increments the cache counter and decrements the
+     *  counter after the automation event is dispatched. Testing tools can
+     *  prevent the count from reaching zero by calling the <code>incrementCacheCounter()</code> 
+     *  method in their record handler.</p>
+     *
+     *  @return the current cache counter.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function incrementCacheCounter():int;
+
+    /**
+     *  Decrement the cache counter. The cache is cleared when
+     *  the count reaches zero.
+     *
+     *  @param clearNow If <code>true</code>, clear the cache regardless of the cache counter.
+     * 
+     *  @return Current cache counter.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function decrementCacheCounter(clearNow:Boolean = false):int;
+
+
+    /**
+     * Tests if the provided target needs to wait until a previous
+     * operation completes.
+     * 
+     * @param target Target to check for synchronization or
+     * <code>null</code> to synchronize on any running operations.
+     * 
+     * @return <code>true</code> if synchronization is complete, <code>false</code> otherwise.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function isSynchronized(target:IAutomationObject):Boolean;
+
+    /**
+     *  Records the event.
+     *
+     *  @param recorder The automation object on which the event is to be recorded.
+     *
+     *  @param event The actual event which needs to be recorded. 
+     *
+     *  @param cacheable Controls the caching of the event that is recorded. 
+     *  During a mouse-down, mouse-up sequence, the automation mechanism tries to record the most 
+     *  important or suitable event rather than all the events. 
+     *
+     *  For example, if you have a List control which has a button in its item renderer. 
+     *  When the user clicks on the button, the automation mechanism only records 
+     *  the <code>click</code> event for the button, but ignores the <code>select</code> event 
+     *  generated from the List control.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function recordAutomatableEvent(recorder:IAutomationObject, event:Event,
+                                    cacheable:Boolean = false):void;
+    
+    /**
+     *  Replays the specified event. A component author should call 
+     *  the <code>super.replayAutomatableEvent()</code> method 
+     *  in case default replay behavior has been defined in a superclass.
+     *
+     *  @param event Event to replay.
+     *
+     *  @return <code>true</code> if the replay was successful. 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function replayAutomatableEvent(event:AutomationReplayEvent):Boolean;
+    
+    
+     /**
+     *  Records the  custom event.
+     *
+     *  @param recordEvent -  The AutomationRecordEvent that specifies that it is a custom evnet; the type is customRecord.
+     *
+     *  For example, if you want to record a custom event without writing a delegate and providing the details
+     *  in an environment file, you can use this interface to record the custom event. You should listen to
+     *  the AutomationPlaybackEvent, handle the replay, and prevent the default on the AutomationPlaybackEvent.
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean;
+
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,367 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.display.DisplayObject;
+import flash.events.Event;
+import flash.geom.Point;
+
+/**
+ *  The IAutomationManager interface defines the interface expected 
+ *  from an AutomationManager object by the automation module.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 4
+ */
+public interface IAutomationManager2 
+        extends IAutomationManager
+{
+   
+    /**
+     *  The automation environment for this automation manager.
+     *  The automation environment provides information about the
+     *  objects and properties of testable components needed for communicating
+     *  with agent tools.
+     *
+     *  The value of this property must implement the IAutomationEnvironment interface.
+     *
+     *  @see mx.automation.IAutomationEnvironment
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function set automationEnvironmentString(env:String):void;
+	
+	/**
+	 *  Marshalling Support(for tool): The tool class which is responsible for handling 
+	 *  the automation environment.
+	 *  
+	 *  @param className Complete qualified class name of the class in the tool that handles automation.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function set automationEnvironmentHandlingClassName(className:String):void;
+	
+	/**
+	 *  Marshalling Support(for tool): Returns unique ID of the application considering 
+	 *  the hierarchy using the SWFLoader information and the application name.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getUniqueApplicationID():String;
+	
+	/**
+	 *  Marshalling Support(for tool): Returns name of the application from the part id.
+	 * 
+	 *  @param objectID AutomationIDPart from which the application name is obtained. 
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+   	function getApplicationNameFromAutomationIDPart(objectID:AutomationIDPart):String;
+   
+	/**
+	 *  Marshalling Support(for tool): Returns true if the passed object is a pop up.
+	 *  
+	 *  @param obj IAutomationObject
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function isObjectPopUp(obj:IAutomationObject):Boolean;
+    // passed objectlist contain the objects which has applicationName which obtained for 
+   	// identifying them uniquely in case of the marshalled application.
+   	// this method can be used to indetify the top application when there are multiple application
+   	// at the same point, get element from point.
+	/**
+	 *  Marshalling Support(for tool): Returns the index of top visible object among the passed array of objects.
+	 *  This can be used by tools to identify the topmost Application object when there are 
+	 *  multiple objects from different applications, which belong to different ApplicationDomain or
+	 *  different SecurityDomain, under the mouse. 
+	 * 
+	 *  @param objectList Array of objects
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+   	function getTopApplicationIndex(objectList:Array):int;
+    
+	/**
+	 *  Marshalling Support(for tool): Adds the passed EventDetails objects to the probable 
+	 *  parent applications in the current ApplicationDomain.
+	 *  AutomationManager identifies the parent applications in the current ApplicationDomain
+	 *  which are responsible to listen to the events from children and adds appropriate listeners
+	 *  obtained from the passed objects.
+	 * 
+	 *  @param eventDetailsArray Array of EventDetails objects.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+   	function addEventListenersToAllParentApplications(eventDetailsArray:Array):void;
+	
+	/**
+	 *  Marshalling Support(for tool): Adds the passed EventDetails objects to the probable 
+	 *  child applications in the current ApplicationDomain.
+	 *  AutomationManager identifies the child applications in the current ApplicationDomain
+	 *  as and when the application is loaded, and adds appropriate listeners
+	 *  obtained from the passed objects.
+	 * 
+	 *  @param eventDetailsArray Array of EventDetails objects.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+   	function addEventListenersToAllChildApplications(eventDetailsArray:Array):void;
+	
+	/**
+	 *  Marshalling Support(for tool): Dispatches event to parent applications.
+	 * 
+	 *  @param event Event to be dispatched.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+   	function dispatchToParent(event:Event):void;
+	
+	/**
+	 *  Marshalling Support(for tool): Dispatches event to all children.
+	 * 
+	 *  @param event Event to be dispatched.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function dispatchToAllChildren(event:Event):void;
+
+
+	// these methods are for delegates to communicate to automation Manager
+	/**
+	 *  Marshalling Support(for delegates): Stores the drag proxy to enable
+	 *  inter-application drag-drop.DragProxy created in one application should be 
+	 *  accessible by another application if required. 
+	 *  
+	 *  @param DragProxy object
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */	
+	function storeDragProxy(dragProxy:Object):void; // used by dragmanagerAutomationImpl
+	
+	/**
+	 *  Marshalling Support(for delegates):Returns the number of pop up children of the 
+	 *  top level application. All pop up objects created in an application are added as 
+	 *  pop up children to the top level application of its ApplicationDomain. 
+	 *  
+	 *  @return Number of pop up children
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getPopUpChildrenCount():Number;
+	
+	/**
+	 *  Marshalling Support(for delegates):Returns array of pop up objects of the top level application.
+	 *  All pop up objects created in an application are added as 
+	 *  pop up children to the top level application of its ApplicationDomain. 
+	 * 
+	 *  @return Array of pop up children
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getPopUpChildren():Array;
+  
+	/**
+	 *  Marshalling Support(for delegates):Returns array of pop up objects of the root application.
+	 *  All pop up objects created in an application are added as 
+	 *  pop up children to the top level application of its ApplicationDomain. 
+	 *  
+	 *  @param index at which the object is to be retrieved 
+	 * 
+	 *  @return IAutomationObject at the given index
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getPopUpChildObject(index:int):IAutomationObject;
+   	
+	/**
+	 *  Marshalling Support(for delegates): When a new application is added, application delegate
+	 *  registers itself so that appropriate listeners are added to that in order to support 
+	 *  Marshalling.
+	 * 
+	 *  @param DisplayObject Application object to be registered. 
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function registerNewApplication(application:DisplayObject):void
+   	
+	/**
+	 *  AIR Support(for delegates): When a new window is added, WindowedApplication delegate registers
+	 *  the new window object so that a unique id is created for that window.
+	 * 
+	 *  @param newWindow Window object to be registered. 
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function registerNewWindow(newWindow:DisplayObject):void
+   	
+	/**
+	 *  AIR Support(for delegates): When a FlexNativeMenu is added to a component, its delegate
+	 *  registers the new FlexNativeMenu object and creates a delegate.
+	 *  
+	 *  @param menu FlexNativeMenu object to be registered.
+	 * 
+	 *  @param sm SystemManager of the component in which FlexNativeMenu is added.  
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function registerNewFlexNativeMenu(menu:Object, sm:DisplayObject):void
+   	
+	/**
+	 *  AIR support(for tool): Returns the unique id of the window object.
+	 *  
+	 *  @param DisplayObject window whose id is to required.
+	 * 
+	 *  @return String 
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getAIRWindowUniqueID(newWindow:DisplayObject):String;
+   	
+	/**
+	 *  AIR support(for tool): Returns the window with the passed id.
+	 * 
+	 *  @param windowId id of the window
+	 *  
+	 *  @return Window with passed id.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getAIRWindow(windowId:String):DisplayObject;
+   	
+	/**
+	 *  AIR support(for tool): Returns the automation object under the given coordinate in a window.
+	 *
+	 *  @param x The x coordinate.
+	 * 
+	 *  @param y The y coordinate.
+	 *  
+	 *  @param windowId The window on which the object is to be identified.
+	 * 
+	 *  @return Automation object at that point.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getElementFromPoint2(x:int, y:int,windowId:String ):IAutomationObject;
+   	
+	/**
+	 *  AIR support(for tool): Returns the unique ID of window from the object ID.
+	 *  Object ID has application ID and window ID.
+	 * 
+	 *  @param objectID The object ID from which unique ID of the window is to be obtained.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getAIRWindowUniqueIDFromObjectIDString(objectId:String ):String;
+   	
+	/**
+	 *  AIR support(for tool): Returns the unique ID of window from the automation ID part.
+	 *  Automation ID part has application ID and window ID.
+	 * 
+	 *  @param objectIdPart The AutomationIDPart from which unique ID of the window is to be obtained.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getAIRWindowUniqueIDFromAutomationIDPart(objectIdPart:AutomationIDPart):String;
+   	
+	/**
+	 *  AIR support(for tool): Used by Flex application loaded from AIR application, 
+	 *  to get the start point of main AIR application in screen coordinates
+	 *  
+	 *  @param windowId
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 4
+	 */
+	function getStartPointInScreenCoordinates(windowId:String):Point;
+}   
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationManager2.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,111 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.events.Event;
+import mx.core.mx_internal;
+import mx.automation.events.AutomationReplayEvent;
+
+use namespace mx_internal;
+
+/**
+ *  The IAutomationMethodDescriptor interface defines the interface for a method descriptor.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationMethodDescriptor
+{
+    /**
+     *  The name of the method.
+     *
+     *  @return The method name.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get name():String;
+
+    /**
+     *  The return type of the method.
+     *
+     *  @return The return type. 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get returnType():String;
+
+    /**
+     *  Returns an Array of argument descriptors for this method.
+     *  
+     *  @param obj Instance of the IAutomationObject that
+     *         supports this method.
+     *
+     *  @return Array of argument descriptors for this method.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getArgDescriptors(obj:IAutomationObject):Array;
+
+    /**
+     *  Encodes an automation event arguments into an Array.
+     *  Not all method descriptors support recording.
+     *
+     *  @param event Automation event that is being recorded.
+     *
+     *  @return Array of argument descriptors.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function record(target:IAutomationObject, event:Event):Array;
+
+    /**
+     *  Decodes an argument array and invokes a method.
+     *
+     *  @param target Automation object to replay the method on.
+     * 
+     *  @param args Array of argument values and descriptors to
+     *         be used to invoke the method.
+     *
+     *  @return Whatever the method invoked returns.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function replay(target:IAutomationObject, args:Array):Object;
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMethodDescriptor.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,71 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+import flash.display.DisplayObject;
+
+/**
+ * The IAutomationMouseSimulator interface describes an object 
+ * that simulates mouse movement so that components
+ * capturing the mouse use the simulated versions of the mouse
+ * cursor instead of the live Flash Player version. Implementors of
+ * the IUIComponent interface should override the 
+ * <code>mouseX</code> and <code>mouseY</code> properties and
+ * call the active simulator's version if a simulator is present.
+ *
+ *  @see mx.core.IUIComponent
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationMouseSimulator
+{
+    /**
+     *  Called when a DisplayObject retrieves the <code>mouseX</code> property.
+     *
+     *  @param item DisplayObject that simulates mouse movement.
+     *
+     *  @return The x coordinate of the mouse position relative to item.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getMouseX(item:DisplayObject):Number;
+
+    /**
+     *  Called when a DisplayObject retrieves <code>mouseY</code> property.
+     *
+     *  @param item DisplayObject that simulates mouse movement.
+     *
+     *  @return The y coordinate of the mouse position relative to item.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getMouseY(item:DisplayObject):Number;
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationMouseSimulator.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as
URL: http://svn.apache.org/viewvc/incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as?rev=1351437&view=auto
==============================================================================
--- incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as (added)
+++ incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as Mon Jun 18 18:10:20 2012
@@ -0,0 +1,315 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  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.automation
+{
+
+import flash.events.Event;
+import flash.display.DisplayObject;
+import flash.display.DisplayObjectContainer;
+import flash.events.MouseEvent;
+
+/**
+ * The IAutomationObject interface defines the interface 
+ * for a delegate object that implements automation
+ * for a component.
+ *  
+ *  @langversion 3.0
+ *  @playerversion Flash 9
+ *  @playerversion AIR 1.1
+ *  @productversion Flex 3
+ */
+public interface IAutomationObject 
+{
+    //--------------------------------------------------------------------------
+    //
+    //  Properties
+    //
+    //--------------------------------------------------------------------------
+
+    //----------------------------------
+    //  automationDelegate
+    //----------------------------------
+
+    /**
+     *  The delegate object that is handling the automation-related functionality.
+     *  Automation sets this when it creates the delegate object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get automationDelegate():Object;
+
+    /**
+     *  @private
+     */
+    function set automationDelegate(delegate:Object):void;
+
+    //----------------------------------
+    //  automationName
+    //----------------------------------
+
+    /**
+     *  Name that can be used as an identifier for this object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get automationName():String;
+
+    /**
+     *  @private
+     */
+    function set automationName(name:String):void;
+
+    //----------------------------------
+    //  automationValue
+    //----------------------------------
+
+    /**
+     *  This value generally corresponds to the rendered appearance of the 
+     *  object and should be usable for correlating the identifier with
+     *  the object as it appears visually within the application.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get automationValue():Array;
+    
+    /**
+     *  The owner of this component for automation purposes.
+     * 
+     *  @see mx.core.IVisualElement#owner
+     * 
+     *  @return The owner of this component
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get automationOwner():DisplayObjectContainer;
+    
+    /**
+     *  The parent of this component for automation purposes.
+     * 
+     *  @see mx.core.IVisualElement#parent
+     * 
+     *  @return The parent of this component
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get automationParent():DisplayObjectContainer;
+    
+    /**
+     *  True if this component is enabled for automation, false
+     *  otherwise.
+     * 
+     *  @see mx.core.IUIComponent#enabled
+     * 
+     *  @return <code>true</code> if this component is enabled for automation,
+     *          <code>false</code> otherwise.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get automationEnabled():Boolean;
+    
+    /**
+     *  True if this component is visible for automation, false
+     *  otherwise.
+     * 
+     *  @see flash.display.DisplayObject#visible
+     * 
+     *  @return <code>true</code> if this component is visible for automation,
+     *          <code>false</code> otherwise.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 4
+     */
+    function get automationVisible():Boolean;
+ 
+    /**
+     *  Returns a set of properties that identify the child within 
+     *  this container.  These values should not change during the
+     *  lifespan of the application.
+     *  
+     *  @param child Child for which to provide the id.
+     * 
+     *  @return Sets of properties describing the child which can
+     *          later be used to resolve the component.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function createAutomationIDPart(child:IAutomationObject):Object;
+	
+	/**
+	 *  Returns a set of properties that identify the child within 
+	 *  this container.  These values should not change during the
+	 *  lifespan of the application.
+	 *  
+	 *  @param child Child for which to provide the id.
+	 * 
+	 *  @return Sets of properties describing the child which can
+	 *          later be used to resolve the component.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 3
+	 */
+	function createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object;
+	
+
+    /**
+     *  Resolves a child by using the id provided. The id is a set 
+     *  of properties as provided by the <code>createAutomationIDPart()</code> method.
+     *
+     *  @param criteria Set of properties describing the child.
+     *         The criteria can contain regular expression values
+     *         resulting in multiple children being matched.
+     *  @return Array of children that matched the criteria
+     *          or <code>null</code> if no children could not be resolved.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function resolveAutomationIDPart(criteria:Object):Array;
+
+	/** 
+	 *  Provides the automation object list .  This list
+	 *  does not include any children that are composites.
+	 *
+		 * 
+	 *  @return The children .
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 9
+	 *  @playerversion AIR 1.1
+	 *  @productversion Flex 3
+	 */
+	function getAutomationChildren():Array;
+	
+    /** 
+     *  Provides the automation object at the specified index.  This list
+     *  should not include any children that are composites.
+     *
+     *  @param index The index of the child to return
+     * 
+     *  @return The child at the specified index.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function getAutomationChildAt(index:int):IAutomationObject;
+
+    /**
+     *  The number of automation children this container has.
+     *  This sum should not include any composite children, though
+     *  it does include those children not significant within the
+     *  automation hierarchy.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get numAutomationChildren():int;
+
+    /** 
+     *  A flag that determines if an automation object
+     *  shows in the automation hierarchy.
+     *  Children of containers that are not visible in the hierarchy
+     *  appear as children of the next highest visible parent.
+     *  Typically containers used for layout, such as boxes and Canvas,
+     *  do not appear in the hierarchy.
+     *
+     *  <p>Some controls force their children to appear
+     *  in the hierarchy when appropriate.
+     *  For example a List will always force item renderers,
+     *  including boxes, to appear in the hierarchy.
+     *  Implementers must support setting this property
+     *  to <code>true</code>.</p>
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get showInAutomationHierarchy():Boolean;
+
+    /**
+     *  @private
+     */
+    function set showInAutomationHierarchy(value:Boolean):void;
+   
+    /**
+     * An implementation of the <code>IAutomationTabularData</code> interface, which 
+     * can be used to retrieve the data.
+     * 
+     * @return An implementation of the <code>IAutomationTabularData</code> interface.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function get automationTabularData():Object;
+
+    /**
+     *  Replays the specified event.  A component author should probably call 
+     *  super.replayAutomatableEvent in case default replay behavior has been defined 
+     *  in a superclass.
+     *
+     *  @param event The event to replay.
+     *
+     *  @return <code>true</code> if a replay was successful.  
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 9
+     *  @playerversion AIR 1.1
+     *  @productversion Flex 3
+     */
+    function replayAutomatableEvent(event:Event):Boolean;
+	
+	
+	
+}
+
+}

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/flex/trunk/frameworks/projects/automation_agent/src/mx/automation/IAutomationObject.as
------------------------------------------------------------------------------
    svn:mime-type = text/plain



Mime
View raw message