Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
flash.display 

DisplayObjectContainer  - AS3

Packagesx

Niveau supérieur
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

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques
Packageflash.display
Classepublic class DisplayObjectContainer
HéritageDisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sous-classes Loader, Sprite, Stage, TextLine

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

La classe DisplayObjectContainer est la classe de base de tous les objets susceptibles de servir de conteneurs d’objet d’affichage dans la liste d’affichage. La liste d’affichage gère tous les objets affichés dans les moteurs d’exécution de Flash. La classe DisplayObjectContainer permet d’organiser les objets d’affichage dans la liste d’affichage. Chaque objet DisplayObjectContainer possède sa propre liste d’enfants, qui organise l’ordre Z des objets. L’ordre z correspond à l’ordre d’empilement du premier plan vers l’arrière-plan qui détermine l’objet dessiné au premier plan, l’objet dessiné derrière lui, etc.

DisplayObject est une classe de base abstraite. De ce fait, il est impossible de l’appeler directement. Appeler new DisplayObject() renvoie une exception ArgumentError.

La classe DisplayObjectContainer est une classe de base abstraite destinée à tous les objets pouvant contenir des objets enfant. Il est impossible de l’instancier directement. Appeler le constructeur new DisplayObjectContainer() renvoie une exception ArgumentError.

Pour plus d’informations, voir le chapitre « Programmation de l’affichage » du Guide du développeur d’ActionScript 3.0.

Consulter les exemples

Plus d’exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage.
DisplayObject
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l’objet spécifié.
DisplayObject
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.
DisplayObject
 InheritedblendShader : Shader
[écriture seule] Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true.
DisplayObject
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcontextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick.
InteractiveObject
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.
DisplayObject
 InheritedfocusRect : Object
Spécifie si l’objet affiche un rectangle de focus.
InteractiveObject
 Inheritedheight : Number
Indique la hauteur de l’objet d’affichage, en pixels.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage.
DisplayObject
 Inheritedmask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié.
DisplayObject
 InheritedmetaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject.
DisplayObject
  mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur.
InteractiveObject
 InheritedmouseX : Number
[lecture seule] Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.
DisplayObject
 InheritedmouseY : Number
[lecture seule] Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.
DisplayObject
 Inheritedname : String
Indique le nom d’occurrence de DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.
InteractiveObject
  numChildren : int
[lecture seule] Renvoie le nombre d’enfants de l’objet.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[lecture seule] Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.
DisplayObject
 Inheritedroot : DisplayObject
[lecture seule] Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier.
DisplayObject
 Inheritedrotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine.
DisplayObject
 InheritedrotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.
DisplayObject
 Inheritedscale9Grid : Rectangle
Grille de mise à l’échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.
DisplayObject
 InheritedscaleY : Number
Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.
DisplayObject
 InheritedscaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement.
DisplayObject
 InheritedscrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage.
DisplayObject
 Inherited    softKeyboard : String
Contrôle l’aspect du clavier logiciel.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS)
InteractiveObject
 Inheritedstage : Stage
[lecture seule] Scène de l’objet d’affichage.
DisplayObject
  tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation.
InteractiveObject
 InheritedtabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF.
InteractiveObject
  textSnapshot : flash.text:TextSnapshot
[lecture seule] Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage.
DisplayObject
 Inheritedvisible : Boolean
Indique si l’objet d’affichage est visible ou non.
DisplayObject
 Inheritedwidth : Number
Indique la largeur de l’objet d’affichage, en pixels.
DisplayObject
 Inheritedx : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
 Inheritedy : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
 Inheritedz : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent.
DisplayObject
Méthodes publiques
 MéthodeDéfini par
  
L’appel du constructeur DisplayObjectContainer() renvoie une exception ArgumentError.
DisplayObjectContainer
  
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.
DisplayObjectContainer
  
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
  
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié.
DisplayObjectContainer
  
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle.
DisplayObjectContainer
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace.
DisplayObject
  
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.
DisplayObjectContainer
  
