http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/ContainerGlobals.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/ContainerGlobals.as index 5c76b97,0000000..56833ba mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/ContainerGlobals.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/ContainerGlobals.as @@@ -1,114 -1,0 +1,114 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.display.InteractiveObject; +} +COMPILE::JS +{ + import flex.display.InteractiveObject; +} +import mx.managers.IFocusManager; +import mx.managers.IFocusManagerContainer; + +/** +* @private +*/ +public class ContainerGlobals +{ + /** + * @private + * Internal variable that keeps track of the container + * that currently has focus. + */ + public static var focusedContainer:InteractiveObject; + + /** + * @private + * Support for defaultButton. + */ + public static function checkFocus(oldObj:InteractiveObject, + newObj:InteractiveObject):void + { + var objParent:InteractiveObject = newObj; + var currObj:InteractiveObject = newObj; + var lastUIComp:IUIComponent = null; + + if (newObj != null && oldObj == newObj) + return; + + // Find the Container parent with a defaultButton defined. + while (currObj) + { + if (currObj.parent) + { + objParent = currObj.parent; + } + else + { + objParent = null; + } + + if (currObj is IUIComponent) + lastUIComp = IUIComponent(currObj); + + currObj = objParent; + + if (currObj && + currObj is IFocusManagerContainer && IFocusManagerContainer(currObj).defaultButton) + { + break; + } + } + + if (ContainerGlobals.focusedContainer != currObj || + (ContainerGlobals.focusedContainer == null && currObj == null)) + { + if (!currObj) + currObj = InteractiveObject(lastUIComp); + + if (currObj && currObj is IFocusManagerContainer) + { + var fm:IFocusManager = IFocusManagerContainer(currObj).focusManager; + if (!fm) + return; + var defButton:IButton = IFocusManagerContainer(currObj).defaultButton as IButton; + if (defButton) + { + ContainerGlobals.focusedContainer = InteractiveObject(currObj); + fm.defaultButton = defButton as IButton; + } + else + { + ContainerGlobals.focusedContainer = InteractiveObject(currObj); + fm.defaultButton = null; + } + } + } + } + + +} + +} +
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/ContainerRawChildrenList.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/ContainerRawChildrenList.as index 299eb35,0000000..32f923f mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/ContainerRawChildrenList.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/ContainerRawChildrenList.as @@@ -1,235 -1,0 +1,235 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + - COMPILE::AS3 ++COMPILE::SWF +{ +import flash.display.DisplayObject; +import flash.geom.Point; +} +COMPILE::JS +{ +import flex.display.DisplayObject; +import org.apache.flex.geom.Point; +} +use namespace mx_internal; + +[ExcludeClass] + +/** + * @private + * Helper class for the rawChildren property of the Container class. + * For descriptions of the properties and methods, + * see the IChildList interface. + * + * @see mx.core.Container + */ +public class ContainerRawChildrenList implements IChildList +{ + include "../core/Version.as"; + + //-------------------------------------------------------------------------- + // + // Notes + // + //-------------------------------------------------------------------------- + + /* + + Although at the level of a Flash DisplayObjectContainer, all + children are equal, in a Flex Container some children are "more + equal than others". (George Orwell, "Animal Farm") + + In particular, Flex distinguishes between content children and + non-content (or "chrome") children. Content children are the kind + that can be specified in MXML. If you put several controls + into a VBox, those are its content children. Non-content children + are the other ones that you get automatically, such as a + background/border, scrollbars, the titlebar of a Panel, + AccordionHeaders, etc. + + Most application developers are uninterested in non-content children, + so Container overrides APIs such as numChildren and getChildAt() + to deal only with content children. For example, Container, keeps + its own _numChildren counter. + + However, developers of custom containers need to be able to deal + with both content and non-content children, so they require similar + APIs that operate on all children. + + For the public API, it would be ugly to have double APIs on Container + such as getChildAt() and all_getChildAt(). Instead, Container has + a public rawChildren property which lets you access APIs which + operate on all the children, in the same way that the + DisplayObjectContainer APIs do. For example, getChildAt(0) returns + the first content child, while rawChildren.getChildAt(0) returns + the first child (either content or non-content). + + This ContainerRawChildrenList class implements the rawChildren + property. Note that it simply calls a second set of parallel + mx_internal APIs in Container. (They're named, for example, + _getChildAt() instead of all_getChildAt()). + + Many of the all-children APIs in Container such as _getChildAt() + simply call super.getChildAt() in order to get the implementation + in DisplayObjectContainer. It would be nice if we could eliminate + _getChildAt() in Container and simply implement the all-children + version in this class by calling the DisplayObjectContainer method. + But once Container overrides getChildAt(), there is no way + to call the supermethod through an instance. + + */ + + //-------------------------------------------------------------------------- + // + // Constructor + // + //-------------------------------------------------------------------------- + + /** + * @private + * Constructor. + */ + public function ContainerRawChildrenList(owner:Container) + { + super(); + + this.owner = owner; + } + + //-------------------------------------------------------------------------- + // + // Variables + // + //-------------------------------------------------------------------------- + + /** + * @private + */ + private var owner:Container; + + //-------------------------------------------------------------------------- + // + // Properties + // + //-------------------------------------------------------------------------- + + //---------------------------------- + // numChildren + //---------------------------------- + + /** + * @private + */ + public function get numChildren():int + { + return owner.$numChildren; + } + + //-------------------------------------------------------------------------- + // + // Methods + // + //-------------------------------------------------------------------------- + + /** + * @private + */ + public function addChild(child:DisplayObject):DisplayObject + { + return owner.rawChildren_addChild(child); + } + + /** + * @private + */ + public function addChildAt(child:DisplayObject, index:int):DisplayObject + { + return owner.rawChildren_addChildAt(child, index); + } + + /** + * @private + */ + public function removeChild(child:DisplayObject):DisplayObject + { + return owner.rawChildren_removeChild(child); + } + + /** + * @private + */ + public function removeChildAt(index:int):DisplayObject + { + return owner.rawChildren_removeChildAt(index); + } + + /** + * @private + */ + public function getChildAt(index:int):DisplayObject + { + return owner.rawChildren_getChildAt(index); + } + + /** + * @private + */ + public function getChildByName(name:String):DisplayObject + { + return owner.rawChildren_getChildByName(name); + } + + /** + * @private + */ + public function getChildIndex(child:DisplayObject):int + { + return owner.rawChildren_getChildIndex(child); + } + + /** + * @private + */ + public function setChildIndex(child:DisplayObject, newIndex:int):void + { + owner.rawChildren_setChildIndex(child, newIndex); + } + + /** + * @private + */ + COMPILE::LATER + public function getObjectsUnderPoint(point:Point):Array + { + return owner.rawChildren_getObjectsUnderPoint(point); + } + + /** + * @private + */ + public function contains(child:DisplayObject):Boolean + { + return owner.rawChildren_contains(child); + } +} + +} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/DPIClassification.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/DPIClassification.as index acd4a2d,0000000..c6e3c56 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/DPIClassification.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/DPIClassification.as @@@ -1,98 -1,0 +1,98 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +/** + * An enum of the device screen density classess. + * + * When working with DPI, Flex collapses similar DPI values into DPI classes. + * + * @see spark.components.Application#applicationDPI + * @see spark.components.Application#runtimeDPI + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion Flex 4.5 + */ +public final class DPIClassification +{ + /** + * Density value for extra-low-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion ApacheFlex 4.11 + */ + public static const DPI_120:Number = 120; + + /** + * Density value for low-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion Flex 4.5 + */ + public static const DPI_160:Number = 160; + + /** + * Density value for medium-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion Flex 4.5 + */ + public static const DPI_240:Number = 240; + + /** + * Density value for high-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion Flex 4.5 + */ + public static const DPI_320:Number = 320; + + /** + * Density value for extra-high-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion ApacheFlex 4.10 + */ + public static const DPI_480:Number = 480; + + /** + * Density value for extra-extra-high-density devices. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 2.5 + * @productversion ApacheFlex 4.11 + */ + public static const DPI_640:Number = 640; +} - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IChildList.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IChildList.as index 680fb31,0000000..7556e92 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IChildList.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IChildList.as @@@ -1,314 -1,0 +1,314 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.display.DisplayObject; + import flash.geom.Point; +} +COMPILE::JS +{ + import flex.display.DisplayObject; + import org.apache.flex.geom.Point; +} + +/** + * The IChildList interface defines the properties and methods + * for accessing and manipulating child lists, which are subsets + * of a DisplayObjectContainer's children. + * + * <p>As an example, consider the Container class. + * It overrides DisplayObjectContainer APIs such as the + * <code>numChildren</code> and <code>getChildAt()</code> methods + * to access only "content" children, which are the controls + * and other containers that you put inside it. + * But a Container can also have additional children + * created automatically by the framework, such as a background or border + * skin and scrollbars. + * So Container exposes a property called <code>rawChildren</code> + * of type IChildList, which lets you access all its children, + * not just the content children.</p> + * + * <p>As another example, the SystemManager class is a DisplayObjectContainer + * whose children are partitioned into various layers: + * normal children like the Application are on the bottom, + * popups above them, tooltips above them, and cursors on the top. + * The SystemManager class has properties named <code>popUpChildren</code>, + * <code>toolTipChildren</code>, and <code>cursorChildren</code> + * which let you access these layers, and the type of each of these + * properties is IChildList. + * Therefore, you can count the number of popups using the + * <code>systemManager.popUpChildren.numChildren</code> property, + * insert another DisplayObject into the tooltip layer using the + * <code>systemManager.toolTipChildren.addChild()</code> method, and so on.</p> + * + * @see mx.core.Container#rawChildren + * @see mx.managers.SystemManager#rawChildren + * @see mx.managers.SystemManager#popUpChildren + * @see mx.managers.SystemManager#toolTipChildren + * @see mx.managers.SystemManager#cursorChildren + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ +public interface IChildList +{ + //-------------------------------------------------------------------------- + // + // Properties + // + //-------------------------------------------------------------------------- + + //---------------------------------- + // numChildren + //---------------------------------- + + /** + * The number of children in this child list. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get numChildren():int; + + //-------------------------------------------------------------------------- + // + // Methods + // + //-------------------------------------------------------------------------- + + /** + * Adds a child DisplayObject after the end of this child list. + * + * <p>Calling <code>childList.addChild(child)</code> is the same as calling + * <code>childList.addChild(child, childList.numChildren)</code> + * After it has been added, its index of the new child + * will be <code>(child.numChildren - 1)</code></p> + * + * @param child The DisplayObject to add as a child. + * + * @return The child that was added; this is the same + * as the argument passed in. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function addChild(child:DisplayObject):DisplayObject; + + /** + * Adds a child DisplayObject to this child list at the index specified. + * An index of 0 represents the beginning of the DisplayList, + * and an index of <code>numChildren</code> represents the end. + * + * <p>Adding a child anywhere except at the end of a child list + * will increment the indexes of children that were previously + * at that index or at higher indices.</p> + * + * @param child The DisplayObject to add as a child. + * + * @param index The index to add the child at. + * + * @return The child that was added; this is the same + * as the <code>child</code> argument passed in. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function addChildAt(child:DisplayObject, index:int):DisplayObject; + + /** + * Removes the specified child DisplayObject from this child list. + * + * <p>Removing a child anywhere except from the end of a child list + * will decrement the indexes of children that were at higher indices.</p> + * + * <p>The removed child will have its parent set to null and will be + * garbage collected if no other references to it exist.</p> + * + * @param child The DisplayObject to remove. + * + * @return The child that was removed; this is the same + * as the argument passed in. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function removeChild(child:DisplayObject):DisplayObject; + + /** + * Removes the child DisplayObject at the specified index + * from this child list. + * + * <p>Removing a child anywhere except from the end of a child list + * will decrement the indexes of children that were at higher indices.</p> + * + * <p>The removed child will have its parent set to null and will be + * garbage collected if no other references to it exist.</p> + * + * @param index The child index of the DisplayObject to remove. + * + * @return The child that was removed. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function removeChildAt(index:int):DisplayObject; + + /** + * Gets the child DisplayObject at the specified index in this child list. + * + * @param index An integer from 0 to <code>(numChildren - 1)</code> + * that specifies the index of a child in this child list. + * + * @return The child at the specified index. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function getChildAt(index:int):DisplayObject; + + /** + * Gets the child DisplayObject with the specified name + * in this child list. + * + * @param name The name of the child to return. + * + * @return The child with the specified name. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function getChildByName(name:String):DisplayObject; + + /** + * Gets the index of a specific child in this child list. + * + * <p>The first child in the child list has an index of 0, + * the second child has an index of 1, and the last child + * has an index of <code>(numChildren - 1)</code>.</p> + * + * <p>If <code>getChildIndex(myChild)</code> returns 5, + * then <code>myView.getChildAt(5)</code> returns + * <code>myChild</code>.</p> + * + * <p>If you add a child by calling the <code>addChild()</code> method, + * the new child's index is equal to the largest index among the + * existing children plus one.</p> + * + * <p>You can insert a child at a specified index by using the + * <code>addChildAt()</code> method + * In that case the children previously at that index and higher + * indices have their index increased by 1 so that all + * children are indexed from 0 to <code>(numChildren - 1)</code>.</p> + * + * <p>If you remove a child by calling the <code>removeChild()</code> + * or <code>removeChildAt()</code> method, then the children + * at higher indices have their index decreased by 1 so that + * all children are indexed from 0 to <code>(numChildren - 1)</code>.</p> + * + * <p>If you change a child's index by calling the + * <code>setChildIndex()</code> method, then the children between + * the old index and the new index, inclusive, have their indexes + * adjusted so that all children are indexed from + * 0 to <code>(numChildren - 1)</code>.</p> + * + * @param child The child whose index to get. + * + * @return The index of the child, which is an integer + * between 0 and <code>(numChildren - 1)</code>. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function getChildIndex(child:DisplayObject):int; + + /** + * Changes the index of a particular child in this child list. + * See the <code>getChildIndex()</code> method for a + * description of the child's index. + * + * @param child The child whose index to set. + * + * @param newIndex The new index for the specified child. + * This must be an integer between zero and <code>(numChildren - 1)</code>. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function setChildIndex(child:DisplayObject, newIndex:int):void; + + /** + * Returns an array of DisplayObjects that lie under the specified point + * and are in this child list. + * + * @param point The point under which to look. + * + * @return An array of object that lie under the specified point + * that are children of this Container. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function getObjectsUnderPoint(point:Point):Array; + + /** + * Determines if a DisplayObject is in this child list, + * or is a descendant of an child in this child list. + * + * @param child The DisplayObject to test. + * + * @return <code>true</code> if the DisplayObject is in this child list + * or is a descendant of an child in this child list; + * <code>false</code> otherwise. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function contains(child:DisplayObject):Boolean; +} + +} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IConstraintClient.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IConstraintClient.as index ea9728f,0000000..d437d66 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IConstraintClient.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IConstraintClient.as @@@ -1,96 -1,0 +1,96 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +/** + * The IConstraintClient interface defines the interface for components that + * support layout constraints. This interface is only used by implementations + * of constraint-based layout. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + +public interface IConstraintClient +{ + //-------------------------------------------------------------------------- + // + // Methods + // + //-------------------------------------------------------------------------- + + //---------------------------------- + // getConstraintValue + //---------------------------------- + + /** + * Returns the specified constraint value. + * + * @param constraintName name of the constraint value. Constraint parameters are + * "<code>baseline</code>", "<code>bottom</code>", "<code>horizontalCenter</code>", + * "<code>left</code>", "<code>right</code>", "<code>top</code>", and + * "<code>verticalCenter</code>". + * + * <p>For more information about these parameters, see the Canvas and Panel containers and + * Styles Metadata AnchorStyles.</p> + * + * @return The constraint value, or null if it is not defined. + * + * @see mx.containers.Canvas + * @see mx.containers.Panel + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function getConstraintValue(constraintName:String):*; + + //---------------------------------- + // setConstraintValue + //---------------------------------- + + /** + * Sets the specified constraint value. + * + * @param constraintName name of the constraint value. Constraint parameters are + * "<code>baseline</code>", "<code>bottom</code>", "<code>horizontalCenter</code>", + * "<code>left</code>", "<code>right</code>", "<code>top</code>", and + * "<code>verticalCenter</code>". + * + * <p>For more information about these parameters, see the Canvas and Panel containers and + * Styles Metadata AnchorStyles.</p> + * + * @param value The new value for the constraint. + * + * @see mx.containers.Canvas + * @see mx.containers.Panel + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function setConstraintValue(constraintName:String, value:*):void; +} - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IContainer.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IContainer.as index 8151a41,0000000..7a2ddda mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IContainer.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IContainer.as @@@ -1,138 -1,0 +1,138 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +import mx.managers.IFocusManager; + +/** + * IContainer is a interface that indicates a component + * extends or mimics mx.core.Container + * + * @see mx.core.Container + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ +public interface IContainer extends IUIComponent +{ + - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.display.DisplayObject; + import flash.display.DisplayObjectContainer; + import flash.display.Sprite; + import flash.geom.Point; + import flash.geom.Rectangle; + import flash.display.Graphics; +} +COMPILE::JS +{ + import flex.display.DisplayObject; + import flex.display.DisplayObjectContainer; + import flex.display.Sprite; + import org.apache.flex.geom.Point; + import org.apache.flex.geom.Rectangle; + import flex.display.Graphics; +} +COMPILE::LATER +{ + import flash.media.SoundTransform; +} + +include "ISpriteInterface.as" +include "IDisplayObjectContainerInterface.as" - COMPILE::AS3 ++COMPILE::SWF +{ +include "IInteractiveObjectInterface.as" +} + + /** + * @copy mx.core.Container#defaultButton + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get defaultButton():IFlexDisplayObject; + function set defaultButton(value:IFlexDisplayObject):void; + + /** + * @copy mx.core.Container#creatingContentPane + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get creatingContentPane():Boolean; + function set creatingContentPane(value:Boolean):void; + + /** + * @copy mx.core.Container#viewMetrics + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get viewMetrics():EdgeMetrics; + + /** + * @copy mx.core.Container#horizontalScrollPosition + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get horizontalScrollPosition():Number; + COMPILE::LATER + function set horizontalScrollPosition(value:Number):void; + + /** + * @copy mx.core.Container#verticalScrollPosition + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get verticalScrollPosition():Number; + COMPILE::LATER + function set verticalScrollPosition(value:Number):void; + + /** + * @copy mx.core.UIComponent#focusManager + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get focusManager():IFocusManager; +} + +} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IDeferredContentOwner.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IDeferredContentOwner.as index 7dba39b,0000000..1714b48 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IDeferredContentOwner.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IDeferredContentOwner.as @@@ -1,104 -1,0 +1,104 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +/** + * Dispatched after the content for this component has been created. With deferred + * instantiation, the content for a component can be created long after the + * component is created. + * + * @eventType mx.events.FlexEvent.CONTENT_CREATION_COMPLETE + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ +[Event(name="contentCreationComplete", type="mx.events.FlexEvent")] + +/** + * The IDeferredContentOwner interface defines the properties and methods + * for deferred instantiation. + * + * @see spark.components.SkinnableContainer + * @see mx.core.Container + * @see mx.core.INavigatorContent + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ +public interface IDeferredContentOwner extends IUIComponent +{ + [Inspectable(enumeration="auto, all, none", defaultValue="auto")] + + /** + * Content creation policy for this component. + * + * <p>Possible values are: + * <ul> + * <li><code>auto</code> - Automatically create the content immediately before it is needed.</li> + * <li><code>all</code> - Create the content as soon as the parent component is created. This + * option should only be used as a last resort because it increases startup time and memory usage.</li> + * <li><code>none</code> - Content must be created manually by calling + * the <code>createDeferredContent()</code> method.</li> + * </ul> + * </p> + * + * <p>If no <code>creationPolicy</code> is specified for a container, that container inherits the value of + * its parent's <code>creationPolicy</code> property.</p> + * + * @default "auto" + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function get creationPolicy():String; + function set creationPolicy(value:String):void; + + /** + * Create the content for this component. If the value of the <code>creationPolicy</code> property + * is <code>auto</code> or <code>all</code>, this the Flex framework calls this method. If the value of the + * <code>creationPolicy</code> property is <code>none</code>, you must explicitly call this method + * to create the content for the component. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function createDeferredContent():void; + + /** + * A flag that indicates whether the deferred content has been created. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function get deferredContentCreated():Boolean; +} + - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectContainerInterface.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectContainerInterface.as index 4fd04f3,0000000..0c70b19 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectContainerInterface.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectContainerInterface.as @@@ -1,246 -1,0 +1,246 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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. +// +//////////////////////////////////////////////////////////////////////////////// + +/* + * The IDisplayObjectContainerInterface defines the basic set of APIs + * for web version of flash.display.DisplayObjectContainer + * + */ - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.display.DisplayObjectContainer; +} +COMPILE::LATER +{ +import flash.text.TextSnapshot; +import flash.geom.Point; +} + + /** + * @copy flash.display.DisplayObjectContainer#addChild() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function addChild(child:flash.display.DisplayObject):flash.display.DisplayObject; + COMPILE::JS + function addChild(child:DisplayObject):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#addChildAt() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function addChildAt(child:flash.display.DisplayObject, index:int):flash.display.DisplayObject; + COMPILE::JS + function addChildAt(child:DisplayObject, index:int):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#removeChild() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function removeChild(child:flash.display.DisplayObject):flash.display.DisplayObject; + COMPILE::JS + function removeChild(child:DisplayObject):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#removeChildAt() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function removeChildAt(index:int):flash.display.DisplayObject; + COMPILE::JS + function removeChildAt(index:int):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#getChildIndex() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function getChildIndex(child:flash.display.DisplayObject):int; + COMPILE::JS + function getChildIndex(child:DisplayObject):int; + + /** + * @copy flash.display.DisplayObjectContainer#setChildIndex() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function setChildIndex(child:flash.display.DisplayObject, index:int):void; + COMPILE::JS + function setChildIndex(child:DisplayObject, index:int):void; + + /** + * @copy flash.display.DisplayObjectContainer#getChildAt() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function getChildAt(index:int):flash.display.DisplayObject; + COMPILE::JS + function getChildAt(index:int):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#getChildByName() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function getChildByName(name:String):flash.display.DisplayObject; + COMPILE::JS + function getChildByName(name:String):DisplayObject; + + /** + * @copy flash.display.DisplayObjectContainer#numChildren + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get numChildren():int; + + /** + * @copy flash.display.DisplayObjectContainer#textSnapshot + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get textSnapshot():TextSnapshot; + + /** + * @copy flash.display.DisplayObjectContainer#getObjectsUnderPoint() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function getObjectsUnderPoint(point:Point):Array; + + /** + * @copy flash.display.DisplayObjectContainer#areInaccessibleObjectsUnderPoint() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function areInaccessibleObjectsUnderPoint(point:Point):Boolean; + + /** + * Determines whether the children of the object are tab enabled. + * + * <p><b>Note:</b> Do not use this property with Flex. + * Instead, use the <code>UIComponent.hasFocusableChildren</code> property.</p> + * + * @see mx.core.UIComponent#hasFocusableChildren + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get tabChildren():Boolean; + COMPILE::LATER + function set tabChildren(enable:Boolean):void; + + /** + * @copy flash.display.DisplayObjectContainer#mouseChildren + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get mouseChildren():Boolean; + COMPILE::LATER + function set mouseChildren(enable:Boolean):void; + + /** + * @copy flash.display.DisplayObjectContainer#contains() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function contains(child:flash.display.DisplayObject):Boolean; + COMPILE::JS + function contains(child:DisplayObject):Boolean; + + /** + * @copy flash.display.DisplayObjectContainer#swapChildrenAt() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function swapChildrenAt(index1:int, index2:int):void; + + /** + * @copy flash.display.DisplayObjectContainer#swapChildren() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function swapChildren(child1:DisplayObject, child2:DisplayObject):void; http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectInterface.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectInterface.as index f84242d,0000000..794bdbc mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectInterface.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IDisplayObjectInterface.as @@@ -1,416 -1,0 +1,416 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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. +// +//////////////////////////////////////////////////////////////////////////////// + +/* + * The methods here would normally just be in IDisplayObject, + * but for backward compatibility, they have to be included + * directly into IFlexDisplayObject, so they are kept in + * this separate include file. + */ + + /** + * @copy flash.display.DisplayObject#root + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get root():flash.display.DisplayObject; + COMPILE::JS + function get root():DisplayObject; + + + /** + * @copy flash.display.DisplayObject#stage + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get stage():Stage; + + + /** + * @copy flash.display.DisplayObject#name + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get name():String; + function set name(value:String):void; + + + /** + * @copy flash.display.DisplayObject#parent + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get parent():flash.display.DisplayObjectContainer; + COMPILE::JS + function get parent():DisplayObjectContainer; + + + /** + * @copy flash.display.DisplayObject#mask + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get mask():DisplayObject; + COMPILE::LATER + function set mask(value:DisplayObject):void; + + + /** + * @copy flash.display.DisplayObject#visible + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get visible():Boolean; + function set visible(value:Boolean):void; + * already in IUIBase + */ + + + /** + * @copy flash.display.DisplayObject#x + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get x():Number; + function set x(value:Number):void; + * already in IUIBase + */ + + + /** + * @copy flash.display.DisplayObject#y + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get y():Number; + function set y(value:Number):void; + * already in IUIBase + */ + + + /** + * @copy flash.display.DisplayObject#scaleX + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get scaleX():Number; + COMPILE::LATER + function set scaleX(value:Number):void; + + + /** + * @copy flash.display.DisplayObject#scaleY + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get scaleY():Number; + COMPILE::LATER + function set scaleY(value:Number):void; + + + /** + * @copy flash.display.DisplayObject#mouseX + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get mouseX():Number; // note: no setter + + + /** + * @copy flash.display.DisplayObject#mouseY + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get mouseY():Number; // note: no setter + + + /** + * @copy flash.display.DisplayObject#rotation + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get rotation():Number; + COMPILE::LATER + function set rotation(value:Number):void; + + + /** + * @copy flash.display.DisplayObject#alpha + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get alpha():Number; + function set alpha(value:Number):void; + * already in IUIBase + */ + + + /** + * @copy flash.display.DisplayObject#width + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get width():Number; + function set width(value:Number):void; + * already in IUIBase + */ + + /** + * @copy flash.display.DisplayObject#height + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + function get height():Number; + function set height(value:Number):void; + * already in IUIBase + */ + + + /** + * @copy flash.display.DisplayObject#cacheAsBitmap + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get cacheAsBitmap():Boolean; + COMPILE::LATER + function set cacheAsBitmap(value:Boolean):void; + + /** + * @copy flash.display.DisplayObject#opaqueBackground + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get opaqueBackground():Object; + COMPILE::LATER + function set opaqueBackground(value:Object):void; + + + /** + * @copy flash.display.DisplayObject#scrollRect + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get scrollRect():Rectangle; + COMPILE::LATER + function set scrollRect(value:Rectangle):void; + + + /** + * @copy flash.display.DisplayObject#filters + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get filters():Array; + COMPILE::LATER + function set filters(value:Array):void; + + /** + * @copy flash.display.DisplayObject#blendMode + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get blendMode():String; + COMPILE::LATER + function set blendMode(value:String):void; + + /** + * @copy flash.display.DisplayObject#transform + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get transform():Transform; + COMPILE::LATER + function set transform(value:Transform):void; + + /** + * @copy flash.display.DisplayObject#scale9Grid + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get scale9Grid():Rectangle; + COMPILE::LATER + function set scale9Grid(innerRectangle:Rectangle):void; + + /** + * @copy flash.display.DisplayObject#globalToLocal() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function globalToLocal(point:Point):Point; + + /** + * @copy flash.display.DisplayObject#localToGlobal() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function localToGlobal(point:Point):Point; + + /** + * @copy flash.display.DisplayObject#getBounds() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function getBounds(targetCoordinateSpace:DisplayObject):Rectangle; + + /** + * @copy flash.display.DisplayObject#getRect() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function getRect(targetCoordinateSpace:DisplayObject):Rectangle; + + /** + * @copy flash.display.DisplayObject#loaderInfo + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get loaderInfo() : LoaderInfo; + + /** + * @copy flash.display.DisplayObject#hitTestObject() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function hitTestObject(obj:DisplayObject):Boolean; + + /** + * @copy flash.display.DisplayObject#hitTestPoint() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function hitTestPoint(x:Number, y:Number, shapeFlag:Boolean=false):Boolean; + + /** + * @copy flash.display.DisplayObject#accessibilityProperties + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get accessibilityProperties() : AccessibilityProperties; + COMPILE::LATER + function set accessibilityProperties( value : AccessibilityProperties ) : void; + http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IFlexDisplayObject.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IFlexDisplayObject.as index ecb8dd5,0000000..cb6743f mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IFlexDisplayObject.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IFlexDisplayObject.as @@@ -1,153 -1,0 +1,153 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +//import flash.display.IBitmapDrawable; + - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.display.DisplayObject; + import flash.display.DisplayObjectContainer; + import flash.geom.Rectangle; +} +COMPILE::JS +{ + import flex.display.DisplayObject; + import org.apache.flex.geom.Rectangle; +} +import org.apache.flex.events.IEventDispatcher; +import flex.display.TopOfDisplayList; + +/** + * The IFlexDisplayObject interface defines the interface for skin elements. + * At a minimum, a skin must be a DisplayObject and implement this interface. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ +public interface IFlexDisplayObject extends /*IBitmapDrawable, */IEventDispatcher, flex.display.DisplayObject +{ + + //-------------------------------------------------------------------------- + // + // Properties + // + //-------------------------------------------------------------------------- + + + //---------------------------------- + // measuredHeight + //---------------------------------- + + /** + * The measured height of this object. + * + * <p>This is typically hard-coded for graphical skins + * because this number is simply the number of pixels in the graphic. + * For code skins, it can also be hard-coded + * if you expect to be drawn at a certain size. + * If your size can change based on properties, you may want + * to also be an ILayoutManagerClient so a <code>measure()</code> + * method will be called at an appropriate time, + * giving you an opportunity to compute a <code>measuredHeight</code>.</p> + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get measuredHeight():Number; + + //---------------------------------- + // measuredWidth + //---------------------------------- + + /** + * The measured width of this object. + * + * <p>This is typically hard-coded for graphical skins + * because this number is simply the number of pixels in the graphic. + * For code skins, it can also be hard-coded + * if you expect to be drawn at a certain size. + * If your size can change based on properties, you may want + * to also be an ILayoutManagerClient so a <code>measure()</code> + * method will be called at an appropriate time, + * giving you an opportunity to compute a <code>measuredHeight</code>.</p> + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get measuredWidth():Number; + + + //-------------------------------------------------------------------------- + // + // Methods + // + //-------------------------------------------------------------------------- + + /** + * Moves this object to the specified x and y coordinates. + * + * @param x The new x-position for this object. + * + * @param y The new y-position for this object. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function move(x:Number, y:Number):void; + + /** + * Sets the actual size of this object. + * + * <p>This method is mainly for use in implementing the + * <code>updateDisplayList()</code> method, which is where + * you compute this object's actual size based on + * its explicit size, parent-relative (percent) size, + * and measured size. + * You then apply this actual size to the object + * by calling <code>setActualSize()</code>.</p> + * + * <p>In other situations, you should be setting properties + * such as <code>width</code>, <code>height</code>, + * <code>percentWidth</code>, or <code>percentHeight</code> + * rather than calling this method.</p> + * + * @param newWidth The new width for this object. + * + * @param newHeight The new height for this object. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function setActualSize(newWidth:Number, newHeight:Number):void; +} + +} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/INavigatorContent.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/INavigatorContent.as index 27afaa4,0000000..a1fa6aa mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/INavigatorContent.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/INavigatorContent.as @@@ -1,67 -1,0 +1,67 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ +import mx.managers.IToolTipManagerClient; + +/** + * The INavigatorContent interface defines the interface that a container must + * implement to be used as the child of a navigator container, + * such as the ViewStack, TabNavigator, and Accordion navigator containers. + * + * @see mx.containers.Accordion + * @see mx.containers.TabNavigator + * @see mx.containers.ViewStack + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ +public interface INavigatorContent extends IDeferredContentOwner, IToolTipManagerClient +{ + [Bindable("labelChanged")] + /** + * The text displayed by the navigator container for this container. + * For example, the text appears in the button area of an Accordion container + * and in the tab area of the TabNavigator container. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function get label():String; + + [Bindable("iconChanged")] + /** + * The icon displayed by the navigator container for this container. + * The icon appears in the button area of an Accordion container + * and in the tab area of the TabNavigator container. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function get icon():Class; +} + - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IProgrammaticSkin.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IProgrammaticSkin.as index d1902d0,0000000..31e4cc5 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IProgrammaticSkin.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IProgrammaticSkin.as @@@ -1,55 -1,0 +1,55 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +/** + * The IProgrammaticSkin interface defines the interface that skin classes must implement + * if they use the <code>name</code> property skin interface. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ +public interface IProgrammaticSkin +{ + /** + * @copy mx.skins.ProgrammaticSkin#validateNow() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function validateNow():void; + + /** + * @copy mx.skins.ProgrammaticSkin#validateDisplayList() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function validateDisplayList():void; +} + - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/ISpriteInterface.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/ISpriteInterface.as index 0c86380,0000000..57ca61c mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/ISpriteInterface.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/ISpriteInterface.as @@@ -1,121 -1,0 +1,121 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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. +// +//////////////////////////////////////////////////////////////////////////////// + +/* + * The ISprite interface defines the basic set of APIs + * for web version of flash.display.Sprite + */ + + /** + * @copy flash.display.Sprite#graphics + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get graphics():Graphics; + + /** + * @copy flash.display.Sprite#buttonMode + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get buttonMode():Boolean; - COMPILE::AS3 ++ COMPILE::SWF + function set buttonMode(value:Boolean):void; + + /** + * @copy flash.display.Sprite#startDrag() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void; + + /** + * @copy flash.display.Sprite#stopDrag() + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function stopDrag():void; + + /** + * @copy flash.display.Sprite#dropTarget + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get dropTarget():DisplayObject; + + /** + * @copy flash.display.Sprite#hitArea + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get hitArea():Sprite; - COMPILE::AS3 ++ COMPILE::SWF + function set hitArea(value:Sprite):void; + + + /** + * @copy flash.display.Sprite#useHandCursor + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ - COMPILE::AS3 ++ COMPILE::SWF + function get useHandCursor():Boolean; - COMPILE::AS3 ++ COMPILE::SWF + function set useHandCursor(value:Boolean):void; + + + /** + * @copy flash.display.Sprite#soundTransform + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + COMPILE::LATER + function get soundTransform():SoundTransform; + COMPILE::LATER + function set soundTransform(sndTransform:SoundTransform):void; + http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/IStateClient2.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/IStateClient2.as index b7cfa08,0000000..1b0fc06 mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/IStateClient2.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/IStateClient2.as @@@ -1,103 -1,0 +1,103 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +import org.apache.flex.events.IEventDispatcher; + +/** + * The IStateClient2 interface defines the interface that + * components must implement to support Flex 4 view state + * semantics. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ +public interface IStateClient2 extends IEventDispatcher, IStateClient +{ + //-------------------------------------------------------------------------- + // + // Properties + // + //-------------------------------------------------------------------------- + + //---------------------------------- + // states + //---------------------------------- + + [ArrayElementType("mx.states.State")] + + /** + * The set of view state objects. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get states():Array; + + /** + * @private + */ + function set states(value:Array):void; + + + //---------------------------------- + // transitions + //---------------------------------- + + [ArrayElementType("mx.states.Transition")] + + /** + * The set of view state transitions. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function get transitions():Array; + + /** + * @private + */ + function set transitions(value:Array):void; + + /** + * Determines whether the specified state has been defined on this + * UIComponent. + * + * @param stateName The name of the state being checked. + * + * @return Whether or not the specified state has been defined + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function hasState(stateName:String):Boolean + +} + - } ++} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/ITextFieldFactory.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/ITextFieldFactory.as index c14101b,0000000..8ec036f mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/ITextFieldFactory.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/ITextFieldFactory.as @@@ -1,78 -1,0 +1,78 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + - COMPILE::AS3 ++COMPILE::SWF +{ + import flash.text.TextField; +} +COMPILE::JS +{ + import flex.text.TextField; +} + +[ExcludeClass] + +/** + * @private + * Interface to create instances of TextField and FTETextField. + * These are re-used so that there are no more than one of each + * per module factory. + */ +public interface ITextFieldFactory +{ + /** + * Creates an instance of TextField + * in the context of the specified IFlexModuleFactory. + * + * @param moduleFactory The IFlexModuleFactory requesting the TextField. + * + * @return A FTETextField created in the context + * of <code>moduleFactory</code>. + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 3 + */ + function createTextField(moduleFactory:IFlexModuleFactory):TextField; + + /** + * Creates an instance of FTETextField + * in the context of the specified module factory. + * + * @param moduleFactory The IFlexModuleFactory requesting the TextField. + * May not be <code>null</code>. + * + * @return A FTETextField created in the context + * of <code>moduleFactory</code>. + * The return value is loosely typed as Object + * to avoid linking in FTETextField (and therefore much of TLF). + * + * @langversion 3.0 + * @playerversion Flash 9 + * @playerversion AIR 1.1 + * @productversion Flex 4 + */ + function createFTETextField(moduleFactory:IFlexModuleFactory):Object; +} + +} http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/77148f4a/frameworks/projects/MX/src/main/flex/mx/core/ITransientDeferredInstance.as ---------------------------------------------------------------------- diff --cc frameworks/projects/MX/src/main/flex/mx/core/ITransientDeferredInstance.as index 65f31d1,0000000..c1952ba mode 100644,000000..100644 --- a/frameworks/projects/MX/src/main/flex/mx/core/ITransientDeferredInstance.as +++ b/frameworks/projects/MX/src/main/flex/mx/core/ITransientDeferredInstance.as @@@ -1,65 -1,0 +1,65 @@@ +//////////////////////////////////////////////////////////////////////////////// +// +// 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.core +{ + +/** + * The ITransientDeferredInstance interface extends IDeferredInstance and adds + * the ability for the user to reset the deferred instance factory to its + * initial state (usually this implies releasing any known references to the + * component, such as the setting the owning document property that refers to + * the instance to null). + * + * This additional capability is leveraged by the AddItems states override when + * the desired behavior is to destroy a state-specific element when a state + * no longer applies. + * + * The Flex compiler uses the same automatic coercion rules as with + * IDeferredInstance. + * + * @see mx.states.AddItems + * @see mx.core.IDeferredInstance + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ +public interface ITransientDeferredInstance extends IDeferredInstance +{ + //-------------------------------------------------------------------------- + // + // Methods + // + //-------------------------------------------------------------------------- + + /** + * Resets the state of our factory to its initial state, clearing any + * references to the cached instance. + * + * @langversion 3.0 + * @playerversion Flash 10 + * @playerversion AIR 1.5 + * @productversion Flex 4 + */ + function reset():void; +} + - } ++}
