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
fl.controls 

ComboBox  - AS3 Flash

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
Packagefl.controls
Classepublic class ComboBox
HéritageComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implémente IFocusManagerComponent

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

Le composant ComboBox contient une liste déroulante dans laquelle l’utilisateur ne peut sélectionner qu’une valeur. Son fonctionnement est proche de celui de l’élément de formulaire SELECT en HTML. Le composant ComboBox peut être modifié, auquel cas l’utilisateur peut taper des entrées absentes de la liste dans la partie TextInput du composant ComboBox.

Consulter les exemples

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
 InheritedbuttonMode : Boolean
Spécifie le mode de bouton du sprite.
Sprite
 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
  dataProvider : DataProvider
Lit ou définit le modèle de données de la liste d’éléments à afficher.
ComboBox
 InheriteddoubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick.
InteractiveObject
  dropdown : List
[lecture seule] Récupère une référence au composant List contenu dans le composant ComboBox.
ComboBox
  dropdownWidth : Number
Lit ou définit la largeur maximale de la liste déroulante, en pixels.
ComboBox
 InheriteddropTarget : DisplayObject
[lecture seule] Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé.
Sprite
  editable : Boolean
Récupère ou définit une valeur booléenne qui indique si le composant ComboBox est modifiable ou en lecture seule.
ComboBox
 Inheritedenabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur.
UIComponent
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.
DisplayObject
 InheritedfocusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée.
UIComponent
 InheritedfocusManager : IFocusManager
Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues.
UIComponent
 InheritedfocusRect : Object
Spécifie si l’objet affiche un rectangle de focus.
InteractiveObject
 Inheritedgraphics : Graphics
[lecture seule] Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.
Sprite
 Inheritedheight : Number
[override] Récupère ou définit la hauteur du composant, en pixels.
UIComponent
 InheritedhitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite.
Sprite
  labelField : String
Lit ou définit le nom du champ dans l’objet dataProvider à afficher en tant qu’étiquette dans le champ TextInput et dans la liste déroulante.
ComboBox
  labelFunction : Function
Lit ou définit la fonction à utiliser pour obtenir l’étiquette de l’élément.
ComboBox
  length : int
[lecture seule] Lit le nombre d’éléments de la liste
ComboBox
 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
 InheritedmouseChildren : 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
 InheritedmouseFocusEnabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée.
UIComponent
 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
 InheritednumChildren : 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
  prompt : String
Récupère ou définit l’invite du composant ComboBox.
ComboBox
  restrict : String
Lit ou définit le jeu de caractères qu’un utilisateur peut entrer dans le champ de texte.
ComboBox
 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
  rowCount : uint
Lit ou définit le nombre maximum de lignes qui peuvent s’afficher dans une liste déroulante sans barre de défilement.
ComboBox
 Inheritedscale9Grid : Rectangle
Grille de mise à l’échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
[override] Multiplie la largeur actuelle du composant par un facteur de redimensionnement.
UIComponent
 InheritedscaleY : Number
[override] Multiplie la hauteur actuelle du composant par un facteur de redimensionnement.
UIComponent
 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
  selectedIndex : int
Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique.
ComboBox
  selectedItem : Object
Lit ou définit la valeur de l’élément qui est sélectionné dans la liste déroulante.
ComboBox
  selectedLabel : String
[lecture seule] Récupère la chaîne affichée dans la partie TextInput du composant ComboBox.
ComboBox
 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
 InheritedsoundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite.
Sprite
 Inheritedstage : Stage
[lecture seule] Scène de l’objet d’affichage.
DisplayObject
 InheritedtabChildren : 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
  text : String
Lit ou définit le texte que la zone de texte contient dans un composant ComboBox modifiable.
ComboBox
  textField : fl.controls:TextInput
[lecture seule] Lit une référence au composant TextInput contenu dans le composant ComboBox.
ComboBox
 InheritedtextSnapshot : 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
 InheriteduseHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true.
Sprite
  value : String
[lecture seule] Récupère l’étiquette d’un élément présent dans un composant ComboBox modifiable.
ComboBox
 Inheritedvisible : Boolean
[override] Récupère ou définit une valeur indiquant si l’occurrence du composant actif est visible.
UIComponent
 Inheritedwidth : Number
[override] Récupère ou définit la largeur du composant, en pixels.
UIComponent
 Inheritedx : Number
[override] Récupère ou définit la coordonnée x représentant la position du composant le long de l’axe x au sein de son conteneur parent.
UIComponent
 Inheritedy : Number
[override] Récupère ou définit la coordonnée y représentant la position du composant le long de l’axe y au sein de son conteneur parent.
UIComponent
 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
  
Crée une nouvelle occurrence du composant ComboBox.
ComboBox
 Inherited
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.
DisplayObjectContainer
 Inherited
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
  
Ajoute un élément à la fin de la liste d’éléments.
ComboBox
  
addItemAt(item:Object, index:uint):void
Insère un élément dans la liste, à l’index spécifié.
ComboBox
 Inherited
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
 Inherited
Définit une propriété de style depuis cette occurrence de composant.
UIComponent
  
Ferme la liste déroulante.
ComboBox
 Inherited
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
Affiche ou masque l’indicateur de focus dans ce composant.
UIComponent
 Inherited
Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow.
UIComponent
 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
 Inherited
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.
DisplayObjectContainer
 Inherited
Renvoie l’objet d’affichage enfant portant le nom spécifié.
DisplayObjectContainer
 Inherited
Renvoie la position d’index d’une occurrence enfant de DisplayObject.
DisplayObjectContainer
 Inherited
Récupère l’objet qui détient actuellement le focus.
UIComponent
  
Récupère l’élément à l’index spécifié.
ComboBox
 Inherited
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
Extrait une propriété de style définie dans la chaîne de recherche de style du composant.
UIComponent
  
[statique] Récupère la texture de style par défaut du composant actif.
ComboBox
 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
invalidate(property:String, callLater:Boolean = true):void
Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire.
UIComponent
 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
  
Extrait la chaîne normalement affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés labelField et labelFunction.
ComboBox
 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
[statique] Fusionne les styles de plusieurs classes en un seul objet.
UIComponent
 Inherited
Déplace le composant à la position spécifiée dans son parent.
UIComponent
  
Ouvre la liste déroulante.
ComboBox
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Supprime tous les éléments de la liste.
ComboBox
 Inherited
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
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
  
Supprime l’élément spécifié de la liste.
ComboBox
  
