Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.display 

DisplayObjectContainer  - AS3

Paquetesx

Nivel superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.display
Clasepublic class DisplayObjectContainer
HerenciaDisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subclases Loader, Sprite, Stage, TextLine

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La clase DisplayObjectContainer es la clase base de todos los objetos que pueden actuar como contenedores de objetos de visualización en la lista de visualización. La lista de visualización administra todos los objetos mostrados en los motores de ejecución de Flash. Utilice la clase DisplayObjectContainer para organizar los objetos de visualización en la lista de visualización. Cada objeto DisplayObjectContainer tiene su propia lista de elementos secundarios para organizar el orden z de los objetos. El orden z es el orden de delante hacia atrás que determina qué objeto se dibuja delante, cuál se dibuja detrás, etc.

DisplayObject es una clase base abstracta; por consiguiente, no puede llamar a DisplayObject directamente. Al llamar a new DisplayObject() se emite una excepción ArgumentError.

La clase DisplayObjectContainer es la clase base abstracta para todos los objetos que contienen objetos secundarios. No es posible crear instancias directamente; al llamar al constructor new DisplayObjectContainer(), el constructor emite una excepción ArgumentError.

Para obtener más información, consulte el capítulo “Programación de visualización” de la Guía del desarrollador de ActionScript 3.0.

Ver los ejemplos

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityImplementation : AccessibilityImplementation
La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedblendShader : Shader
[solo escritura] Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true.
DisplayObject
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : NativeMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
 Inheritedfilters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
 Inheritedheight : Number
Indica la altura del objeto de visualización, expresada en píxeles.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[solo lectura] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
 InheritedmetaData : Object
Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4.
DisplayObject
  mouseChildren : Boolean
Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes.
InteractiveObject
 InheritedmouseX : Number
[solo lectura] Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.
DisplayObject
 InheritedmouseY : Number
[solo lectura] Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.
DisplayObject
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.
InteractiveObject
  numChildren : int
[solo lectura] Devuelve el número de elementos secundarios de este objeto.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[solo lectura] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
 Inheritedroot : DisplayObject
[solo lectura] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 InheritedrotationX : Number
Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.
DisplayObject
 InheritedrotationY : Number
Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.
DisplayObject
 InheritedrotationZ : Number
Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.
DisplayObject
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
 InheritedscaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
 Inherited    softKeyboard : String
Controla la apariencia del teclado virtual.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).
InteractiveObject
 Inheritedstage : Stage
[solo lectura] El escenario del objeto de visualización.
DisplayObject
  tabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF.
InteractiveObject
  textSnapshot : flash.text:TextSnapshot
[solo lectura] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : flash.geom:Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : Number
Indica la anchura del objeto de visualización, expresada en píxeles.
DisplayObject
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedz : Number
Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
La llamada al nuevo constructor DisplayObjectContainer() emite una excepción ArgumentError.
DisplayObjectContainer
  
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
  
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
  
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.
DisplayObjectContainer
  
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
DisplayObjectContainer
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
  
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
DisplayObjectContainer
  
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
DisplayObjectContainer
  
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
DisplayObjectContainer
  
Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional.
DisplayObject
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.
DisplayObject
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario.
DisplayObject
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
  
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
  
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
DisplayObjectContainer
  
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void
Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Muestra un teclado virtual.
InteractiveObject
  
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
DisplayObjectContainer
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto.
DisplayObjectContainer
  
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
DisplayObjectContainer
  