Renvoie l’objet d’affichage enfant portant le nom spécifié.
DisplayObjectContainer
  
Renvoie la position d’index d’une occurrence enfant de DisplayObject.
DisplayObjectContainer
  
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.
DisplayObject
 Inherited
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).
DisplayObject
 Inherited
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).
DisplayObject
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y.
DisplayObject
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).
DisplayObject
 Inherited
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
  
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer.
DisplayObjectContainer
  
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Affiche un clavier virtuel.
InteractiveObject
  
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage.
DisplayObjectContainer
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine.
DisplayObjectContainer
  
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés.
DisplayObjectContainer
  
swapChildrenAt(index1:int, index2:int):void
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants.
DisplayObjectContainer
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 InheritedDistribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.DisplayObject
 InheritedEnvoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage.DisplayObject
 InheritedDistribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.InteractiveObject
 InheritedDistribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel.InteractiveObject
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true.InteractiveObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours.DisplayObject
 InheritedDistribué après la prise de focus par un objet d’affichage.InteractiveObject
 InheritedDistribué après la perte de focus par un objet d’affichage.InteractiveObject
 Inherited[événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image.DisplayObject
 InheritedDistribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles.InteractiveObject
 InheritedDistribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire).InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter).InteractiveObject
 InheritedDistribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu).InteractiveObject
 InheritedDistribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedCet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.InteractiveObject
 InheritedDistribué lorsque l’utilisateur appuie sur une touche.InteractiveObject
 InheritedDistribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.InteractiveObject
 InheritedDistribué lorsque l’utilisateur relâche une touche.InteractiveObject
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage.InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.InteractiveObject
 InheritedDistribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu’une opération glisser sort des limites.InteractiveObject
 InheritedDistribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.InteractiveObject
 InheritedDistribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran.InteractiveObject
 Inherited
    proximityEnd
Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran.InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité.InteractiveObject
 Inherited
    proximityOut
Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran.InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran).InteractiveObject
 InheritedDistribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.DisplayObject
 InheritedDistribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée.DisplayObject
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel.InteractiveObject
 InheritedDistribué immédiatement après l’affichage du clavier logiciel.InteractiveObject
 InheritedDistribué immédiatement avant l’affichage du clavier logiciel.InteractiveObject
 InheritedDistribué immédiatement après la disparition du clavier logiciel.InteractiveObject
 InheritedDistribué lorsque la valeur de l’indicateur tabChildren de l’objet change.InteractiveObject
 InheritedDistribué lorsque l’indicateur tabEnabled de l’objet change.InteractiveObject
 InheritedDistribué lorsque la valeur de la propriété tabIndex de l’objet change.InteractiveObject
 InheritedDistribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte.InteractiveObject
 InheritedDistribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact.InteractiveObject
 InheritedDistribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet).InteractiveObject
 InheritedDistribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).InteractiveObject
 InheritedDistribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire).InteractiveObject
Détails de la propriété

mouseChildren

propriété
mouseChildren:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. Si tel est le cas, un utilisateur peut manipuler l’objet à l’aide de la souris ou du périphérique de saisie utilisateur. La valeur par défaut est true.

Cette propriété s’avère utile lorsque vous créez un bouton avec une occurrence de la classe Sprite (au lieu d’utiliser la classe SimpleButton). Si vous utilisez une occurrence de Sprite pour créer un bouton, vous pouvez le décorer à l’aide de la méthode addChild() pour ajouter d’autres occurrences de Sprite. Ce processus risque d’associer un comportement imprévu aux événements de souris, car les occurrences de Sprite ajoutées en tant qu’enfants peuvent devenir l’objet cible d’un événement de souris alors que vous vous attendiez à ce que ce dernier corresponde à l’occurrence parent. Pour vous assurer que l’occurrence parent serve d’objet cible pour les événements de souris, vous pouvez régler la propriété mouseChildren de l’occurrence parent sur false.

Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.