Supprime l’élément présent à l’emplacement d’index spécifié.
ComboBox
  
Remplace l’élément, à l’index spécifié, par un autre élément.
ComboBox
 Inherited
Affiche un clavier virtuel.
InteractiveObject
 Inherited
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage.
DisplayObjectContainer
 Inherited
Définit le focus sur ce composant.
UIComponent
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
setSize(width:Number, height:Number):void
Définit le composant en fonction de la largeur et de la hauteur spécifiées.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Définit une propriété de style pour cette occurrence de composant.
UIComponent
  
sortItems(... sortArgs):*
Trie les éléments du fournisseur de données actuel.
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs.
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permet à l’utilisateur de faire glisser le sprite spécifié.
Sprite
 Inherited
startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile.
Sprite
 Inherited
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine.
DisplayObjectContainer
 Inherited
Met fin à la méthode startDrag().
Sprite
 Inherited
stopTouchDrag(touchPointID:int):void
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles.
Sprite
 Inherited
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés.
DisplayObjectContainer
 Inherited
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
Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire.
UIComponent
 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
Méthodes protégées
 MéthodeDéfini par
 Inherited
Renvoie le style spécifié pour un composant, en tenant compte de tous les styles définis au niveau global, au niveau du composant et au niveau de l’occurrence.
UIComponent
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
  Distribué lorsque l’utilisateur change la sélection dans le composant ComboBox ou, si ce dernier est modifiable, à chaque saisie d’une combinaison de touches par l’utilisateur dans le champ de texte.ComboBox
 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
  Distribué lorsque la liste déroulante se ferme pour une raison quelconque.ComboBox
 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
  Distribué si la propriété editable est définie sur true et que l’utilisateur appuie sur la touche Entrée pendant qu’il tape du texte dans un champ de texte modifiable.ComboBox
 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
 InheritedDistribué après que la visibilité du composant soit passée de visible à invisible.UIComponent
 InheritedCet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.InteractiveObject
   Définit la valeur de la propriété type d’un objet de l’événement itemRollOut.ComboBox
   Définit la valeur de la propriété type de l’objet d’un événement itemRollOver.ComboBox
 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é à la suite du déplacement du composant.UIComponent
 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
  Distribué lorsque l’utilisateur clique sur un bouton déroulant pour afficher la liste déroutante.ComboBox
 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é à la suite du redimensionnement du composant.UIComponent
 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
  Distribué lorsque l’utilisateur parcourt la liste déroulante du composant ComboBox.ComboBox
 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é après que la visibilité du composant soit passée de invisible à visible.UIComponent
 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
Styles

Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.

Styles communs
 Style Description Défini par
  
buttonWidth
Type: Number Format: Length
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Espace qui sépare le bord droit du composant et le texte représentant l’élément sélectionné, en pixels. Le bouton fait partie de l’enveloppe de l’arrière-plan. La valeur par défaut est 24.
ComboBox
  
cellRenderer
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Classe qui fournit le rendu de cellule pour chaque élément du composant. La valeur par défaut est fl.controls.listClasses.CellRenderer.
ComboBox
  
contentPadding
Type: Number Format: Length
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Remplissage entre le contenu (le composant et la barre de défilement) et le bord extérieur de l’arrière-plan, en pixels. La valeur par défaut est 3.
ComboBox
  
disabledAlpha
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Valeur alpha à attribuer à la liste lorsque la propriété enabled est définie sur false. La valeur par défaut est 0.5.
ComboBox
  
disabledSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque la propriété enabled du composant est définie sur false. La valeur par défaut est ComboBox_disabledSkin.
ComboBox
 InheritedType: flash.text.TextFormat
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Objet TextFormat à utiliser pour le rendu de l’étiquette du composant lorsque le bouton est désactivé.
UIComponent
  
downArrowDisabledSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsqu’il est désactivé. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_disabledSkin.
ComboBox
  
downArrowDownSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque vous cliquez sur le bouton flèche. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_downSkin.
ComboBox
  
downArrowOverSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque le pointeur de la souris le survole. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_overSkin.
ComboBox
  
downArrowUpSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_upSkin.
ComboBox
  
downSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque le bouton de la souris est enfoncé. La valeur par défaut est ComboBox_downSkin.
ComboBox
  
embedFonts
Type: Boolean
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Indique si des polices vectorielles incorporées sont utilisées pour le rendu du champ de texte. Si cette valeur est true, Flash Player procède au rendu du champ de texte à l’aide des polices vectorielles incorporées. Si cette valeur est false, Flash Player procède au rendu du champ de texte à l’aide des polices de périphérique.

Si vous définissez la propriété embedFonts sur true pour un champ de texte, vous devez spécifier la police du texte par l’intermédiaire de la propriété font d’un objet TextFormat appliqué au champ de texte. Si la police spécifiée n’est pas intégrée dans le fichier SWF, le texte ne s’affiche pas.

La valeur par défaut est false.
ComboBox
 InheritedType: Number Format: Length
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l’indicateur du focus, en pixels.
UIComponent
 InheritedType: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe à utiliser pour afficher les indicateurs de focus.
UIComponent
  
overSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque la souris le survole. La valeur par défaut est ComboBox_overSkin.
ComboBox
  
repeatDelay
Type: Number Format: Time
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nombre de millisecondes d’attente après la première diffusion de l’événement buttonDown et avant l’envoi d’un second événement buttonDown. La valeur par défaut est 500.
ComboBox
  
repeatInterval
Type: Number Format: Time
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Intervalle, en millisecondes, entre les événements buttonDown distribués après le délai spécifié par le style repeatDelay. La valeur par défaut est 35.
ComboBox
 InheritedType: flash.text.TextFormat
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Objet TextFormat à utiliser pour le rendu de l’étiquette du composant.
UIComponent
  
textPadding
Type: Number Format: Length
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Espace qui sépare la bordure et le texte représentant l’élément sélectionné, en pixels. La valeur par défaut est 3.
ComboBox
  
thumbArrowUpSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe pour le curseur de la barre de défilement. La valeur par défaut est ScrollThumb_upSkin.
ComboBox
  
thumbDisabledSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe utilisée pour indiquer l’état désactivé du curseur. La valeur par défaut est ScrollThumb_upSkin.
ComboBox
  
thumbDownSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque vous cliquez sur le curseur. La valeur par défaut est ScrollThumb_downSkin.
ComboBox
  
thumbIcon
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme icône du curseur de la barre de défilement. La valeur par défaut est ScrollBar_thumbIcon.
ComboBox
  
thumbOverSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque le pointeur de la souris le survole. La valeur par défaut est ScrollThumb_overSkin.
ComboBox
  
trackDisabledSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe utilisée pour indiquer un rail désactivé. La valeur par défaut est ScrollTrack_Skin.
ComboBox
  
trackDownSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe utilisée pour indiquer l’état enfoncé d’une enveloppe désactivée. La valeur par défaut est ScrollTrack_Skin.
ComboBox
  
trackOverSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe utilisée pour indiquer l’état de survol de la souris dans le rail de défilement. La valeur par défaut est ScrollTrack_Skin.
ComboBox
  
trackUpSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Enveloppe utilisée pour indiquer l’état relevé de la souris dans le rail de défilement. La valeur par défaut est ScrollTrack_Skin.
ComboBox
  
upArrowDisabledSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsqu’il est désactivé. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_disabledSkin.
ComboBox
  
upArrowDownSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque vous cliquez sur le bouton flèche. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_downSkin.
ComboBox
  
upArrowOverSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque le pointeur de la souris le survole. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_overSkin.
ComboBox
  
upArrowUpSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_upSkin.
ComboBox
  
upSkin
Type: Class
Version du langage: ActionScript 3.0  Version du produit: Flash CS3  Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0

Nom de la classe qui fournit l’arrière-plan du composant ComboBox. La valeur par défaut est ComboBox_upSkin.
ComboBox
Constantes publiques
 ConstanteDéfini par
 Inheritedversion : String = "3.0.3.1"
Numéro de version des composants.
UIComponent
Détails de la propriété

dataProvider

propriété
dataProvider:DataProvider

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

Lit ou définit le modèle de données de la liste d’éléments à afficher. Un fournisseur de données peut être partagé par plusieurs composants à base de listes. Les modifications apportées au fournisseur de données sont immédiatement à la disposition de tous les composants qui l’utilisent comme source de données.



Implémentation
    public function get dataProvider():DataProvider
    public function set dataProvider(value:DataProvider):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant indique comment définir un fournisseur de données pour un composant ComboBox. Le composant ComboBox est mis à jour en même temps que le fournisseur de données :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();

var cb:ComboBox = new ComboBox();
cb.dataProvider = dp;
addChild(cb);

var counter = 0;
var t:Timer = new Timer(500);
t.addEventListener(TimerEvent.TIMER,addAnotherItem);
t.start();

function addAnotherItem(e:TimerEvent = null):void {
    dp.addItem( { label: "Item " + counter++ } );
}

dropdown

propriété 
dropdown:List  [lecture seule]

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

Récupère une référence au composant List contenu dans le composant ComboBox. Aucune occurrence du sous-composant List n’est créé dans le composant ComboBox jusqu’à l’affichage de ce dernier. Cependant, la liste est créée lors de l’accès à la propriété dropdown.



Implémentation
    public function get dropdown():List

dropdownWidth

propriété 
dropdownWidth:Number

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

Lit ou définit la largeur maximale de la liste déroulante, en pixels. La valeur par défaut de cette propriété correspond à la largeur du composant ComboBox (largeur de l’occurrence TextInput plus la largeur de l’occurrence BaseButton).

La valeur par défaut est 100.



Implémentation
    public function get dropdownWidth():Number
    public function set dropdownWidth(value:Number):void

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée une occurrence du composant ComboBox et définit sa propriété dropdownWidth en fonction de la valeur d’un composant Slider :
import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var mySlider:Slider = new Slider();
mySlider.minimum = 50;
mySlider.maximum = 150;
mySlider.liveDragging = true;
mySlider.snapInterval = 5;
mySlider.tickInterval = 10;
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
mySlider.move(10, 10);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.move(10, 30);
addChild(myComboBox);

mySlider.value = myComboBox.dropdownWidth;

function changeHandler(event:SliderEvent):void {
    myComboBox.dropdownWidth = event.value;
}
L’exemple suivant crée une occurrence du composant ComboBox et définit sa propriété dropdownWidth en fonction de la longueur du texte de la liste déroulante :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"The quick brown fox"});
myComboBox.addItem({label:"Lorem ipsum"});
myComboBox.addItem({label:"Little Miss Muffet"});
myComboBox.addItem({label:"Goldilocks and the three bears"});
myComboBox.addItem({label:"Jack and Jill"});
myComboBox.move(10, 30);
addChild(myComboBox);

var maxLength:Number = 0;
var i:uint;
for (i = 0; i < myComboBox.length; i++) {
    myComboBox.selectedIndex = i;
    myComboBox.drawNow();
    var currText:String = myComboBox.text;
    var currWidth:Number = myComboBox.textField.textWidth;
    maxLength = Math.max(currWidth, maxLength);
    trace(currText, currWidth, maxLength);
}

myComboBox.selectedIndex = -1;
myComboBox.dropdownWidth = maxLength + 20;
myComboBox.open();

editable

propriété 
editable:Boolean

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

Récupère ou définit une valeur booléenne qui indique si le composant ComboBox est modifiable ou en lecture seule. La valeur true indique que le composant ComboBox est modifiable ; la valeur false indique qu’il n’est l’est pas.

Un composant ComboBox modifiable peut comporter des valeurs qui sont saisies par l’utilisateur dans le champ de texte mais n’apparaissent pas dans la liste déroulante. Ce champ affiche le texte de l’élément de la liste. Lorsqu’un composant ComboBox n’est pas modifiable, toute saisie dans le champ de texte est impossible.

La valeur par défaut est false.



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

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée une nouvelle occurrence de ComboBox modifiable qui ajoute des éléments personnalisés au fournisseur de données lorsque l’événemententer est distribué :
import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox;
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var myCB:ComboBox = event.currentTarget as ComboBox;
    dp.addItem({label:myCB.text});
    myCB.text = "";
    myCB.sortItemsOn("label", Array.CASEINSENSITIVE);
}

labelField

propriété 
labelField:String

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

Lit ou définit le nom du champ dans l’objet dataProvider à afficher en tant qu’étiquette dans le champ TextInput et dans la liste déroulante.

Par défaut, le composant affiche la propriété label de chaque élément dataProvider. Si les éléments dataProvider ne contiennent pas de propriété label, vous pouvez définir la propriété labelField pour qu’elle utilise une autre propriété.

Remarque : la propriété labelField n’est pas utilisée lorsque la propriété labelFunction est définie sur une fonction de rappel.

La valeur par défaut est "label".