swapChildrenAt(index1:int, index2:int):void
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.
DisplayObjectContainer
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.EventDispatcher
 InheritedSe distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 InheritedSe distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
 InheritedSe distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual.InteractiveObject
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.InteractiveObject
 InheritedSe distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual.InteractiveObject
 InheritedSe distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual.InteractiveObject
 Inherited[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.EventDispatcher
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.InteractiveObject
 Inherited[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual.DisplayObject
 InheritedSe distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 InheritedSe distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited[evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma.DisplayObject
 InheritedSe distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles.InteractiveObject
 InheritedSe distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedEste evento se distribuye a cualquier cliente app que admite entrada en línea con un IMEInteractiveObject
 InheritedSe distribuye cuando el usuario pulsa una tecla.InteractiveObject
 InheritedSe distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta una tecla.InteractiveObject
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject.InteractiveObject
 InheritedDistribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.InteractiveObject
 InheritedDistribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop().InteractiveObject
 InheritedDistribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.InteractiveObject
 InheritedDistribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.InteractiveObject
 InheritedDistribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.InteractiveObject
 InheritedDistribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().InteractiveObject
 InheritedDistribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().InteractiveObject
 InheritedSe distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual.InteractiveObject
 InheritedSe distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.InteractiveObject
 Inherited
    proximityEnd
Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla.InteractiveObject
 InheritedSe distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad.InteractiveObject
 Inherited
    proximityOut
Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.InteractiveObject
 InheritedSe distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.InteractiveObject
 InheritedSe distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla.InteractiveObject
 InheritedSe distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla).InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 InheritedSe distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar.DisplayObject
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual.InteractiveObject
 InheritedSe distribuye inmediatamente una vez mostrado el teclado en pantalla.InteractiveObject
 InheritedSe distribuye inmediatamente antes de que se muestre el teclado en pantalla.InteractiveObject
 InheritedSe distribuye inmediatamente una vez oculto el teclado en pantalla.InteractiveObject
 InheritedSe distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 InheritedSe distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 InheritedSe distribuye cuando cambia el valor de la propiedad tabIndex del objeto.InteractiveObject
 InheritedSe distribuye cuando un usuario escribe uno o varios caracteres de texto.InteractiveObject
 InheritedSe distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo).InteractiveObject
 InheritedSe distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto.InteractiveObject
 InheritedSe distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
 InheritedSe distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).InteractiveObject
Información sobre propiedades

mouseChildren

propiedad
mouseChildren:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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.



Implementación
    public function get mouseChildren():Boolean
    public function set mouseChildren(value:Boolean):void

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se configura un objeto Sprite (un tipo de contenedor de objeto de visualización) denominado container y se muestra que cuando se establece la propiedad mouseChildren como false, el destino de un evento mouseClick es el objeto container, no cualquiera de sus objetos secundarios:
import flash.display.Sprite;
import flash.events.MouseEvent;

var container:Sprite = new Sprite();
container.name = "container";
addChild(container);

var circle:Sprite = new Sprite();
circle.name = "circle";
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(40, 40, 40);

container.addChild(circle);

container.mouseChildren = false;

container.addEventListener(MouseEvent.CLICK, clicked);

function clicked(event:MouseEvent):void {
    trace(event.target.name); // container
}

numChildren

propiedad 
numChildren:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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



Implementación
    public function get numChildren():int

Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se configuran dos objetos Sprite denominados container1 y container2. Sprite es un tipo de contenedor de objeto de visualización. El ejemplo llama al método addChild() para configurar la jerarquía de visualización: container1 es un elemento secundario de container2 y los otros dos objetos de visualización, circle1 y circle2, son elementos secundarios de container1. Las llamadas al método trace() muestran el número de objetos secundarios de cada objeto. Observe que los elementos terciarios no se incluyen en el recuento de numChildren:
import flash.display.Sprite;

var container1:Sprite = new Sprite();
var container2:Sprite = new Sprite();

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0x00CCFF);
circle2.graphics.drawCircle(80, 40, 40);

container2.addChild(container1);
container1.addChild(circle1);
container1.addChild(circle2);

trace(container1.numChildren); // 2
trace(container2.numChildren); // 1
trace(circle1.numChildren); // 0
trace(circle2.numChildren); // 0

tabChildren

propiedad 
tabChildren:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Determina si los elementos secundarios del objeto están habilitados para tabulación. Activa o desactiva la tabulación para los elementos secundarios del objeto. El valor predeterminado es true.

Nota: no se debe utilizar la propiedad tabChildren con Flex. En su lugar, utilice la propiedad mx.core.UIComponent.hasFocusableChildren.



Implementación
    public function get tabChildren():Boolean
    public function set tabChildren(value:Boolean):void