Implémentation
    public function get mouseChildren():Boolean
    public function set mouseChildren(value:Boolean):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant définit un objet Sprite (un type de conteneur d’objet d’affichage) appelé container et indique que lorsque vous définissez sa propriété mouseChildren sur false, la cible de l’événementmouseClick devient l’objet container et non pas l’un de ses objets enfant :
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

propriété 
numChildren:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie le nombre d’enfants de l’objet.



Implémentation
    public function get numChildren():int

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant définit deux objets Sprite appelés container1 et container2. Un Sprite est un type de conteneur d’objet d’affichage. L’exemple appelle la méthode addChild() pour configurer la hiérarchie d’affichage : container1 est un enfant de container2, tandis que deux autres objets d’affichage, circle1 et circle2, sont des enfants de container1. Les appels à la méthode trace() affichent le nombre d’enfants de chaque objet. Tenez compte du fait que les petits-enfants ne sont pas inclus dans le décompte 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

propriété 
tabChildren:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Détermine si les enfants de l’objet prennent ou non en charge la tabulation. Active ou désactive la sélection des enfants de l’objet avec la touche de tabulation. La valeur par défaut est true.

Remarque : n’utilisez pas cette propriété tabChildren avec Flex. Utilisez plutôt la propriété mx.core.UIComponent.hasFocusableChildren.



Implémentation
    public function get tabChildren():Boolean
    public function set tabChildren(value:Boolean):void

Valeur émise
IllegalOperationError — Le fait d’appeler cette propriété à partir de l’objet Stage renvoie une exception, car il ne met pas en œuvre cette propriété.

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée un conteneur d’objet d’affichage, container1, et ajoute deux objets d’affichage circle1 et circle2 à sa liste d’affichage. Cet exemple définit tabChildren sur false pour les enfants de façon à pouvoir gérer son propre ordre de tabulation à l’aide de la propriété 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);
Pour afficher les résultats de cet exemple, compilez et exécutez le fichier. Lorsque vous sélectionnez l’un de ces cercles, vous pouvez appuyer sur la touche de tabulation pour déplacer le focus vers un autre objet d’affichage (indiqué par un rectangle de sélection jaune).

textSnapshot

propriété 
textSnapshot:flash.text:TextSnapshot  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer.



Implémentation
    public function get textSnapshot():flash.text:TextSnapshot

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant fonctionne uniquement dans l’environnement de création de Flash. Flex ne permet pas d’ajouter du texte statique à un fichier. Pour préparer le fichier Flash dans cet exemple, ajoutez un ou plusieurs champs de texte statiques dans la première image d’un clip. Ensuite, insérez le script suivant dans la première image et exécutez le fichier. Ceci renvoie le texte statique que vous avez ajouté :
trace(this.textSnapshot.getText(0, this.textSnapshot.charCount));
Détails du constructeur

DisplayObjectContainer

()Constructeur
public function DisplayObjectContainer()

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

L’appel du constructeur new DisplayObjectContainer() renvoie une exception ArgumentError. Vous pouvez cependant appeler des constructeurs pour les sous-classes suivantes de DisplayObjectContainer :

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

Détails de la méthode

addChild

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. L’enfant est ajouté devant (par-dessus) tous les autres enfants dans cette occurrence de DisplayObjectContainer (pour ajouter un enfant à une position d’index spécifique, utilisez la méthode addChildAt()).

Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.

Remarque : la commande stage.addChild() risque de poser certains problèmes avec un fichier SWF publié, notamment des problèmes de sécurité et des conflits avec d’autres fichiers SWF chargés. Il n’existe qu’une seule scène au sein d’une occurrence du moteur d’exécution de Flash, quel que soit le nombre de fichiers SWF que vous chargez dans le moteur d’exécution. Ainsi, en règle générale, les objets ne devraient pas être ajoutés à la scène directement. Le seul objet que la scène devrait contenir est l’objet racine. Créez un objet DisplayObjectContainer qui contienne tous les éléments de la liste d’affichage. Le cas échéant, ajoutez ensuite cette occurrence de DisplayObjectContainer sur la scène.