Implémentation
    public function get labelField():String
    public function set labelField(value:String):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée un composant ComboBox et définit la propriété labelField pour définir un champ d’étiquette personnalisé :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["firstName","lastName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelField = "firstName";
myComboBox.move(10, 10);
addChild(myComboBox);

labelFunction

propriété 
labelFunction:Function

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

Lit ou définit la fonction à utiliser pour obtenir l’étiquette de l’élément.

Par défaut, le composant affiche la propriété label d’un élément dataProvider. Certains ensembles de données peuvent ne pas disposer d’un champ label ou ne pas avoir de champ dont la valeur peut être utilisée en tant qu’étiquette sans modification. Par exemple, un ensemble de données spécifique peut stocker des noms complets et les gérer à l’aide des champs lastName et firstName. Dans ce cas, cette propriété permettrait de définir une fonction de rappel qui concatène les valeurs des champs lastName et firstName pour former le nom complet à afficher.

Remarque : la propriété labelField n’est pas utilisée lorsque la propriété labelFunction est définie sur une fonction de rappel.



Implémentation
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
Cet exemple définit la propriété labelFunction d’une liste sur une fonction qui formate la chaîne à afficher dans chaque cellule :
import fl.data.DataProvider;
import fl.controls.List;

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({name:"User A", price:0.43});
myDataProvider.addItem({name:"User B", price:0.34});

var users:List = new List();
users.dataProvider = myDataProvider;
users.labelFunction = myLabelFunction;
addChild(users);

function myLabelFunction(item:Object):String {
    return  item.name + " ($" + item.price.toFixed(2) + ")";
}
L’exemple suivant crée un composant ComboBox et définit la propriété labelField pour définir un champ d’étiquette personnalisé :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["lastName", "firstName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}

length

propriété 
length:int  [lecture seule]

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

Lit le nombre d’éléments de la liste Cette propriété appartient au composant List, mais est également accessible à partir d’une occurrence ComboBox.

La valeur par défaut est 0.



Implémentation
    public function get length():int

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée un composant ComboBox et définit sa propriété rowCount en fonction du nombre d’éléments qui y sont présents :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.addItem({label:"Item E"});
myComboBox.addItem({label:"Item F"});
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);
L’exemple suivant crée un composant ComboBox et définit sa propriété rowCount en fonction du nombre d’éléments qui y sont présents :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Item A"});
dp.addItem({label:"Item B"});
dp.addItem({label:"Item C"});
dp.addItem({label:"Item D"});
dp.addItem({label:"Item E"});
dp.addItem({label:"Item F"});

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);

prompt

propriété 
prompt:String

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

Récupère ou définit l’invite du composant ComboBox. Cette invite est une chaîne affichée dans la partie TextInput du contrôle ComboBox lorsque la valeur de selectedIndex est -1. Il s’agit généralement d’une chaîne comme « Sélectionnez un... ». Lorsqu’il n’y a pas d’invite, le composant ComboBox définit la propriété selectedIndex sur 0 et affiche le premier élément dans la propriété dataProvider.

La valeur par défaut est "".



Implémentation
    public function get prompt():String
    public function set prompt(value:String):void

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée une occurrence de composant ComboBox, définit sa propriété prompt, puis le redimensionne en fonction de la largeur du texte de l’invite :
import fl.controls.ComboBox;

var cbStyles:Object = ComboBox.getStyleDefinition();
var bW:Number = cbStyles.buttonWidth as Number

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an option...";
myComboBox.addItem({label:"Option 1"});
myComboBox.addItem({label:"Option 2"});
myComboBox.drawNow();
myComboBox.width = myComboBox.textField.textWidth + 35;
myComboBox.dropdownWidth = myComboBox.width - bW;
myComboBox.move(10, 10);
addChild(myComboBox);
L’exemple suivant crée une occurrence de composant ComboBox et définit sa propriété prompt en fonction du nombre d’éléments présents dans son fournisseur de données :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Getting Started"});
dp.addItem({label:"New Features"});
dp.addItem({label:"ActionScript"});
dp.addItem({label:"Components"});
dp.sortOn("label", Array.CASEINSENSITIVE);

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Topics (" + dp.length + ")";
myComboBox.dataProvider = dp;
myComboBox.width = 150;
myComboBox.move(10, 10);
addChild(myComboBox);

restrict

propriété 
restrict:String

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

Lit ou définit le jeu de caractères qu’un utilisateur peut entrer dans le champ de texte. Si la valeur de la propriété restrict est une chaîne de caractères, vous ne pouvez entrer que les caractères dans la chaîne du champ de texte. La chaîne est lue de gauche à droite. Si la valeur de la propriété restrict est null, vous pouvez entrer n’importe quel caractère. Si la valeur de la propriété restrict est une chaîne vide (""), aucun caractère ne peut être entré. Vous pouvez spécifier une plage à l’aide du caractère (-). Ceci ne limite que l’interaction avec l’utilisateur ; un script peut mettre n’importe quel caractère dans le champ de texte.

La valeur par défaut est null.



Implémentation
    public function get restrict():String
    public function set restrict(value:String):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée un composant ComboBox modifiable qui n’accepte que la saisie de couleurs hexadécimales à l’aide de la propriété restrict :
import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.restrict = "0-9A-F";
myComboBox.textField.maxChars = 6;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var colorStr:String = ComboBox(event.currentTarget).text;
    var colorNum:uint = uint("0x" + colorStr);
    dp.addItem({label:colorStr, value:colorNum});
    dp.sortOn("value", Array.NUMERIC);
    event.currentTarget.text = "";
}

rowCount

propriété 
rowCount:uint

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

Lit ou définit le nombre maximum de lignes qui peuvent s’afficher dans une liste déroulante sans barre de défilement. Si le nombre d’éléments de la liste déroulante dépasse cette valeur, la liste est redimensionnée et une barre de défilement s’affiche si nécessaire. Lorsque le nombre d’éléments de la liste déroulante est inférieur à cette valeur, la liste déroulante est redimensionnée en fonction du nombre d’éléments qu’elle contient.

Ce comportement diffère de celui du composant List, qui affiche toujours le nombre de lignes spécifié par sa propriété rowCount, même en cas d’espaces vides.

La valeur par défaut est 5.



Implémentation
    public function get rowCount():uint
    public function set rowCount(value:uint):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant utilise un composant Slider pour définir la propriété rowCount d’un composant ComboBox :
import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var numItems:uint = 8;

var mySlider:Slider = new Slider();
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 1;
mySlider.maximum = numItems;
mySlider.liveDragging = true;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.move(10, 30);
addChild(myComboBox);