Emite
IllegalOperationError — Al llamar a esta propiedad del objeto Stage, se emite una excepción. El objeto Stage no implementa esta propiedad.

Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un contenedor de objeto de visualización container1 y se añaden dos objetos de visualización, circle1 y circle2 a la lista de elementos secundarios. El ejemplo define tabChildren como false para los elementos secundarios de modo que pueda gestionar su propio orden de tabulación con tabIndex:
import flash.display.Sprite;

var container:Sprite = new Sprite();
container.tabChildren = false;

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);
circle1.tabIndex = 1;

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0x00CCFF);
circle2.graphics.drawCircle(120, 40, 40);
circle2.tabIndex = 0;

container.addChild(circle1);
container.addChild(circle2);
Para ver los resultados de este ejemplo, compile y ejecute el archivo. Al seleccionar uno de los círculos, puede presionar el tabulador para intercambiar el objeto de visualización seleccionado (indicado con un rectángulo resaltado en amarillo).

textSnapshot

propiedad 
textSnapshot:flash.text:TextSnapshot  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.



Implementación
    public function get textSnapshot():flash.text:TextSnapshot

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo sólo funciona en el entorno de edición de Flash. Flex no incluye ningún método para añadir texto estático a un archivo. Para preparar el archivo Flash de este ejemplo, añada uno o más campos de texto estático al primer fotograma de una película. A continuación, inserte el script siguiente en el primer fotograma y ejecute el archivo. El resultado será el texto estático añadido:
trace(this.textSnapshot.getText(0, this.textSnapshot.charCount));
Información sobre constructores

DisplayObjectContainer

()Información sobre
public function DisplayObjectContainer()

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La llamada al constructor new DisplayObjectContainer() emite una excepción ArgumentError. No obstante, puede llamar a los constructores para las siguientes subclases de DisplayObjectContainer:

  • new Loader()
  • new Sprite()
  • new MovieClip()

Información sobre métodos

addChild

()método
public function addChild(child:DisplayObject):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

child:DisplayObject — La instancia de DisplayObject que se va a añadir como elemento secundario de esta instancia de DisplayObjectContainer.

Valor devuelto
DisplayObject — La instancia de DisplayObject que se pasa en el parámetro child.

Eventos
added:Event — Se distribuye cuando un objeto de visualización se añade a la lista de visualización.

Emite
ArgumentError — Se emite si el elemento secundario es igual que el elemento principal. También se emite si el que origina la llamada es un elemento secundario (o terciario, etc.) del objeto secundario que se añade.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se configuran dos objetos Sprite denominados container1 y container2. Sprite es un tipo de contenedor de objeto de visualización. El ejemplo llama al método addChild() para configurar la jerarquía de visualización: container1 es un elemento secundario de container2 y los otros dos objetos de visualización, circle1 y circle2, son elementos secundarios de container1. Las llamadas al método trace() muestran el número de objetos secundarios de cada objeto. Observe que los elementos terciarios no se incluyen en el recuento de numChildren:
import flash.display.Sprite;

var container1:Sprite = new Sprite();
var container2:Sprite = new Sprite();

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0x00CCFF);
circle2.graphics.drawCircle(80, 40, 40);

container2.addChild(container1);
container1.addChild(circle1);
container1.addChild(circle2);

trace(container1.numChildren); // 2
trace(container2.numChildren); // 1
trace(circle1.numChildren); // 0
trace(circle2.numChildren); // 0

addChildAt

()método 
public function addChildAt(child:DisplayObject, index:int):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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:

b sobre c sobre a

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

child:DisplayObject — La instancia de DisplayObject que se va a añadir como elemento secundario de esta instancia de DisplayObjectContainer.
 
index:int — Posición de índice en la que se añade el elemento secundario. Si especifica una posición de índice actualmente ocupada, el objeto secundario que hay en dicha posición y todas las posiciones superiores suben una posición en la lista de elementos secundarios.

Valor devuelto
DisplayObject — La instancia de DisplayObject que se pasa en el parámetro child.