Paramètres

child:DisplayObject — Occurrence DisplayObject à ajouter en tant qu’enfant à cette occurrence DisplayObjectContainer.

Valeur renvoyée
DisplayObject — Occurrence DisplayObject transmise au paramètre child.

Evénements
added:Event — Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.

Valeur émise
ArgumentError — Renvoie une exception si l’enfant et le parent sont identiques. Renvoie également une exception si l’appelant est un enfant (ou petit-enfant, etc.) de l’enfant qui est en cours d’ajout.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant définit deux objets Sprite appelés container1 et container2. Un Sprite est un type de conteneur d’objet d’affichage. L’exemple appelle la méthode addChild() pour configurer la hiérarchie d’affichage : container1 est un enfant de container2, tandis que deux autres objets d’affichage, circle1 et circle2, sont des enfants de container1. Les appels à la méthode trace() affichent le nombre d’enfants de chaque objet. Tenez compte du fait que les petits-enfants ne sont pas inclus dans le décompte 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éthode 
public function addChildAt(child:DisplayObject, index:int):DisplayObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. L’enfant est placé à la position d’index spécifiée. La position d’index 0 représente la fin (le bas) de la liste d’affichage pour cet objet DisplayObjectContainer.

Ainsi, l’exemple suivant illustre trois objets d’affichage appelés a, b et c, qui occupent respectivement les positions d’index 0, 2 et 1 :

b sur c sur a

Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.

Paramètres

child:DisplayObject — Occurrence DisplayObject à ajouter en tant qu’enfant à cette occurrence DisplayObjectContainer.
 
index:int — Position d’index à laquelle l’enfant est ajouté. Si vous spécifiez une position d’index actuellement occupée, l’objet enfant associé à cette position et toutes les positions supérieures sont décalés d’une position vers le haut dans la liste d’enfants.

Valeur renvoyée
DisplayObject — Occurrence DisplayObject transmise au paramètre child.

Evénements
added:Event — Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.

Valeur émise
RangeError — Renvoie une exception si la position d’index n’existe pas dans la liste d’enfants.
 
ArgumentError — Renvoie une exception si l’enfant et le parent sont identiques. Renvoie également une exception si l’appelant est un enfant (ou petit-enfant, etc.) de l’enfant qui est en cours d’ajout.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage, container, et ajoute un objet d’affichage circle1 à sa liste d’affichage. Ensuite, en appelant container.addChildAt(circle2, 0), il ajoute l’objet circle2 à la position d’index zéro (arrière) et déplace l’objet circle1 vers la position d’index 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éthode 
public function areInaccessibleObjectsUnderPoint(point:Point):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point point spécifié. Par défaut, le contenu d’un domaine ne peut pas accéder aux objets d’un autre domaine, à moins d’y être autorisé via un appel de la méthode Security.allowDomain(). Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Le paramètre point est exprimé dans l’espace de coordonnées de la scène, qui risque d’être différent de l’espace de coordonnées du conteneur d’objet d’affichage (à moins que ce dernier ne corresponde à la scène). Vous pouvez utiliser les méthodes globalToLocal() et localToGlobal() pour passer d’un espace de coordonnées à l’autre.

Paramètres

point:Point — Le point sous lequel sont extraits les objets.

Valeur renvoyée
Booleantrue si le point contient des objets d’affichage enfant associés à des restrictions de sécurité.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Le code suivant crée un conteneur d’objet d’affichage appelé container. Le bloc de code suivant a recours à un objet Loader pour charger un fichier JPEG appelé « test.jpg » à partir d’un serveur de fichiers distant. Tenez compte du fait que la propriété checkPolicyFile de l’objet LoaderContext utilisé en tant que paramètre dans la méthode load() est défini sur false. Une fois le fichier chargé, le code appelle la méthode loaded(), qui en retour appelle container.areInaccessibleObjectsUnderPoint(), qui renvoie la valeur true car le contenu chargé est considéré comme provenant d’un domaine inaccessible :
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."); 
}
Cet exemple suppose que le fichier SWF produit par ce code est chargé à partir d’un domaine différent de celui du fichier JPEG, et que le fichier JPEG chargé occupe le point (1, 1).

