IContainer  - AS3 Flex

Especifica el modo de botón de este elemento sprite. Si el valor es true, este elemento sprite se comporta como un botón, lo que significa que activa la visualización del puntero de mano cuando el cursor pasa por encima del elemento sprite y puede recibir un evento click si se presionan las teclas Intro o espacio cuando está seleccionado el elemento sprite. Puede suprimir la visualización del cursor de mano al definir la propiedad useHandCursor con el valor false, en cuyo caso se muestra el puntero.

Aunque es preferible utilizar la clase SimpleButton para crear botones, puede utilizar la propiedad buttonMode con el fin de dar a un elemento sprite alguna funcionalidad de botón. Para incluir un elemento sprite en el orden de tabulación, defina la propiedad tabEnabled (heredada de la clase InteractiveObject y con el valor predeterminado false) con el valor true. Además, decida si desea que los elementos secundarios del elemento sprite estén habilitados para la entrada del usuario. La mayoría de los botones no activan la interactividad de entrada del usuario para sus objetos secundarios, ya que ello genera confusión en el flujo de eventos. Para desactivar la interactividad de la entrada del usuario para todos los objetos secundarios, debe definir la propiedad mouseChildren (heredada de la clase DisplayObjectContainer) con el valor false.

Si utiliza la propiedad buttonMode con la clase MovieClip (que es una subclase de la clase Sprite), el botón puede tener alguna funcionalidad añadida. Si incluye fotogramas etiquetados con _up, _over y _down, Flash Player proporcionará cambios de estado automáticos (funcionalidad similar a la que se ofrecía en versiones anteriores de ActionScript para clips de película utilizados como botones). Estos cambios de estado automáticos no están disponibles para elementos sprite, que carecen de línea de tiempo y, por consiguiente, no tienen fotogramas que etiquetar.

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

Especifica si este objeto recibe eventos doubleClick. El valor predeterminado es false, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject no recibe eventos doubleClick. Si la propiedad doubleClickEnabled se establece con el valor true, la instancia recibirá eventos doubleClick dentro de sus límites. La propiedad mouseEnabled de la instancia de InteractiveObject debe también estar configurada con el valor true para que el objeto reciba eventos doubleClick.

No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener() para añadir un detector de eventos para el evento doubleClick.

Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

Especifica si este objeto muestra un rectángulo de selección. Puede tener uno de estos tres valores: true, false o null. Los valores true y false funcionan como siempre: especifican si aparece o no el rectángulo seleccionado. El valor null indica que este objeto obedece a la propiedad stageFocusRect establecida en el escenario.

Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.

Designa otro elemento sprite para que actúe como área activa de un elemento sprite. Si la propiedad hitArea no existe o tiene el valor null o undefined, se utilizará el propio elemento sprite como área activa. El valor de la propiedad hitArea puede ser una referencia a un objeto Sprite.

Puede cambiar la propiedad hitArea en cualquier momento; el elemento sprite modificado adoptará de inmediato el nuevo comportamiento de área activa. No es preciso que el elemento sprite designado como área activa sea visible; se detectará la condición de "activa" de su forma gráfica aunque no sea visible.

Nota: debe establecer con el valor false la propiedad mouseEnabled del elemento sprite designado como área activa. En caso contrario, el botón sprite podría no funcionar, ya que el elemento sprite designado como área activa recibe eventos de entrada del usuario en lugar del botón sprite.

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario. Si un objeto está activado, el usuario puede interactuar con él por medio de un ratón o de un dispositivo de entrada de usuario. El valor predeterminado es true.

Esta propiedad es útil cuando se crea un botón con una instancia de la clase Sprite (en lugar de utilizar la clase SimpleButton). Cuando utilice una instancia de Sprite para crear un botón, podrá optar por decorar el botón empleando el método addChild() para añadir instancias adicionales de Sprite. Este proceso puede provocar un comportamiento inesperado con los eventos de ratón, ya que las instancias de Sprite que añada como elementos secundarios pueden convertirse en el objeto de destino de un evento de ratón cuando se espera que la instancia principal sea el objeto de destino. Para asegurarse de que la instancia principal actúa como objeto de destino de los eventos de ratón, puede establecer la propiedad mouseChildren de la instancia principal con el valor false.

No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener() para crear funcionalidad interactiva.

Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. El valor predeterminado es true, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject que esté en la lista de visualización recibirá eventos de ratón u otros eventos de entrada del usuario. Si mouseEnabled se establece en false, la instancia no recibirá ningún evento de ratón (o cualquier otra entrada de usuario como eventos de teclado). Los elementos secundarios de esta instancia en la lista de visualización no se verán afectados. Para cambiar el comportamiento mouseEnabled de todos los elementos secundarios de un objeto de la lista de visualización, utilice flash.display.DisplayObjectContainer.mouseChildren.

No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener() para crear funcionalidad interactiva.

Devuelve el número de elementos secundarios de este objeto.