Eventos
added:Event — Se distribuye cuando un objeto de visualización se añade a la lista de visualización.

Emite
RangeError — Se emite si la posición de índice no existe en la lista secundaria.
 
ArgumentError — Se emite si el elemento secundario es igual que el elemento principal. También se emite si el que origina la llamada es un elemento secundario (o terciario, etc.) del objeto secundario que se añade.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización container y se añade un objeto de visualización circle1 a la lista de visualización. A continuación, con la llamada a container.addChildAt(circle2, 0), se añade el objeto circle2 a la posición de índice cero (posterior), y se mueve el objeto circle1 a la posición de índice 1:
import flash.display.Sprite;

var container:Sprite = new Sprite();

var circle1:Sprite = new Sprite();
var circle2:Sprite = new Sprite();

container.addChild(circle1);
container.addChildAt(circle2, 0);

trace(container.getChildAt(0) == circle2); // true
trace(container.getChildAt(1) == circle1); // true

areInaccessibleObjectsUnderPoint

()método 
public function areInaccessibleObjectsUnderPoint(point:Point):Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

point:Point — El punto bajo el que se va a comprobar.

Valor devuelto
Booleantrue si el punto contiene objetos de visualización secundarios con restricciones de seguridad.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

El código siguiente crea un contenedor de objeto de visualización denominado container. El bloque de código siguiente utiliza un objeto Loader para cargar un archivo JPEG denominado "test.jpg" de un servidor de archivos remoto. Observe que la propiedad checkPolicyFile del objeto LoaderContext utilizado como parámetro en el método load() está establecido como false. Una vez cargado el archivo, el código llama al método loaded() que, a su vez, llama a container.areInaccessibleObjectsUnderPoint(), que devuelve un valor de true, ya que se asume que el contenido cargado procede de un dominio inaccesible:
import flash.display.Sprite;
import flash.display.Loader;
import flash.system.LoaderContext;
import flash.net.URLRequest;
import flash.events.Event;
import flash.geom.Point;

var container:Sprite = new Sprite();

var urlReq:URLRequest = new URLRequest("http://localhost/RemoteFile.swf");
var ldr:Loader = new Loader();
var context:LoaderContext = new LoaderContext();
context.checkPolicyFile = false;
ldr.load(urlReq, context);

ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded);
ldr.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, urlNotFound);

function loaded(event:Event):void {
    var pt:Point = new Point(1, 1);
    trace(container.areInaccessibleObjectsUnderPoint(pt)); // true
}

function urlNotFound(event:Event):void {
    trace("The URL was not found."); 
}
En este ejemplo, se supone que el archivo SWF que produce este código se carga desde un dominio distinto al del archivo JPEG y que el archivo JPEG cargado ocupa el punto (1, 1).

contains

()método 
public function contains(child:DisplayObject):Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

child:DisplayObject — El objeto secundario que se va a comprobar.

Valor devuelto
Booleantrue si el objeto child es un elemento secundario de DisplayObjectContainer o el propio contenedor; en caso contrario, devuelve false.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se configura un número de objetos Sprite y se añaden algunos a la lista de elementos secundarios de otros. (Un objeto Sprite es un tipo de contenedor de objeto de visualización.) La relación entre los distintos objetos se muestra al llamar al método contains():
import flash.display.Sprite;

var sprite1:Sprite = new Sprite();
var sprite2:Sprite = new Sprite();
var sprite3:Sprite = new Sprite();
var sprite4:Sprite = new Sprite();

sprite1.addChild(sprite2);
sprite2.addChild(sprite3);

trace(sprite1.contains(sprite1)); // true
trace(sprite1.contains(sprite2)); // true
trace(sprite1.contains(sprite3)); // true
trace(sprite1.contains(sprite4)); // false

getChildAt

()método 
public function getChildAt(index:int):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

Parámetros

index:int — Posición de índice del objeto secundario.

Valor devuelto
DisplayObject — El objeto de visualización secundario situado en la posición de índice especificada.

Emite
RangeError — Se emite si el índice no existe en la lista secundaria.
 