contains

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. La recherche comprend la liste d’affichage entière, y compris cette occurrence de DisplayObjectContainer. Les petits-enfants, les arrière-petits-enfants, et ainsi de suite renvoient chacun la valeur true.

Paramètres

child:DisplayObject — L’objet enfant à tester.

Valeur renvoyée
Booleantrue if the child object is a child of the DisplayObjectContainer or the container itself; otherwise false.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant définit plusieurs objets Sprite et en ajoute une partie à la liste d’enfants des autres (un objet Sprite est un type de conteneur d’objet d’affichage). La relation entre les différents objets s’affiche en appelant la méthode 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éthode 
public function getChildAt(index:int):DisplayObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.

Paramètres

index:int — Position d’index de l’objet enfant.

Valeur renvoyée
DisplayObject — L’objet d’affichage enfant qui occupe la position d’index spécifiée.

Valeur émise
RangeError — Renvoie une exception si l’index n’existe pas dans la liste d’enfants.
 
SecurityError — Cet objet d’affichage enfant appartient à un sandbox auquel vous n’avez pas accès. Pour éviter ce cas de figure, faites en sorte que l’animation enfant appelle la méthode Security.allowDomain().

Plus d’exemples

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute trois objets d’affichage enfant à la liste d’enfants de l’objet container. Les appels à la méthode getChildAt() révèlent ensuite les positions des objets enfant :
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éthode 
public function getChildByName(name:String):DisplayObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie l’objet d’affichage enfant portant le nom spécifié. Si plusieurs objets d’affichage enfant portent le nom spécifié, la méthode renvoie le premier objet de la liste d’enfants.

La méthode getChildAt() est plus rapide que la méthode getChildByName(). La méthode getChildAt() accède à un enfant à partir d’un tableau en mémoire cache, tandis que la méthode getChildByName() doit parcourir une liste liée pour accéder à l’enfant.

Paramètres

name:String — Nom de l’enfant à renvoyer.

Valeur renvoyée
DisplayObject — Objet d’affichage enfant portant le nom spécifié.

Valeur émise
SecurityError — Cet objet d’affichage enfant appartient à un sandbox auquel vous n’avez pas accès. Pour éviter ce cas de figure, faites en sorte que l’animation enfant appelle la méthode Security.allowDomain().

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute deux objets d’affichage enfant au conteneur. Ensuite, le code appelle les méthodes getChildByName() et getChildIndex() pour renvoyer la position d’index de l’enfant de l’objet container avec le paramètre 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éthode 
public function getChildIndex(child:DisplayObject):int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la position d’index d’une occurrence child de DisplayObject.

Paramètres

child:DisplayObject — Instance de DisplayObject à identifier.

Valeur renvoyée
int — Position d’index de l’objet d’affichage enfant à identifier.

Valeur émise
ArgumentError — Renvoie une exception si le paramètre enfant n’est pas un enfant de cet objet.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute deux objets d’affichage enfant au conteneur. Ensuite, le code appelle les méthodes getChildByName() et getChildIndex() pour renvoyer la position d’index de l’enfant de l’objet container avec le paramètre 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éthode 
public function getObjectsUnderPoint(point:Point):Array

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. Tout objet enfant auquel il est impossible d’accéder pour des raisons de sécurité est omis du tableau renvoyé. Pour vérifier si cette restriction de sécurité affecte le tableau renvoyé, appelez la méthode areInaccessibleObjectsUnderPoint().

Le paramètre point est exprimé dans l’espace de coordonnées de la scène, qui risque d’être différent de l’espace de coordonnées du conteneur d’objet d’affichage (à moins que ce dernier ne corresponde à la scène). Vous pouvez utiliser les méthodes globalToLocal() et localToGlobal() pour passer d’un espace de coordonnées à l’autre.

Paramètres

point:Point — Le point sous lequel sont extraits les objets.