var i:uint;
for (i = 0; i < numItems; i++) {
    myComboBox.addItem({label:"Item " + i});
}

function changeHandler(event:SliderEvent):void {
    myComboBox.rowCount = event.value;
}

selectedIndex

propriété 
selectedIndex:int

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

Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique. Une liste à sélection unique est une liste où il n’est possible de sélectionner qu’un seul élément à la fois.

La valeur -1 indique qu’aucun élément n’est sélectionné. En cas de sélections multiples, cette valeur correspond à l’index du dernier élément sélectionné dans le groupe d’éléments sélectionnés.

Lorsque cette propriété est définie à l’aide du code ActionScript, l’élément situé à l’index spécifié remplace la sélection actuelle. Lorsque la sélection est modifiée par le programme, l’objet d’événement change n’est pas distribué.

La valeur par défaut est 0.



Implémentation
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant utilise un composant Slider pour définir la propriété selectedIndex de l’occurrence du composant ComboBox :
import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.data.DataProvider;
import fl.events.SliderEvent;

var items:XML = <items>
        <item label="Item 1" />
        <item label="Item 2" />
        <item label="Item 3" />
        <item label="Item 4" />
    </items>;

var dp:DataProvider = new DataProvider(items);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 0;
mySlider.maximum = dp.length - 1;
mySlider.width = 100;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.move(10, 30);
addChild(myComboBox);

function changeHandler(event:SliderEvent):void {
    myComboBox.selectedIndex = event.value;
}
L’exemple suivant crée un composant ComboBox et affiche la valeur de sa propriété selectedIndex dans une étiquette sur la scène :
import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an item...";
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.addItem({label:"Item 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
addChild(myLabel);

function changeHandler(event:Event):void {
    myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
}

selectedItem

propriété 
selectedItem:Object

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

Lit ou définit la valeur de l’élément qui est sélectionné dans la liste déroulante. Lorsque l’utilisateur saisit du texte dans la zone de texte d’un composant ComboBox modifiable, la propriété selectedItem prend la valeur undefined. Cette propriété n’a de valeur que si l’utilisateur sélectionne un élément dans la liste déroulante ou si ActionScript sert à y sélectionner cet élément. Lorsque le composant ComboBox n’est pas modifiable, la valeur de la propriété selectedItem est toujours valide. Lorsque la liste déroulante d’un composant ComboBox modifiable ne comporte pas d’éléments, la valeur de cette propriété est null.

La valeur par défaut est null.



Implémentation
    public function get selectedItem():Object
    public function set selectedItem(value:Object):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant utilise un composant Button pour copier les éléments d’un ComboBox vers un composant List :
import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.List;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select an item";
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.move(10, 10);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.label = "Copy";
myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var myList:List = new List();
myList.rowCount = myList.length;
myList.selectable = false;
myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myList);

function clickHandler(event:MouseEvent):void {
    if (myComboBox.selectedIndex > -1) {
        myList.addItem(myComboBox.selectedItem);
        myList.rowCount = myList.length;
    }
}
L’exemple suivant utilise deux composants Label pour afficher l’élément actuellement sélectionné dans un ComboBox :
import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var firstNameLabel:Label = new Label();
firstNameLabel.text = "";
firstNameLabel.autoSize = TextFieldAutoSize.LEFT;
firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(firstNameLabel);

var lastNameLabel:Label = new Label();
lastNameLabel.text = "";
lastNameLabel.autoSize = TextFieldAutoSize.LEFT;
lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height);
addChild(lastNameLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    var item:Object = cb.selectedItem;
    if (cb.selectedIndex > -1) {
        firstNameLabel.text = item.firstName;
        lastNameLabel.text = item.lastName;
    }
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}

selectedLabel

propriété 
selectedLabel:String  [lecture seule]

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

Récupère la chaîne affichée dans la partie TextInput du composant ComboBox. Cette valeur est calculée à partir des données à l’aide de la propriété labelField ou labelFunction.



Implémentation
    public function get selectedLabel():String

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
L’exemple suivant utilise un composant Label pour afficher la propriété selectedLabel d’un composant ComboBox :
import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "selectedLabel: " + cb.selectedLabel;
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}

text

propriété 
text:String

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

Lit ou définit le texte que la zone de texte contient dans un composant ComboBox modifiable. Lorsque les composants ComboBox ne sont pas modifiables, cette valeur est en lecture seule.

La valeur par défaut est "".



Implémentation
    public function get text():String
    public function set text(value:String):void

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant crée un composant ComboBox modifiable qui affiche le texte saisi dans une occurrence du composant TextArea :
import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ComponentEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.width = 300;
myComboBox.move(10, 10);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.setSize(300, 200);
myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myTextArea)

function textInputHandler(event:TextEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\t" + event.text + "\n");
    myTextArea.appendText("\n");
    
    autoScroll(myTextArea);
}

function enterHandler(event:ComponentEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\n");
    autoScroll(myTextArea);
}

function autoScroll(ta:TextArea):void {
    ta.verticalScrollPosition = ta.maxVerticalScrollPosition;
}

textField

propriété 
textField:fl.controls:TextInput  [lecture seule]

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

Lit une référence au composant TextInput contenu dans le composant ComboBox. Utilisez cette propriété pour accéder au composant TextInput sous-jacent et le manipuler. Par exemple, vous pouvez utiliser cette propriété pour changer la sélection du champ de texte ou restreindre les caractères pouvant y être saisis.



Implémentation
    public function get textField():fl.controls:TextInput

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant créé un composant ComboBox modifiable qui autorise la saisie de 8 caractères maximum :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);
L’exemple suivant crée un composant ComboBox et définit le format du champ de texte intégré :
import fl.controls.ComboBox;

var comicSansTF:TextFormat = new TextFormat();
comicSansTF.font = "Comic Sans MS";

var myComboBox:ComboBox = new ComboBox();
myComboBox.textField.setStyle("textFormat", comicSansTF);
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.move(10, 10);
addChild(myComboBox);
L’exemple suivant crée une occurrence du composant ComboBox et définit le format de texte personnalisé du champ de texte intégré et du menu déroulant :
import fl.controls.ComboBox;
import fl.data.DataProvider;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";
myTextFormat.color = 0xFF0000;

var fontArray:Array = Font.enumerateFonts(true);
fontArray.sortOn("fontName", Array.CASEINSENSITIVE);