Controla el sonido dentro de este elemento sprite.

Nota: esta propiedad no afecta a contenido HTML de un objeto HTMLControl (en Adobe AIR).

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

Elementos de API relacionados

Especifica si este objeto está en el orden de tabulación. Si este objeto está en el orden de tabulación, el valor es true; en caso contrario, el valor es false. De forma predeterminada, el valor es false, salvo en lo siguiente:

• En un objeto SimpleButton, el valor es true.
• En un objeto TextField con type = "input", el valor es true.
• En un objeto Sprite o MovieClip con buttonMode = true, el valor es true.

Especifica el orden de tabulación de los objetos de un archivo SWF. La propiedad tabIndex es -1 de manera predeterminada, lo que significa que no se ha establecido el índice de tabulación para el objeto.

Si algún objeto mostrado actualmente en el archivo SWF contiene una propiedad tabIndex, se desactivará el orden de tabulación automático y el orden de tabulación se calculará a partir de las propiedades tabIndex de los objetos del archivo SWF. El orden de tabulación personalizado sólo incluye objetos que tienen propiedades tabIndex.

La propiedad tabIndex puede ser un entero no negativo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex y en orden ascendente. Un objeto que tenga un valor tabIndex de 1 precederá a otro objeto que tenga un valor tabIndex de 2. No utilice el mismo valor de tabIndex para varios objetos.

El orden de tabulación personalizado que define la propiedad tabIndex es flat (plano o no jerárquico). Esto significa que no se tienen en cuenta las relaciones jerárquicas entre los objetos del archivo SWF. Todos los objetos del archivo SWF con propiedades tabIndex tendrán su lugar en el orden de tabulación, que se determinará por el orden de los valores de tabIndex.

Nota: para definir el orden de tabulación de instancias de TLFTextField, asigne el elemento secundario del objeto de visualización de TLFTextField como un objeto InteractiveObject y después establezca la propiedad tabIndex. Por ejemplo:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.

Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true. El valor predeterminado de la propiedad useHandCursor es true. Si useHandCursor se establece con el valor true, la mano que señala empleada para los botones se mostrará cuando el puntero pase por encima de un elemento sprite de botón. Si useHandCursor se establece con el valor false, se utilizará el puntero de flecha.

Puede cambiar la propiedad useHandCursor en cualquier momento; el elemento sprite modificado adoptará de inmediato el nuevo aspecto de cursor.

Nota: En Flex o Flash Builder, si la clase sprite tiene elementos secundarios, establezca la propiedad mouseChildren como false. Por ejemplo, si quiere que aparezca el cursor de mano sobre un control <mx:Label> de Flex, establezca las propiedades useHandCursor y buttonMode como to true, y la propiedad mouseChildren como false.

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. El elemento secundario se añade delante (encima) de todos los demás elementos secundarios de esta instancia de DisplayObjectContainer. (Para añadir un elemento secundario en una posición de índice concreta, utilice el método addChildAt().)

Si añade un objeto secundario que ya tiene un contenedor de objeto de visualización diferente como elemento principal, el objeto se elimina de la lista de elementos secundarios del otro contenedor de objeto de visualización.

Nota: el comando stage.addChild() puede causar problemas en un archivo SWF publicado, incluidos problemas de seguridad y conflictos con otros archivos SWF cargados. Sólo hay un escenario dentro de una instancia del motor de ejecución de Flash, no importa la cantidad archivos SWF cargados en el motor de ejecución. Por lo tanto, normalmente los objetos no se deben añadir al escenario directamente, bajo ningún concepto. El único objeto que debe contener el escenario es el objeto raíz. Cree un objeto DisplayObjectContainer para contener todos los elementos de la lista de visualización. Seguidamente, si es necesario, añada la instancia de DisplayObjectContainer al escenario.

Parámetros

Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. El elemento secundario situado en la posición de índice especificada. El índice 0 representa el final (la parte inferior) de la lista de visualización de este objeto DisplayObjectContainer.

Por ejemplo, el siguiente ejemplo muestra tres objetos de visualización, etiquetados como a, b y c, en las posiciones de índice 0, 2 y 1 respectivamente:

Si añade un objeto secundario que ya tiene un contenedor de objeto de visualización diferente como elemento principal, el objeto se elimina de la lista de elementos secundarios del otro contenedor de objeto de visualización.

Parámetros

Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado. De manera predeterminada, el contenido de un dominio no puede obtener acceso a objetos de otro dominio a no ser que se les permita hacerlo mediante una llamada al método Security.allowDomain(). Para obtener más información sobre la seguridad, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

El parámetro point está en el espacio de coordenadas del escenario, que puede ser distinto del espacio de coordenadas del contenedor del objeto de visualización (a no ser que el contenedor del objeto de visualización esté en el escenario). Puede utilizar los métodos globalToLocal() y localToGlobal() para convertir puntos entre estos espacios de coordenadas.