Valeur renvoyée
Array — Tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de cette occurrence de DisplayObjectContainer.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute deux objets d’affichage enfant qui se chevauchent au conteneur. Ensuite le code appelle deux fois getObjectsUnderPoint(). Une première fois avec un point qui ne touche qu’un seul objet, puis à l’aide d’un point où les objets se chevauchent. Enfin, le paramètre length du tableau renvoyé affiche le nombre d’objets de tous les points du conteneur :
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éthode 
public function removeChild(child:DisplayObject):DisplayObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Supprime l’occurrence child de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. La propriété parent de l’enfant supprimé est réglée sur null et l’objet est nettoyé s’il n’existe aucune autre référence à l’enfant. Les positions d’index de tout objet d’affichage placé au-dessus de l’enfant dans DisplayObjectContainer sont diminuées d’une unité.

Le processus de nettoyage de la mémoire réaffecte l’espace mémoire non utilisé. Lorsqu’une variable ou un objet n’est plus référencé ou stocké de façon active, le nettoyeur de mémoire vide toutes ses références en mémoire qui ne sont plus utilisées.

Paramètres

child:DisplayObject — Occurrence de DisplayObject à supprimer.

Valeur renvoyée
DisplayObject — Occurrence DisplayObject transmise au paramètre child.

Valeur émise
ArgumentError — Renvoie une exception si le paramètre enfant n’est pas un enfant de cet objet.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute deux objets d’affichage enfant au conteneur. Un écouteur d’événement est ajouté à l’objet container, de façon à ce que lorsque l’utilisateur clique sur une objet enfant du conteneur, la méthode removeChild() l’enfant sur lequel l’utilisateur a cliqué dans la liste d’enfants du conteneur :
 
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éthode 
public function removeChildAt(index:int):DisplayObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. La propriété parent de l’enfant supprimé est réglée sur null et l’objet est nettoyé s’il n’existe aucune autre référence à l’enfant. Les positions d’index de tout objet d’affichage placé au-dessus de l’enfant dans DisplayObjectContainer sont diminuées d’une unité.

Le processus de nettoyage de la mémoire réaffecte l’espace mémoire non utilisé. Lorsqu’une variable ou un objet n’est plus référencé ou stocké de façon active, le nettoyeur de mémoire vide toutes ses références en mémoire qui ne sont plus utilisées.

Paramètres

index:int — Index enfant de l’objet DisplayObject à supprimer.

Valeur renvoyée
DisplayObject — Occurrence de DisplayObject supprimée.

Valeur émise
SecurityError — Cet objet d’affichage enfant appartient à un sandbox auquel l’objet appelant n’a pas accès. Pour éviter ce cas de figure, faites en sorte que l’animation enfant appelle la méthode Security.allowDomain().
 
RangeError — Renvoie une exception si l’index n’existe pas dans la liste d’enfants.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute deux objets d’affichage enfant au conteneur. Vous pouvez ensuite constater que lorsque le code appelle la méthode removeChildAt() pour supprimer l’enfant à la position d’index la plus basse (0), tout autre objet enfant descend d’un niveau dans la liste :
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éthode 
public function removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 3.0, Flash Player 11

Supprime toutes les occurrences child de l’objet DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. La propriété parent des enfants supprimés est définie sur null et les objets sont nettoyés s’il n’existe aucune autre référence aux enfants.

Le processus de nettoyage de la mémoire réaffecte l’espace mémoire non utilisé. Lorsqu’une variable ou un objet n’est plus référencé ou stocké de façon active, le nettoyeur de mémoire vide toutes ses références en mémoire qui ne sont plus utilisées.

Paramètres

beginIndex:int (default = 0) — Position de début. Une valeur inférieure à 0 renvoie RangeError.
 
endIndex:int (default = 0x7fffffff) — Position de fin. Une valeur inférieure à 0 renvoie RangeError.


Valeur émise
RangeError — Renvoyé si la position beginIndex ou endIndex n’existe pas dans la liste enfant.