var dp:DataProvider = new DataProvider(fontArray);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.dropdown.iconField = null;
myComboBox.labelField = "fontName";
myComboBox.textField.setStyle("textFormat", myTextFormat);
myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat);
myComboBox.width = 200;
myComboBox.move(10, 10);
addChild(myComboBox);

value

propriété 
value:String  [lecture seule]

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

Récupère l’étiquette d’un élément présent dans un composant ComboBox modifiable. Pour les composants ComboBox qui ne sont pas modifiables, cette propriété lit les données contenues par l’élément.



Implémentation
    public function get value():String

Exemple  ( Comment utiliser cet exemple )
L’exemple suivant utilise un composant Label pour afficher la propriété value d’un composant ComboBox modifiable :
import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
myComboBox.editable = true;
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "value: " + cb.value;
}

function nameLabelFunction(item:Object):String {
    var str:String;
    if (item == null) {
        str = myComboBox.value;
    } else {
        str = item.lastName + ", " + item.firstName;
    }
    return str;
}
Détails du constructeur

ComboBox

()Constructeur
public function ComboBox()

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

Crée une nouvelle occurrence du composant ComboBox.

Détails de la méthode

addItem

()méthode
public function addItem(item:Object):void

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

Ajoute un élément à la fin de la liste d’éléments.

Tout élément doit disposer des propriétés label et data. Il reste cependant possible d’ajouter à la liste les éléments qui disposent d’autres propriétés. Par défaut, la propriété label d’un élément permet d’afficher l’étiquette de la ligne. La propriété data permet de stocker les données de la ligne.

Paramètres

item:Object — Elément à ajouter au fournisseur de données.

Eléments de l’API associés

addItemAt

()méthode 
public function addItemAt(item:Object, index:uint):void

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

Insère un élément dans la liste, à l’index spécifié. Les index des éléments à ou après l’emplacement spécifié sont incrémentés d’une unité.

Paramètres

item:Object — Elément à ajouter à la liste.
 
index:uint — L’index auquel ajouter l’élément.

Eléments de l’API associés

close

()méthode 
public function close():void

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

Ferme la liste déroulante.

Remarque : l’appel de cette méthode déclenche la diffusion de l’événement close. Lorsque le composant ComboBox est déjà fermé, l’appel de cette méthode n’a aucun effet.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant ComboBox et active ou désactive la visibilité du menu déroulant à l’aide des méthodes open() et close() :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}

getItemAt

()méthode 
public function getItemAt(index:uint):Object

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

Récupère l’élément à l’index spécifié.

Paramètres

index:uint — Index de l’élément à récupérer.

Valeur renvoyée
Object — Objet présent à l’index spécifié.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant ComboBox et utilise une boucle for et la méthode getItemAt() pour copier les éléments du ComboBox dans un composant DataGrid :
import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1", price:0.34});
myComboBox.addItem({label:"Item 2", price:13.19});
myComboBox.addItem({label:"item 3", price:2.96});
myComboBox.addItem({label:"Item 4", price:3.49});
myComboBox.addItem({label:"Item 5", price:1.27});
myComboBox.move(10, 10);
addChild(myComboBox);

var indexCol:DataGridColumn = new DataGridColumn("index");
indexCol.headerText = "";
indexCol.sortOptions = Array.NUMERIC;

var labelCol:DataGridColumn = new DataGridColumn("label");
labelCol.sortOptions = Array.CASEINSENSITIVE;

var priceCol:DataGridColumn = new DataGridColumn("price");
priceCol.sortOptions = Array.NUMERIC;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(indexCol);
myDataGrid.addColumn(labelCol);
myDataGrid.addColumn(priceCol);
myDataGrid.move(10, 40);
myDataGrid.rowCount = myComboBox.length;
myDataGrid.width = 180;
addChild(myDataGrid);

var i:uint;
var item:Object;
for (i = 0; i < myComboBox.length; i++) {
    item = myComboBox.getItemAt(i);
    myDataGrid.addItem({index:i, label:item.label, price:item.price});
}

getStyleDefinition

()méthode 
public static function getStyleDefinition():Object

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

Récupère la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat contient la valeur null ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle() pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat dans le composant spécifié :

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Valeur renvoyée
Object — Objet de styles par défaut.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un navigateur de styles pour différentes classes de composant :
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

itemToLabel

()méthode 
public function itemToLabel(item:Object):String

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

Extrait la chaîne normalement affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés labelField et labelFunction.

Remarque : labelField n’est pas utilisé lorsque la propriété labelFunction est définie sur une fonction de rappel.

Paramètres

item:Object — Objet à restituer.

Valeur renvoyée
String — Chaîne à afficher en fonction des données.

Eléments de l’API associés

open

()méthode 
public function open():void

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

Ouvre la liste déroulante.

Remarque : l’appel de cette méthode déclenche la diffusion de l’événement open. Lorsque le composant ComboBox est déjà ouvert, l’appel de cette méthode n’a aucun effet.

Eléments de l’API associés

removeAll

()méthode 
public function removeAll():void

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

Supprime tous les éléments de la liste.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise une occurrence du composant Button pour supprimer les éléments d’un ComboBox à l’aide de la méthode removeAll() :
import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextInput;

var greenTF:TextFormat;
var redTF:TextFormat;
var myTextInput:TextInput;
var addButton:Button;
var myComboBox:ComboBox;
var removeButton:Button;

greenTF = new TextFormat();
greenTF.color = 0x006600;

redTF = new TextFormat();
redTF.color = 0xFF0000;

myTextInput = new TextInput();
myTextInput.maxChars = 20;
myTextInput.restrict = "a-zA-Z";
myTextInput.move(10, 10);
addChild(myTextInput);

addButton = new Button();
addButton.label = "(+) Add";
addButton.setStyle("textFormat", greenTF);
addButton.move(120, 10);
addButton.addEventListener(MouseEvent.CLICK, addClickHandler);
addChild(addButton);

myComboBox = new ComboBox();
myComboBox.move(10, 40);
addChild(myComboBox);

removeButton = new Button();
removeButton.label = "(-) Remove All";
removeButton.setStyle("textFormat", redTF);
removeButton.move(120, 40);
removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler);
addChild(removeButton);

function addClickHandler(event:MouseEvent):void {
    if (myTextInput.length > 0) {
        trace("adding item...");
        myComboBox.addItem({label:myTextInput.text});
        myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE);
        myTextInput.text = "";
    }
}

function removeClickHandler(event:MouseEvent):void {
    trace("removing all items...");
    myComboBox.removeAll();
}