Parámetros

Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia. La búsqueda incluye la lista de visualización completa, incluida esta instancia de DisplayObjectContainer. Los elementos terciarios, cuaternarios, etc., devuelven true.

Parámetros

Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.

Parámetros

Devuelve el objeto de visualización secundario que sale con el nombre especificado. Si varios objetos de visualización secundarios tienen el nombre especificado, el método devolverá el primer objeto de la lista secundaria.

El método getChildAt() es más rápido que getChildByName(). El método getChildAt() obtiene acceso a un elemento secundario de un conjunto en caché, mientras que el método getChildByName() tiene que atravesar una lista vinculada para obtener acceso a un elemento secundario.

Parámetros

Devuelve la posición de índice de una instancia child de DisplayObject.

Parámetros

Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer. Los objetos secundarios que son inaccesibles por motivos de seguridad se omiten en el conjunto devuelto. Para determinar si esta restricción de seguridad afecta al conjunto devuelto, llame al método areInaccessibleObjectsUnderPoint().

El parámetro point está en el espacio de coordenadas del escenario, que puede ser distinto del espacio de coordenadas del contenedor del objeto de visualización (a no ser que el contenedor del objeto de visualización esté en el escenario). Puede utilizar los métodos globalToLocal() y localToGlobal() para convertir puntos entre estos espacios de coordenadas.

Parámetros

Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer. La propiedad parent del elemento secundario eliminado se establece como null y el objeto se recoge como dato innecesario si no hay ninguna otra referencia al elemento secundario. La posición de índice de los objetos de visualización situados por encima del elemento secundario en DisplayObjectContainer se reduce en 1.

La eliminación de datos innecesarios rescata espacio de memoria no utilizado. Cuando deja de haber una referencia activa o un almacenamiento de una variable o un objeto en algún lugar, la recogida de datos innecesarios limpia el espacio de memoria que ocupaba si no hay ninguna otra referencia a estos.

Parámetros

Elimina una instancia de DisplayObject secundaria de la posición de index especificada en la lista de elementos secundarios de DisplayObjectContainer. La propiedad parent del elemento secundario eliminado se establece como null y el objeto se recoge como dato innecesario si no hay ninguna otra referencia al elemento secundario. La posición de índice de los objetos de visualización situados por encima del elemento secundario en DisplayObjectContainer se reduce en 1.

La eliminación de datos innecesarios rescata espacio de memoria no utilizado. Cuando deja de haber una referencia activa o un almacenamiento de una variable o un objeto en algún lugar, la recogida de datos innecesarios limpia el espacio de memoria que ocupaba si no hay ninguna otra referencia a estos.

Parámetros

Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización. Esto afecta a la disposición en capas de los objetos secundarios. Por ejemplo, el siguiente ejemplo muestra tres objetos de visualización, etiquetados como a, b y c, en las posiciones de índice 0, 1 y 2 respectivamente:

Cuando se utiliza el método setChildIndex() y se especifica una posición de índice ya ocupada, sólo se pueden cambiar las posiciones situadas entre la posición nueva y antigua de los objetos de visualización. El resto permanecen invariables. Si se mueve un elemento secundario a un índice INFERIOR que su índice actual, todos los elementos secundarios AUMENTARÁN en 1 su referencia de índice. Si se mueve un elemento secundario a un índice SUPERIOR que su índice actual, todos los elementos secundarios DISMINUIRÁN en 1 su referencia de índice. Por ejemplo, si el contenedor de objeto secundario del ejemplo anterior se denomina container, podrá intercambiar la posición de los objetos de visualización etiquetados como a y b llamando al siguiente código:

container.setChildIndex(container.getChildAt(1), 0);

Este código da como resultado la siguiente disposición de objetos:

Parámetros

Permite al usuario arrastrar el elemento sprite especificado. El elemento sprite se puede seguir arrastrando hasta que se detenga explícitamente mediante una llamada a Sprite.stopDrag() o hasta que otro elemento sprite pueda arrastrarse. Sólo es posible arrastrar elementos sprite de uno en uno.

Los objetos de visualización tridimensionales siguen al puntero y Sprite.startDrag() mueve el objeto dentro del plano tridimensional definido por el objeto de visualización. Si el objeto de visualización es bidimensional y un elemento secundario de un objeto tridimensional, el objeto en dos dimensiones se mueve dentro del plano tridimensional definido por el objeto principal en tres dimensiones.

Parámetros

Finaliza el método startDrag(). Un elemento sprite que se ha convertido en arrastrable con el método startDrag() podrá arrastrarse hasta que se añada un método stopDrag() o hasta que se pueda arrastrar otro elemento sprite. Sólo es posible arrastrar elementos sprite de uno en uno.

Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados. Todos los demás objetos secundarios del contenedor de objeto de visualización permanecerán en la misma posición de índice.

Parámetros

Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios. Todos los demás objetos secundarios del contenedor de objeto de visualización permanecerán en la misma posición de índice.

Parámetros