setChildIndex

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. L’ordre des objets enfant est alors affecté. Ainsi, l’exemple suivant illustre trois objets d’affichage appelés a, b et c, qui occupent respectivement les positions d’index 0, 1 et 2 :

c sur b sur a

Lorsque vous utilisez la méthode setChildIndex() et spécifiez une position d’index déjà occupée, les seules positions qui changent sont celles situées entre l’ancienne et la nouvelle position de l’objet d’affichage. Toutes les autres positions restent identiques. Si un enfant est déplacé sur un index INFERIEUR à son index actuel, tous les enfants situés entre les deux sont AUGMENTES de 1 pour leur référence d’index. Si un enfant est déplacé sur un index SUPERIEUR à son index actuel, tous les enfants situés entre les deux sont DIMINUES de 1 pour leur référence d’index. Par exemple, si le conteneur d’objet d’affichage de l’exemple précédent s’appelle container, vous pouvez permuter la position des objets d’affichage a et b en appelant le code suivant :

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

Ce code entraîne la réorganisation suivante des objets :

c sur a sur b

Paramètres

child:DisplayObject — Occurrence enfant de DisplayObject dont vous voulez modifier le numéro d’index.
 
index:int — Nouveau numéro d’index de l’objet d’affichage child.


Valeur émise
RangeError — Renvoie une exception si l’index n’existe pas dans la liste d’enfants.
 
ArgumentError — Renvoie une exception si le paramètre enfant n’est pas un enfant de cet objet.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute trois objets d’affichage enfant, qui se chevauchent légèrement, au conteneur. Lorsque l’utilisateur clique sur l’un de ces objets, la méthode clicked() appelle la méthode setChildIndex() pour déplacer l’objet cliqué vers la position la plus haute de la liste enfant de l’objet 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éthode 
public function stopAllMovieClips():void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 3.8, Flash Player 11.8

Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine.

Les objets d’affichage enfants appartenant à un sandbox auquel le code en cours d’exécution n’a pas accès ne sont pas pris en compte.

Remarque : la lecture en continu contrôlée par un objet NetStream ne sera pas arrêtée.

swapChildren

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Intervertit l’ordre z (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. Tous les autres objets enfant du conteneur d’objet d’affichage conservent leur position d’index.

Paramètres

child1:DisplayObject — Premier objet enfant.
 
child2:DisplayObject — Second objet enfant.


Valeur émise
ArgumentError — Renvoie une exception si l’un des deux paramètres enfant n’est pas un enfant de cet objet.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objets d’affichage appelé container, puis ajoute deux objets d’affichage enfant au conteneur et enfin, indique l’effet d’un appel à la méthode 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éthode 
public function swapChildrenAt(index1:int, index2:int):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Intervertit l’ordre z (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. Tous les autres objets enfant du conteneur d’objet d’affichage conservent leur position d’index.

Paramètres

index1:int — Position d’index du premier objet enfant.
 
index2:int — Position d’index du second objet enfant.


Valeur émise
RangeError — Si l’un ou l’autre des index n’existe pas dans la liste d’enfants.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un conteneur d’objet d’affichage appelé container, puis ajoute trois objets d’affichage enfant au conteneur et enfin indique comment un appel à la méthode swapChildrenAt() modifie l’ordre de la liste d’enfants du conteneur de l’objet d’affichage :
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

L’exemple suivant exploite la classe DisplayObjectContainerExample pour créer cinq carrés orange les uns à la suite des autres. Pour ce faire, procédez comme suit :
  1. Le constructeur appelle la méthode configureAssets().
  2. La méthode configureAssets() crée des objets Sprite child et lastChild.
  3. Une boucle for crée les cinq carrés orange et les place les uns à la suite des autres.
  4. Lorsqu’un objet CustomSprite est créé, son constructeur appelle la méthode draw() de l’objet CustomSprite, qui crée un carré de 50 x 50 pixels en appelant les méthodes beginFill(), drawRect() et endFill() de la classe Graphics. La méthode addChild() place les carrés ainsi créé dans la liste d’affichage.
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 ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.