removeItem

()méthode 
public function removeItem(item:Object):Object

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

Supprime l’élément spécifié de la liste.

Paramètres

item:Object — Elément à supprimer.

Valeur renvoyée
Object — Elément qui a été supprimé.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant montre comment retirer un élément d’une liste après que l’utilisateur ait cliqué sur son entrée :
import fl.controls.List;
import fl.events.ListEvent;

var myList:List = new List();
myList.addItem( { label: "Carrot" } );
myList.addItem( { label: "Turnip" } );
myList.addItem( { label: "Tomato" } );
myList.addItem( { label: "Blueberry" } );
myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem);
addChild(myList);

function removeSelectedItem(e:ListEvent):void {
    myList.removeItem(e.item);
}

removeItemAt

()méthode 
public function removeItemAt(index:uint):void

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

Supprime l’élément présent à l’emplacement d’index spécifié. Les index d’emplacement des éléments dont les index sont supérieurs à la progression d’index spécifiée dans le tableau 1.

Il s’agit d’une méthode du composant List qui est disponible à partir d’une occurrence de composant ComboBox.

Paramètres

index:uint — Index de l’élément à supprimer.


Valeur émise
RangeError — L’index spécifié est inférieur à 0 ou supérieur ou égal à la longueur du fournisseur de données.

Eléments de l’API associés

replaceItemAt

()méthode 
public function replaceItemAt(item:Object, index:uint):Object

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

Remplace l’élément, à l’index spécifié, par un autre élément. Cette méthode modifie le fournisseur de données du composant List. Lorsque le fournisseur de données est partagé avec d’autres composants, les données qui sont fournies à ces composants sont également mises à jour.

Paramètres

item:Object — Elément devant remplacer l’élément à l’emplacement d’index spécifié.
 
index:uint — Indice de l’élément à remplacer.

Valeur renvoyée
Object — Elément qui a été remplacé.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant remplace l’élément actuellement sélectionné dans un ComboBox par la valeur d’un composant TextInput à l’aide de la méthode replaceItemAt() :
import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.controls.TextInput;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user...";
myComboBox.addItem({label:"Person 1"});
myComboBox.addItem({label:"Person 2"});
myComboBox.addItem({label:"Person 3"});
myComboBox.addItem({label:"Person 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "a-zA-Z0-9";
myTextInput.maxChars = 12;
myTextInput.move(10, 40);
addChild(myTextInput)

var myButton:Button = new Button();
myButton.label = "Replace item";
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
myButton.move(120, 40);
addChild(myButton);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(10, 70);
addChild(myTextArea);

function changeHandler(event:Event):void {
    myTextInput.text = myComboBox.selectedLabel;
}

function clickHandler(event:MouseEvent):void {
    var cIndex:int = myComboBox.selectedIndex;
    if (cIndex > -1) {
        var newItem:Object = {label:myTextInput.text};
        var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex);
        myComboBox.selectedIndex = cIndex;
        myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n");
        myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
    }
}

sortItems

()méthode 
public function sortItems(... sortArgs):*

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

Trie les éléments du fournisseur de données actuel. Cette méthode effectue un tri en fonction des valeurs Unicode des éléments. ASCII est un sous-ensemble de Unicode.

Paramètres

... sortArgs — Les arguments à appliquer pour le tri.

Valeur renvoyée
* — La valeur renvoyée varie en fonction des paramètres qui sont transmis à cette méthode. Pour plus d’informations, consultez la méthode Array.sort(). Cette méthode renvoie 0 lorsque le paramètre sortArgs est défini sur Array.UNIQUESORT.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant trie les éléments d’une occurrence de ComboBox en fonction du texte de l’étiquette de chaque élément. Les éléments à trier sont transmis à une fonction de tri personnalisée, upperCaseSort(), qui compare les propriétés label de deux éléments et renvoie une valeur booléenne fonction de l’ordre dans lequel l’élément doit s’afficher :
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
cb.addItem( { label: "Mercury" } );
cb.addItem( { label: "Venus" } );
cb.addItem( { label: "Earth" } );
cb.addItem( { label: "planet" } );
cb.sortItems(upperCaseSort);
addChild(cb);

function upperCaseSort(a:Object, b:Object):Boolean {
    return a.label.toUpperCase() > b.label.toUpperCase();
}

sortItemsOn

()méthode 
public function sortItemsOn(field:String, options:Object = null):*

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

Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs.

Paramètres

field:String — Les champs sur lesquels porte le tri.
 
options:Object (default = null) — Arguments de tri destinés à remplacer le comportement de tri par défaut. Sépare deux ou plusieurs arguments avec l’opérateur OR (|) au niveau du bit.

Valeur renvoyée
* — La valeur renvoyée varie en fonction des paramètres qui sont transmis à cette méthode. Pour plus d’informations, voir la méthode Array.sortOn(). Cette méthode renvoie 0 lorsque le paramètre sortOption est défini sur Array.UNIQUESORT.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Les exemples suivants sont basés sur une occurrence de ComboBox appelée cb contenant quatre éléments appelés "Apples", "Bananas", "cherries" et "Grapes" :
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
addChild(cb);

// First, populate the ComboBox with the elements.
cb.addItem( { label: "Bananas" } );
cb.addItem( { label: "Apples" } );
cb.addItem( { label: "cherries" } );
cb.addItem( { label: "Grapes" } );

// The following statement sorts using the order parameter set to "ASC", 
// and results in a sort that places "cherries" at the bottom of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "ASC"); 
// resulting order: Apples, Bananas, Grapes, cherries

// The following statement sorts using the order parameter set to "DESC", 
// and results in a sort that places "cherries" at the top of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "DESC");
// resulting order: cherries, Grapes, Bananas, Apples

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE. Note that an ascending sort is the default setting.
cb.sortItemsOn("label", Array.CASEINSENSITIVE);
// resulting order: Apples, Bananas, cherries, Grapes

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE | Array.DESCENDING.
cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING);
// resulting order: Grapes, cherries, Bananas, Apples

L’exemple suivant crée un composant ComboBox et trie ses éléments via la méthode sortItemsOn() :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE);
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
Détails de l’événement

change

Evénement
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CHANGE

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

Distribué lorsque l’utilisateur change la sélection dans le composant ComboBox ou, si ce dernier est modifiable, à chaque saisie d’une combinaison de touches par l’utilisateur dans le champ de texte.

Remarque : même si le tableau ci-dessous indique que l’événement change se propage, il ne se propage pas pour le contrôle fl.controls.ComboBox.