SecurityError — Este objeto de visualización secundario pertenece a un entorno limitado de seguridad al que no tiene acceso. Puede evitar esta situación haciendo que la película secundaria llame a Security.allowDomain().

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se añaden tres objetos de visualización a la lista de objetos secundarios del objeto container. Las llamadas al método getChildAt() muestran las posiciones de los objetos secundarios:
import flash.display.Sprite;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
var sprite2:Sprite = new Sprite();
var sprite3:Sprite = new Sprite();

container.addChild(sprite1);
container.addChild(sprite2);
container.addChildAt(sprite3, 0);

trace(container.getChildAt(0) == sprite3); // true
trace(container.getChildAt(1) == sprite1); // true
trace(container.getChildAt(2) == sprite2); // true

getChildByName

()método 
public function getChildByName(name:String):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

name:String — El nombre del elemento secundario que debe devolverse.

Valor devuelto
DisplayObject — El objeto de visualización secundario con el nombre especificado.

Emite
SecurityError — Este objeto de visualización secundario pertenece a un entorno limitado de seguridad al que no tiene acceso. Puede evitar esta situación haciendo que la película secundaria llame al método Security.allowDomain().

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden dos objetos de visualización secundarios. A continuación, el código llama a los métodos getChildByName() y getChildIndex() para devolver la posición de índice del elemento secundario del objeto container que tenga el nombre name "sprite1".
import flash.display.Sprite;
import flash.display.DisplayObject;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
sprite1.name = "sprite1";
var sprite2:Sprite = new Sprite();
sprite2.name = "sprite2";

container.addChild(sprite1);
container.addChild(sprite2);

var target:DisplayObject = container.getChildByName("sprite1"); 
trace(container.getChildIndex(target)); // 0

getChildIndex

()método 
public function getChildIndex(child:DisplayObject):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

Parámetros

child:DisplayObject — La instancia de DisplayObject que se va a identificar.

Valor devuelto
int — Posición de índice del objeto de visualización secundario que debe identificarse.

Emite
ArgumentError — Se emite si el parámetro secundario no es un elemento secundario de este objeto.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden dos objetos de visualización secundarios. A continuación, el código llama a los métodos getChildByName() y getChildIndex() para devolver la posición de índice del elemento secundario del objeto container que tenga el nombre name "sprite1".
import flash.display.Sprite;
import flash.display.DisplayObject;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
sprite1.name = "sprite1";
var sprite2:Sprite = new Sprite();
sprite2.name = "sprite2";

container.addChild(sprite1);
container.addChild(sprite2);

var target:DisplayObject = container.getChildByName("sprite1"); 
trace(container.getChildIndex(target)); // 0

getObjectsUnderPoint

()método 
public function getObjectsUnderPoint(point:Point):Array

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

point:Point — El punto bajo el que se va a comprobar.

Valor devuelto
Array — Un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden dos objetos de visualización secundarios solapados. El código llama a continuación a getObjectsUnderPoint() dos veces (primero con un punto que toca sólo un objeto y después con un punto donde los objetos se solapan) y la propiedad length (longitud) del conjunto de devolución muestra el número de objetos en cada punto del contenedor:
import flash.display.Sprite;
import flash.geom.Point;

var container:Sprite = new Sprite();

var square1:Sprite = new Sprite();
square1.graphics.beginFill(0xFFCC00);
square1.graphics.drawRect(0, 0, 40, 40);

var square2:Sprite = new Sprite();
square2.graphics.beginFill(0x00CCFF);
square2.graphics.drawRect(20, 0, 30, 40);

container.addChild(square1);
container.addChild(square2);

var pt:Point = new Point(10, 20);
var objects:Array = container.getObjectsUnderPoint(pt); 
trace(objects.length); // 1

pt = new Point(35, 20);
objects = container.getObjectsUnderPoint(pt);
trace(objects.length);  // 2

removeChild

()método 
public function removeChild(child:DisplayObject):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

child:DisplayObject — La instancia de DisplayObject que se va a eliminar.

Valor devuelto
DisplayObject — La instancia de DisplayObject que se pasa en el parámetro child.