La constante Event.CHANGE définit la valeur de la propriété type de l’objet d’événement change.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblestrue
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet dont la valeur a été modifiée. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

close

Evénement  
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CLOSE

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

Distribué lorsque la liste déroulante se ferme pour une raison quelconque.

La constante Event.CLOSE définit la valeur de la propriété type d’un objet événement close.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet dont la connexion a été fermée.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant ComboBox et active ou désactive la visibilité du menu déroulant à l’aide des méthodes open() et close() :
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}

Eléments de l’API associés

enter

Evénement  
Type d’objet d’événement: fl.events.ComponentEvent
propriété ComponentEvent.type = fl.events.ComponentEvent.ENTER

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

Distribué si la propriété editable est définie sur true et que l’utilisateur appuie sur la touche Entrée pendant qu’il tape du texte dans un champ de texte modifiable.

Définit la valeur de la propriété type d’un objet de l’événement enter.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetObjet qui traite activement l’objet de l’événement avec un écouteur d’événement.
targetObjet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget.

itemRollOut

Evénement  
Type d’objet d’événement: fl.events.ListEvent
propriété ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OUT

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

Distribué lorsque le pointeur de la souris cesse de survoler un élément du composant.

Définit la valeur de la propriété type d’un objet de l’événement itemRollOut.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
columnIndexIndex de base zéro de la colonne qui contient la fonctionnalité de rendu.
currentTargetObjet qui traite activement l’objet de l’événement avec un écouteur d’événement.
indexIndex de base zéro du DataProvider qui contient la fonction de rendu.
itemRéférence à la donnée qui appartient à la fonction de rendu.
rowIndexIndex de base zéro de la ligne qui contient la fonction de rendu.
targetObjet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget.

Eléments de l’API associés

itemRollOver

Evénement  
Type d’objet d’événement: fl.events.ListEvent
propriété ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OVER

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

Distribué lorsque le pointeur de la souris survole un élément du composant.

Définit la valeur de la propriété type d’un objet de l’événement itemRollOver.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
columnIndexIndex de base zéro de la colonne qui contient la fonctionnalité de rendu.
currentTargetObjet qui traite activement l’objet de l’événement avec un écouteur d’événement.
indexIndex de base zéro du DataProvider qui contient la fonction de rendu.
itemRéférence à la donnée qui appartient à la fonction de rendu.
rowIndexIndex de base zéro de la ligne qui contient la fonction de rendu.
targetObjet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un composant ComboBox qui s’ouvre lorsque la souris de l’utilisateur survole l’occurrence du composant :
import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ListEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler)
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(120, 10);
addChild(myTextArea);

function openHandler(event:Event):void {
    logEvent("ComboBox open");
}

function closeHandler(event:Event):void {
    logEvent("ComboBox close");
}

function itemRollOverHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function itemRollOutHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function rollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOver");
    myComboBox.open();
}

function rollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOut");
    myComboBox.close();
}

function dropdownRollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOver");
    // reopen ComboBox after it gets closed by the ComboBox rollOut event
    myComboBox.open();
}

function dropdownRollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOut");
    myComboBox.close();
}

function logEvent(text:String):void {
    myTextArea.appendText(text + "\n");
    myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
}

Eléments de l’API associés

open

Evénement  
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.OPEN

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

Distribué lorsque l’utilisateur clique sur un bouton déroulant pour afficher la liste déroutante. Egalement distribué lorsque l’utilisateur clique sur le champ de texte, si le composant ComboBox n’est pas modifiable.

La constante Event.OPEN définit la valeur de la propriété type d’un objet événement open.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau qui a ouvert une connexion.

Exemple  ( Comment utiliser cet exemple )

L’exemple suivant crée un composant Button qui ouvre une liste déroulante de composant ComboBox à l’aide de la méthode open(). Le menu déroulant se referme 1 seconde plus tard, sauf si l’utilisateur déplace sa souris sur le ComboBox ou son menu déroulant :
import fl.controls.Button;
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.emphasized = true;
myButton.label = "open ComboBox";
myButton.move(120, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var closeTimer:Timer = new Timer(1000, 1);
closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);

function clickHandler(event:MouseEvent):void {
    myComboBox.open();
    closeTimer.reset();
    closeTimer.start();
}

function timerCompleteHandler(event:TimerEvent):void {
    myComboBox.close();
}

function rollOverHandler(event:MouseEvent):void {
    closeTimer.stop();
}

function rollOutHandler(event:MouseEvent):void {
    myComboBox.close();
}

Eléments de l’API associés

scroll

Evénement  
Type d’objet d’événement: fl.events.ScrollEvent
propriété ScrollEvent.type = fl.events.ScrollEvent.SCROLL

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

Distribué lorsque l’utilisateur parcourt la liste déroulante du composant ComboBox.

Définit la valeur de la propriété type d’un objet d’événement scroll.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetObjet qui traite activement l’objet de l’événement avec un écouteur d’événement.
delta1 ; valeur indiquant la longueur du défilement effectué.
directionvertical ; direction de l’objet ScrollBar.
position0 ; position du curseur de Scrollbar après son déplacement.
targetObjet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget.
ComboBoxExample.as

Cet exemple montre comment écouter les événements d’un ComboBox.
  1. Faites glisser un composant ComboBox sur la scène et appelez-le cb.
  2. Enregistrez ce code sous le nom ComboBoxExample.as dans le même répertoire que votre fichier FLA.
  3. Dans le fichier FLA, définissez DocumentClass sur ComboBoxExample.
package 
{
    import flash.display.Sprite
    import flash.text.TextField;
    import flash.events.Event;
    import fl.controls.ComboBox;
    
    public class ComboBoxExample extends Sprite
    {
        private var tf:TextField;
        
        public function ComboBoxExample() {
            setupComboBox();
            setupTextField();
        }
        private function setupTextField():void {
            tf = new TextField();
            tf.x = 180;
            tf.y = 15;
            tf.autoSize = "left";
            addChild(tf);
        }
        private function setupComboBox():void {
            cb.setSize(150,22);
            cb.addItem( { label: "MasterCard", data:1 } );
            cb.addItem( { label: "Visa", data:2 } );
            cb.addItem( { label: "American Express", data:3 } );
            cb.addEventListener(Event.CHANGE, cardSelected);            
        }
        private function cardSelected(e:Event):void {
            tf.text = "You have selected: "
            tf.appendText(cb.selectedItem.label);
        }
    }
}




[ 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.