Emite
ArgumentError — Se emite si el parámetro secundario no es un elemento secundario de este objeto.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden dos objetos de visualización secundarios. Se añade un detector de eventos al objeto container para que cuando el usuario haga clic en un objeto secundario del contenedor, el método removeChild() lo elimine de la lista de elementos secundarios del contendor:
 
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.events.MouseEvent;

var container:Sprite = new Sprite();
addChild(container);

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0x00CCFF);
circle2.graphics.drawCircle(120, 40, 40);

container.addChild(circle1);
container.addChild(circle2);

container.addEventListener(MouseEvent.CLICK, clicked);

function clicked(event:MouseEvent):void {
    container.removeChild(DisplayObject(event.target)); 
}

removeChildAt

()método 
public function removeChildAt(index:int):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

index:int — El índice secundario de la instancia de DisplayObject que se va a eliminar.

Valor devuelto
DisplayObject — La instancia de DisplayObject que se eliminó.

Emite
SecurityError — El objeto de visualización secundario pertenece a un entorno limitado de seguridad al que no tiene acceso el código que realiza la llamada. Puede evitar esta situación haciendo que la película secundaria llame al método Security.allowDomain().
 
RangeError — Se emite si el índice no existe en la lista secundaria.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden dos objetos de visualización secundarios. A continuación, el código muestra que cuando se llama al método removeChildAt() para eliminar el elemento secundario de la posición de índice más baja (0), los demás objetos secundarios de la lista se desplazan una posición:
import flash.display.Sprite;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
sprite1.name = "sprite1";
var sprite2:Sprite = new Sprite();
sprite2.name = "sprite2";

container.addChild(sprite1);
container.addChild(sprite2);

trace(container.numChildren) // 2
container.removeChildAt(0); 
trace(container.numChildren) // 1
trace(container.getChildAt(0).name); // sprite2

removeChildren

()método 
public function removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.0, Flash Player 11

Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer. La propiedad parent del elemento secundario eliminado se establece como null y los objetos se recogen como datos innecesarios si no hay ninguna otra referencia al elemento secundario.

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

beginIndex:int (default = 0) — La posición inicial. Un valor inferior a 0 emite un error RangeError.
 
endIndex:int (default = 0x7fffffff) — La posición final. Un valor inferior a 0 emite un error RangeError.


Emite
RangeError — Se emite si las posiciones beginIndex o endIndex no existen en la lista secundaria.

setChildIndex

()método 
public function setChildIndex(child:DisplayObject, index:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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:

c sobre b sobre a

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:

c sobre a sobre b

Parámetros

child:DisplayObject — La instancia de DisplayObject secundaria para la que desea cambiar el número de índice.
 
index:int — El número de índice resultante para el objeto de visualización child.


Emite
RangeError — Se emite si el índice no existe en la lista secundaria.
 
ArgumentError — Se emite si el parámetro secundario no es un elemento secundario de este objeto.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container y se le añaden tres objetos de visualización secundarios ligeramente solapados. Cuando el usuario hace clic en alguno de estos objetos, el método clicked() llama al método setChildIndex() para subirlo a la posición más alta de la lista de objetos secundarios del objeto container:
import flash.display.Sprite;
import flash.events.MouseEvent;

var container:Sprite = new Sprite();
addChild(container);

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFF0000);
circle1.graphics.drawCircle(40, 40, 40);
circle1.addEventListener(MouseEvent.CLICK, clicked);
 
var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0x00FF00);
circle2.graphics.drawCircle(100, 40, 40);
circle2.addEventListener(MouseEvent.CLICK, clicked);
 
var circle3:Sprite = new Sprite();
circle3.graphics.beginFill(0x0000FF);
circle3.graphics.drawCircle(70, 80, 40);
circle3.addEventListener(MouseEvent.CLICK, clicked);
 
container.addChild(circle1);
container.addChild(circle2);
container.addChild(circle3);
addChild(container);
 
function clicked(event:MouseEvent):void {
    var circle:Sprite = Sprite(event.target);
    var topPosition:uint = container.numChildren - 1;
    container.setChildIndex(circle, topPosition);
}

stopAllMovieClips

()método 
public function stopAllMovieClips():void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.8, Flash Player 11.8

Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto.

No se tienen en cuenta los objetos de visualización secundarios que pertenecen a un entorno limitado de seguridad al que no tiene acceso el código en ejecución.

Nota: no se detendrá la transmisión de reproducción de medios controlada a través de un objeto NetStream.

swapChildren

()método 
public function swapChildren(child1:DisplayObject, child2:DisplayObject):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

child1:DisplayObject — El primer objeto secundario.
 
child2:DisplayObject — El segundo objeto secundario.


Emite
ArgumentError — Se emite si algún parámetro secundario no es un elemento secundario de este objeto.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container, se añaden a continuación dos objetos de visualización secundarios y después se muestra el efecto de una llamada al método swapChildren():
import flash.display.Sprite;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
sprite1.name = "sprite1";
var sprite2:Sprite = new Sprite();
sprite2.name = "sprite2";

container.addChild(sprite1);
container.addChild(sprite2);

trace(container.getChildAt(0).name); // sprite1
trace(container.getChildAt(1).name); // sprite2

container.swapChildren(sprite1, sprite2);

trace(container.getChildAt(0).name); // sprite2
trace(container.getChildAt(1).name); // sprite1

swapChildrenAt

()método 
public function swapChildrenAt(index1:int, index2:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

index1:int — Posición de índice del primer objeto secundario.
 
index2:int — Posición de índice del segundo objeto secundario.


Emite
RangeError — Si alguno de los índices no existe en la lista secundaria.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un contenedor de objeto de visualización denominado container, se añaden a continuación tres objetos de visualización secundarios y después se muestra cómo una llamada al método swapChildrenAt() reorganiza la lista de elementos secundarios del contenedor:
import flash.display.Sprite;

var container:Sprite = new Sprite();

var sprite1:Sprite = new Sprite();
sprite1.name = "sprite1";
var sprite2:Sprite = new Sprite();
sprite2.name = "sprite2";
var sprite3:Sprite = new Sprite();
sprite3.name = "sprite3";

container.addChild(sprite1);
container.addChild(sprite2);
container.addChild(sprite3);

trace(container.getChildAt(0).name); // sprite1
trace(container.getChildAt(1).name); // sprite2
trace(container.getChildAt(2).name); // sprite3

container.swapChildrenAt(0, 2);

trace(container.getChildAt(0).name); // sprite3
trace(container.getChildAt(1).name); // sprite2
trace(container.getChildAt(2).name); // sprite1
DisplayObjectContainerExample.as

En el ejemplo siguiente, se utiliza la clase DisplayObjectContainerExample para crear cinco cuadrados de color naranja de forma consecutiva. Esta tarea se consigue siguiendo los pasos siguientes:
  1. El constructor llama al método configureAssets().
  2. El método configureAssets() crea los objetos Sprite child y lastChild.
  3. Un bucle for crea los cinco cuadrados de color naranja y los coloca uno detrás de otro.
  4. Cuando se crea un objeto CustomSprite, su constructor llama al método draw() del objeto CustomSprite que crea un cuadrado de 50 x 50 píxeles mediante la llamada a los métodos beginFill(), drawRect() y endFill() de la clase Graphics. El método addChild() añade cada cuadrado a la lista de visualización.
package {
    import flash.display.DisplayObject;
    import flash.display.Sprite;

    public class DisplayObjectContainerExample extends Sprite {
        private var gutter:uint     = 5;
        private var childCount:uint = 5;

        public function DisplayObjectContainerExample() {
            configureAssets();
        }

        private function configureAssets():void {
            var child:Sprite = new CustomSprite();
            var lastChild:Sprite = child;
            for (var i:uint = 1; i <= childCount; i++) {
                child = new CustomSprite();
                child.x = lastChild.x + lastChild.width + gutter;
                addChild(child);
                lastChild = child;
            }
        }
    }
}

import flash.display.Sprite;

class CustomSprite extends Sprite {
    private var size:uint = 50;
    private var bgColor:uint = 0xFFCC00;

    public function CustomSprite() {
        draw(size, size);
    }

    private function draw(w:uint, h:uint):void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.