Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: AIR 30.0 e anterior, Flash Player 30.0 e anterior, Flash Lite 4
Flex 4.6 e anterior, Flash Pro CS6 e anterior
Ocultar filtros
fl.controls 

ComboBox  - AS3 Flash

Pacotesx

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

Elementos de linguagem

Constantes globais
Funções globais
Operadores
Instruções, palavras-chave e diretivas
Tipos especiais

Apêndices

Novidades
Erros do compilador
Avisos do compilador
Erros de runtime
Migrando para o ActionScript 3
Conjuntos de caracteres suportados
Tags MXML apenas
Elementos XML de movimento
Marcas de texto cronometradas
Lista de elementos deprecados
Constantes de Implementação de Acessibilidade
Como Usar Exemplos do ActionScript
Aspectos jurídicos
Pacotefl.controls
Classepublic class ComboBox
HerançaComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implementações IFocusManagerComponent

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

O componente ComboBox contém uma lista suspensa em que o usuário pode selecionar um valor. Sua funcionalidade é semelhante à do elemento de formulário SELECT em HTML. O componente ComboBox pode ser editado e, nesse caso, o usuário pode digitar entradas que não estão na lista na parte de TextInput do componente ComboBox.

Veja os exemplos

Elementos da API relacionados



Propriedades públicas
 PropriedadeDefinido por
 InheritedaccessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição.
DisplayObject
 Inheritedalpha : Number
Indica o valor de transparência alfa do objeto especificado.
DisplayObject
 InheritedblendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado.
DisplayObject
 InheritedblendShader : Shader
[somente gravação] Define um shader usado para mesclar o primeiro plano e o segundo plano.
DisplayObject
 InheritedbuttonMode : Boolean
Especifica o modo de botão desta entidade gráfica.
Sprite
 InheritedcacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro.
DisplayObject
 Inheritedconstructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.
Object
 InheritedcontextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto.
InteractiveObject
  dataProvider : DataProvider
Obtém ou define o modelo de dados da lista de itens a serem visualizados.
ComboBox
 InheriteddoubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick.
InteractiveObject
  dropdown : List
[somente leitura] Obtém uma referência ao componente List que o componente ComboBox contém.
ComboBox
  dropdownWidth : Number
Obtém ou define a largura máxima da lista suspensa, em pixels.
ComboBox
 InheriteddropTarget : DisplayObject
[somente leitura] Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta.
Sprite
  editable : Boolean
Obtém ou define um valor booliano que indica se o componente ComboBox é editável ou somente leitura.
ComboBox
 Inheritedenabled : Boolean
Obtém ou define um valor que indica se o componente pode aceitar a interação do usuário.
UIComponent
 Inheritedfilters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição.
DisplayObject
 InheritedfocusEnabled : Boolean
Obtém ou define um valor booliano que indica se o componente pode receber foco depois que o usuário clicar nele.
UIComponent
 InheritedfocusManager : IFocusManager
Obtém ou define o FocusManager que controla o foco para este componente e seus semelhantes.
UIComponent
 InheritedfocusRect : Object
Especifica se este objeto exibe um retângulo de foco.
InteractiveObject
 Inheritedgraphics : Graphics
[somente leitura] Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer.
Sprite
 Inheritedheight : Number
[substituir] Obtém ou define a altura do componente, em pixels.
UIComponent
 InheritedhitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica.
Sprite
  labelField : String
Obtém ou define o nome do campo no objeto dataProvider a ser exibido como rótulo para a lista suspensa e o campo TextInput.
ComboBox
  labelFunction : Function
Obtém ou define a função a ser usada para obter o rótulo do item.
ComboBox
  length : int
[somente leitura] Obtém o número de itens na lista.
ComboBox
 InheritedloaderInfo : LoaderInfo
[somente leitura] Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence.
DisplayObject
 Inheritedmask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado.
DisplayObject
 InheritedmetaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4.
DisplayObject
 InheritedmouseChildren : Boolean
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Obtém ou define um valor que indica se o componente pode receber foco depois que o usuário clicar nele.
UIComponent
 InheritedmouseX : Number
[somente leitura] Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels.
DisplayObject
 InheritedmouseY : Number
[somente leitura] Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels.
DisplayObject
 Inheritedname : String
Indica o nome da ocorrência de DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco.
InteractiveObject
 InheritednumChildren : int
[somente leitura] Retorna o número de filhos deste objeto.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[somente leitura] Indica o objeto DisplayObjectContainer que contém esse objeto de exibição.
DisplayObject
  prompt : String
Obtém ou define o prompt para o componente ComboBox.
ComboBox
  restrict : String
Obtém ou define os caracteres que um usuário pode inserir no campo de texto.
ComboBox
 Inheritedroot : DisplayObject
[somente leitura] Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original.
DisplayObject
 InheritedrotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
 InheritedrotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
 InheritedrotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
  rowCount : uint
Obtém ou define o número máximo de linhas que podem aparecer em uma lista suspensa que não tem uma barra de rolagem.
ComboBox
 Inheritedscale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor.
DisplayObject
 InheritedscaleX : Number
[substituir] Multiplica a largura atual do componente por um fator escalar.
UIComponent
 InheritedscaleY : Number
[substituir] Multiplica a altura atual do componente por um fator escalar.
UIComponent
 InheritedscaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto.
DisplayObject
 InheritedscrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição.
DisplayObject
  selectedIndex : int
Obtém ou define o índice do item selecionado em uma lista de seleção única.
ComboBox
  selectedItem : Object
Obtém ou define o valor do item selecionado na lista suspensa.
ComboBox
  selectedLabel : String
[somente leitura] Obtém a string exibida na parte TextInput do componente ComboBox.
ComboBox
 Inherited    softKeyboard : String
Controla a aparência do teclado suave.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS)
InteractiveObject
 InheritedsoundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica.
Sprite
 Inheritedstage : Stage
[somente leitura] O Palco do objeto de exibição.
DisplayObject
 InheritedtabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação.
InteractiveObject
 InheritedtabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF.
InteractiveObject
  text : String
Obtém ou define o texto que a caixa de texto contém em um componente ComboBox editável.
ComboBox
  textField : fl.controls:TextInput
[somente leitura] Obtém uma referência ao componente TextInput que o componente ComboBox contém.
ComboBox
 InheritedtextSnapshot : flash.text:TextSnapshot
[somente leitura] Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição.
DisplayObject
 InheriteduseHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true".
Sprite
  value : String
[somente leitura] Obtém o rótulo de um item em um componente ComboBox editável.
ComboBox
 Inheritedvisible : Boolean
[substituir] Obtém ou define um valor que indica se a ocorrência do componente atual é visível.
UIComponent
 Inheritedwidth : Number
[substituir] Obtém ou define a largura do componente, em pixels.
UIComponent
 Inheritedx : Number
[substituir] Obtém ou define a coordenada x que representa a posição do componente ao longo do eixo x em seu contêiner-pai.
UIComponent
 Inheritedy : Number
[substituir] Obtém ou define a coordenada y que representa a posição do componente ao longo do eixo y em seu contêiner-pai.
UIComponent
 Inheritedz : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
Cria uma nova ocorrência do componente ComboBox.
ComboBox
 Inherited
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.
EventDispatcher
  
Acrescenta um item ao final da lista de itens.
ComboBox
  
addItemAt(item:Object, index:uint):void
Insere um item na lista, na localização de índice especificada.
ComboBox
 Inherited
Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado.
DisplayObjectContainer
 Inherited
Exclui uma propriedade de estilo desta ocorrência do componente.
UIComponent
  
Fecha a lista suspensa.
ComboBox
 Inherited
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência.
DisplayObjectContainer
 Inherited
Envia um evento para o fluxo de eventos.
EventDispatcher
 Inherited
Mostra ou oculta o indicador de foco neste componente.
UIComponent
 Inherited
Inicia uma operação imediata de desenho, sem invalidar nada como faz invalidateNow.
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace.
DisplayObject
 Inherited
Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado.
DisplayObjectContainer
 Inherited
Retorna o objeto de exibição-filho que existe com o nome especificado.
DisplayObjectContainer
 Inherited
Retorna a posição de índice de uma ocorrência-filho de DisplayObject.
DisplayObjectContainer
 Inherited
Recupera o objeto que possui foco no momento.
UIComponent
  
Recupera o item no índice especificado.
ComboBox
 Inherited
Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas.
DisplayObject
 Inherited
Recupera uma propriedade de estilo definida na cadeia de pesquisa de estilo do componente.
UIComponent
  
[estático] Recupera o mapa de estilos padrão do componente atual.
ComboBox
 Inherited
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais).
DisplayObject
 Inherited
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais).
DisplayObject
 Inherited
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.
EventDispatcher
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Marca uma propriedade como inválida e redesenha o componente no quadro seguinte, a não ser que especificado de outra forma.
UIComponent
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
  
Recupera a string exibida pelo renderizador para o objeto de dados especificado com base nas propriedades labelField e labelFunction.
ComboBox
 Inherited
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco.
DisplayObject
 Inherited
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais).
DisplayObject
 Inherited
[estático] Mescla os estilos de várias classes em um objeto.
UIComponent
 Inherited
Move o componente até a posição especificada em seu pai.
UIComponent
  
Abre a lista suspensa.
ComboBox
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
  
Remove todos os itens da lista.
ComboBox
 Inherited
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um ouvinte do objeto EventDispatcher.
EventDispatcher
  
Remove o item especificado da lista.
ComboBox
  
Remove o item na posição de índice especificada.
ComboBox
  
Substitui o item na localização de índice especificada por outro item.
ComboBox
 Inherited
Ativa um teclado virtual.
InteractiveObject
 Inherited
Altera a posição de um filho existente no contêiner de objetos de exibição.
DisplayObjectContainer
 Inherited
Define o foco para este componente.
UIComponent
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
setSize(width:Number, height:Number):void
Define o componente para a largura e altura especificadas.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Define uma propriedade de estilo nesta ocorrência do componente.
UIComponent
  
sortItems(... sortArgs):*
Classifica os elementos do provedor de dados atual.
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos.
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permite ao usuário arrastar a entidade gráfica especificada.
Sprite
 Inherited
startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque.
Sprite
 Inherited
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto.
DisplayObjectContainer
 Inherited
Finaliza o método startDrag().
Sprite
 Inherited
stopTouchDrag(touchPointID:int):void
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque.
Sprite
 Inherited
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos.
DisplayObjectContainer
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
 Inherited
Valida e atualiza as propriedades e o layout deste objeto, redesenhando-o se necessário.
UIComponent
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
 Inherited
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.
EventDispatcher
Métodos protegidos
 MétodoDefinido por
 Inherited
Retorna o estilo especificado para um componente, considerando todos os estilos definidos nos níveis global, de componente e de ocorrência.
UIComponent
Eventos
 Evento Resumo Definido por
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.EventDispatcher
 InheritedDespachado quando um objeto de exibição é adicionado à lista de exibição.DisplayObject
 InheritedDespachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido.DisplayObject
  Despachado quando o usuário altera a seleção do componente ComboBox ou, se o componente ComboBox for editável, sempre que o usuário fizer um pressionamento de tecla no campo de texto.ComboBox
 InheritedDespachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
  Despachado quando a lista suspensa é dispensada por algum motivo.ComboBox
 Inherited
    contextMenu
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.InteractiveObject
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto.InteractiveObject
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.EventDispatcher
 InheritedDespachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true".InteractiveObject
  Despachado se a propriedade editável for definida como true e o usuário pressionar a tecla Enter enquanto estiver digitando em um campo de texto editável.ComboBox
 Inherited[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro.DisplayObject
 Inherited[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual.DisplayObject
 InheritedDespachado depois que um objeto de exibição ganha foco.InteractiveObject
 InheritedDespachado depois que um objeto de exibição perde o foco.InteractiveObject
 Inherited[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts.DisplayObject
 InheritedEnviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque.InteractiveObject
 InheritedDespachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque).InteractiveObject
 InheritedDespachado depois que a visibilidade do componente muda de visível para invisível.UIComponent
 InheritedEste evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IMEInteractiveObject
   Define o valor da propriedade de tipo de um objeto de evento itemRollOut.ComboBox
   Define o valor da propriedade de tipo de um objeto de evento itemRollOver.ComboBox
 InheritedDespachado quando o usuário pressiona uma tecla.InteractiveObject
 InheritedDespachado quando o usuário tenta alterar o foco usando a navegação pelo teclado.InteractiveObject
 InheritedDespachado quando o usuário solta uma tecla.InteractiveObject
 InheritedDespachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário tenta alterar o foco usando um dispositivo apontador.InteractiveObject
 InheritedDespachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado após a movimentação do componente.UIComponent
 InheritedDespachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar.InteractiveObject
 InheritedDespachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop().InteractiveObject
 InheritedDespachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite.InteractiveObject
 InheritedDespachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite.InteractiveObject
 InheritedDespachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite.InteractiveObject
 InheritedDespachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().InteractiveObject
 InheritedDespachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().InteractiveObject
  Despachado quando o usuário clica no botão suspenso para exibir a lista suspensa.ComboBox
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela.InteractiveObject
 Inherited
    proximityEnd
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade.InteractiveObject
 Inherited
    proximityOut
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela).InteractiveObject
 InheritedEnviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject.InteractiveObject
 InheritedDespachado quando um objeto de exibição está prestes a ser removido da lista de exibição.DisplayObject
 InheritedDespachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido.DisplayObject
 Inherited[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada.DisplayObject
 InheritedDespachado após o redimensionamento do componente.UIComponent
 InheritedDespachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
  Despachado quando o usuário rola pela lista suspensa do componente ComboBox.ComboBox
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto.InteractiveObject
 InheritedDespachado depois que a visibilidade do componente muda de invisível para visível.UIComponent
 InheritedDespachado imediatamente depois que o teclado virtual é elevado.InteractiveObject
 InheritedDespachado imediatamente antes de o teclado virtual ser elevado.InteractiveObject
 InheritedDespachado imediatamente depois que o teclado virtual é baixado.InteractiveObject
 InheritedDespachado quando o valor do sinalizador tabChildren do objeto é alterado.InteractiveObject
 InheritedDespachado quando o sinalizador tabEnabled do objeto é alterado.InteractiveObject
 InheritedDespachado quando o valor da propriedade tabIndex do objeto é alterado.InteractiveObject
 InheritedDespachado quando um usuário introduz um ou vários caracteres do texto.InteractiveObject
 InheritedDespachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque).InteractiveObject
 InheritedDespachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque).InteractiveObject
 InheritedDespachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido.InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
Estilos

Os estilos são comuns ou associados a um tema específico. Se o estilo for comum, poderá ser usado com qualquer tema. Se o estilo for associado a um tema específico, só poderá ser usado se o seu aplicativo usar esse tema.

Estilos comuns
 Estilo Descrição Definido por
  
buttonWidth
Tipo: Number Formato: Length
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O espaço que separa a borda direita do componente do texto que representa o item selecionado, em pixels. O botão é parte da capa do plano de fundo. O valor padrão é 24.
ComboBox
  
cellRenderer
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A classe que fornece o renderizador de célula para cada item no componente. O valor padrão é fl.controls.listClasses.CellRenderer.
ComboBox
  
contentPadding
Tipo: Number Formato: Length
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Preenchimento entre o conteúdo (componente e barra de rolagem) e a borda externa do plano de fundo, em pixels. O valor padrão é 3.
ComboBox
  
disabledAlpha
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O valor de alfa para definir a lista quando a propriedade enabled for false. O valor padrão é 0.5.
ComboBox
  
disabledSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando a propriedade enabled do componente está definida como false. O valor padrão é ComboBox_disabledSkin.
ComboBox
 InheritedTipo: flash.text.TextFormat
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O objeto TextFormat a ser usado para renderizar o rótulo do componente quando o botão é desabilitado.
UIComponent
  
downArrowDisabledSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando ele está desativado. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_disabledSkin.
ComboBox
  
downArrowDownSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando você clica no botão de seta. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_downSkin.
ComboBox
  
downArrowOverSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_overSkin.
ComboBox
  
downArrowUpSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_upSkin.
ComboBox
  
downSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando o mouse está desativado. O valor padrão é ComboBox_downSkin.
ComboBox
  
embedFonts
Tipo: Boolean
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Indica se os contornos de fonte incorporados são usados para renderizar o campo de texto. Se esse valor for true, o Flash Player renderiza o campo de texto usando contornos de fontes incorporados. Se esse valor for false, o Flash Player renderiza o campo de texto usando fontes do dispositivo.

Se você definir a propriedade embedFonts como verdadeira para o campo de texto, é necessário especificar uma fonte para esse texto usando a propriedade fonte de um objeto TextFormat, que é aplicado ao campo de texto. Se a fonte especificada não estiver incorporada ao arquivo SWF, o texto não será exibido.

O valor padrão é false.
ComboBox
 InheritedTipo: Number Formato: Length
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O preenchimento que separa os limites externos do componente das arestas externas do indicador de foco, em pixels.
UIComponent
 InheritedTipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa a ser usada para exibir indicadores de foco.
UIComponent
  
overSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando o mouse está sobre o componente. O valor padrão é ComboBox_overSkin.
ComboBox
  
repeatDelay
Tipo: Number Formato: Time
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O número de milissegundos a aguardar depois que o evento buttonDown é despachado pela primeira vez, antes do envio de um segundo evento buttonDown. O valor padrão é 500.
ComboBox
  
repeatInterval
Tipo: Number Formato: Time
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O intervalo, em milissegundos, entre os eventos buttonDown despachados depois do atraso especificado pelo estilo repeatDelay. O valor padrão é 35.
ComboBox
 InheritedTipo: flash.text.TextFormat
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O objeto TextFormat a ser usado para renderizar o rótulo do componente.
UIComponent
  
textPadding
Tipo: Number Formato: Length
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O espaço que separa a borda do texto que representa o item selecionado, em pixels. O valor padrão é 3.
ComboBox
  
thumbArrowUpSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa usada para a miniatura da barra de rolagem. O valor padrão é ScrollThumb_upSkin.
ComboBox
  
thumbDisabledSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa usada para indicar o estado desativado da miniatura. O valor padrão é ScrollThumb_upSkin.
ComboBox
  
thumbDownSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando você clica na miniatura. O valor padrão é ScrollThumb_downSkin.
ComboBox
  
thumbIcon
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como ícone para a miniatura da barra de rolagem. O valor padrão é ScrollBar_thumbIcon.
ComboBox
  
thumbOverSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando o ponteiro do mouse está sobre a miniatura. O valor padrão é ScrollThumb_overSkin.
ComboBox
  
trackDisabledSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa usada para indicar uma faixa desativada. O valor padrão é ScrollTrack_Skin.
ComboBox
  
trackDownSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa usada para indicar o estado para baixo de uma capa desativada. O valor padrão é ScrollTrack_Skin.
ComboBox
  
trackOverSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa usada para indicar o estado do mouse sobre para a faixa de rolagem. O valor padrão é ScrollTrack_Skin.
ComboBox
  
trackUpSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

A capa usada para indicar o estado do mouse para cima para a faixa de rolagem. O valor padrão é ScrollTrack_Skin.
ComboBox
  
upArrowDisabledSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando ele está desativado. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_disabledSkin.
ComboBox
  
upArrowDownSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando você clica no botão de seta. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_downSkin.
ComboBox
  
upArrowOverSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_overSkin.
ComboBox
  
upArrowUpSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_upSkin.
ComboBox
  
upSkin
Tipo: Class
Versão da linguagem: ActionScript 3.0  Versão de produto: Flash CS3  Versões de runtime: Flash9.0.28.0, AIR 1.0

O nome da classe que fornece o plano de fundo para o componente ComboBox. O valor padrão é ComboBox_upSkin.
ComboBox
Constantes públicas
 ConstanteDefinido por
 Inheritedversion : String = "3.0.3.1"
O número de versão dos componentes.
UIComponent
Detalhes da propriedade

dataProvider

propriedade
dataProvider:DataProvider

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o modelo de dados da lista de itens a serem visualizados. Um provedor de dados pode ser compartilhado por vários componentes com base em lista. As alterações no provedor de dados estão imediatamente disponíveis a todos os componentes que o usam como uma fonte de dados.



Implementação
    public function get dataProvider():DataProvider
    public function set dataProvider(value:DataProvider):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir demonstra como definir um provedor de dados para um ComboBox. Quando o provedor de dados é atualizado, o ComboBox é atualizado:
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

propriedade 
dropdown:List  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém uma referência ao componente List que o componente ComboBox contém. O subcomponente List não tem ocorrências em ComboBox, até que seja necessário exibi-lo. No entanto, a lista é criada quando a propriedade dropdown é acessada.



Implementação
    public function get dropdown():List

dropdownWidth

propriedade 
dropdownWidth:Number

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define a largura máxima da lista suspensa, em pixels. O valor padrão dessa propriedade é a largura do componente ComboBox (a largura a ocorrência de TextInput mais a largura da ocorrência de BaseButton).

O valor padrão é 100.



Implementação
    public function get dropdownWidth():Number
    public function set dropdownWidth(value:Number):void

Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria uma ocorrência do componente ComboBox e define a propriedade dropdownWidth com base no valor de um componente 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;
}
O exemplo a seguir cria uma ocorrência do componente ComboBox e define sua propriedade dropdownWidth com base no comprimento do texto na lista suspensa:
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

propriedade 
editable:Boolean

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define um valor booliano que indica se o componente ComboBox é editável ou somente leitura. Um valor true indica que o componente ComboBox é editável; um valor false indica que ele não é editável.

Em um componente ComboBox editável, um usuário pode inserir valores na caixa de texto que não é exibida na lista suspensa. A caixa de texto exibe o texto do item na lista. Se um componente ComboBox não é editável, o texto não pode ser inserido na caixa de texto.

O valor padrão é false.



Implementação
    public function get editable():Boolean
    public function set editable(value:Boolean):void

Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria uma nova ocorrência editável de ComboBox, que adiciona os itens personalizados ao provedor de dados, quando o evento enter é despachado:
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

propriedade 
labelField:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o nome do campo no objeto dataProvider a ser exibido como rótulo para o campo TextInput e a lista suspensa.

Por padrão, o componente exibe a propriedade label de cada item de dataProvider. Se os itens de dataProvider não tiverem uma propriedade label, é possível definir a propriedade labelField para usar uma propriedade diferente.

Observação: a propriedade labelField não é usada, se a propriedade labelFunction estiver definida como uma função de retorno.

O valor padrão é "label".



Implementação
    public function get labelField():String
    public function set labelField(value:String):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria um ComboBox e define a propriedade labelField para definir um campo de texto personalizado:
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

propriedade 
labelFunction:Function

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define a função a ser usada para obter o rótulo do item.

Por padrão, o componente exibe a propriedade label para um item de dataProvider. No entanto, alguns conjuntos de dados podem não ter um campo label ou podem não ter um campo com um valor que pode ser usado como rótulo, sem modificação. Por exemplo, um determinado conjunto de dados pode armazenar nomes completos, mas pode mantê-los nos campos lastName e firstName. Nesse caso, essa propriedade poderia ser usada para definir uma função de retorno que concatene os valores dos campos lastName e firstName em uma string de nome completo a ser exibida.

Observação: a propriedade labelField não é usada, se a propriedade labelFunction estiver definida como uma função de retorno.



Implementação
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Esse exemplo define a propriedade labelFunction de uma lista como uma função que formata a string a ser exibida em cada célula:
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) + ")";
}
O exemplo a seguir cria um ComboBox e define a propriedade labelField para definir um campo de texto personalizado:
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

propriedade 
length:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém o número de itens na lista. Essa propriedade pertence a um componente List, mas pode ser acessado em uma ocorrência de ComboBox.

O valor padrão é 0.



Implementação
    public function get length():int

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria um ComboBox e define sua propriedade rowCount com base na quantidade de itens em ComboBox:
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);
O exemplo a seguir cria um ComboBox e define sua propriedade rowCount com base na quantidade de itens em ComboBox:
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

propriedade 
prompt:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o prompt para o componente ComboBox. Esse prompt é uma string exibia na parte de TextInput do ComboBox, quando selectedIndex for -1. Geralmente, é uma string como "Selecione um...". Se um prompt não for definido, o componente ComboBox define a propriedade selectedIndex como 0 e exibe o primeiro item na propriedade dataProvider.

O valor padrão é "".



Implementação
    public function get prompt():String
    public function set prompt(value:String):void

Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria uma ocorrência do componente ComboBox, define sua propriedade prompt e redimensiona a caixa de combinação para ajustar a largura do texto do prompt:
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);
O exemplo a seguir cria uma ocorrência do componente ComboBox e define a propriedade prompt com base no número de itens em seu provedor de dados:
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

propriedade 
restrict:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define os caracteres que um usuário pode inserir no campo de texto. Se o valor da propriedade restrict for uma string de caracteres, você poderá digitar apenas os caracteres da string no campo de texto. A string é lida da esquerda para a direita. Se o valor da propriedade restrict for null, você poderá digitar qualquer caractere. Se o valor da propriedade restrict for uma string vazia (""), não é possível inserir qualquer caractere. É possível especificar um intervalo usando o caractere hífen (-). Isso restringe apenas a interação com o usuário; um script pode colocar qualquer caractere no campo de texto.

O valor padrão é null.



Implementação
    public function get restrict():String
    public function set restrict(value:String):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria um componente editável ComboBox, que permite que apenas as cores hexadecimais sejam inseridas usando a propriedade 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

propriedade 
rowCount:uint

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o número máximo de linhas que podem aparecer em uma lista suspensa que não tem uma barra de rolagem. Se o número de itens na lista suspensa exceder esse valor, a lista é redimensionada e uma barra de rolagem é exibida, se necessário. Se o número de itens na lista suspensa for menor do que esse valor, a lista suspensa é redimensionada para acomodar o número de itens que ela contém.

Esse comportamento é diferente do componente List, que sempre mostra o número de linhas especificado pela propriedade rowCount, mesmo que inclua espaços vazios.

O valor padrão é 5.



Implementação
    public function get rowCount():uint
    public function set rowCount(value:uint):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir usa um componente Slider para definir a propriedade rowCount para um componente 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

propriedade 
selectedIndex:int

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o índice do item selecionado em uma lista de seleção única. Uma lista de seleção única é uma lista na qual apenas um item pode ser selecionado por vez.

Um valor de -1 indica que nenhum item é selecionado; se várias seleções forem feitas, esse valor é igual ao índice do item que foi selecionado por último no grupo de itens selecionados.

Quando o ActionScript é usado para definir essa propriedade, o item no índice especificado substitui a seleção atual. Quando a seleção é alterada de forma programática, o objeto de evento change não é despachado.

O valor padrão é 0.



Implementação
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir usa um componente Slider para definir a propriedade selectedIndex da ocorrência do componente 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;
}
O exemplo a seguir cria um componente ComboBox e exibe o valor de sua propriedade selectedIndex em um rótulo no Palco:
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

propriedade 
selectedItem:Object

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o valor do item selecionado na lista suspensa. Se o usuário inserir texto na caixa de texto de um componente ComboBox editável, a propriedade selectedItem fica indefinida. Essa propriedade tem um valor apenas se o usuário selecionar um item ou se o ActionScript for usado para selecionar um item na lista suspensa. Se o componente ComboBox não for editável, o valor da propriedade selectedItem é sempre válido. Se não houver itens na lista suspensa de um componente ComboBox editável, o valor dessa propriedade é null.

O valor padrão é null.



Implementação
    public function get selectedItem():Object
    public function set selectedItem(value:Object):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir usa um componente Button para copiar itens de um ComboBox para um componente 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;
    }
}
O exemplo a seguir usa dois componentes Label para exibir o item atualmente selecionado em um 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

propriedade 
selectedLabel:String  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém a string exibida na parte TextInput do componente ComboBox. Esse valor é calculado a partir dos dados usando a propriedade labelField ou labelFunction.



Implementação
    public function get selectedLabel():String

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir usa um componente Label para exibir a propriedade selectedLabel para um 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

propriedade 
text:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o texto que a caixa de texto contém em um componente ComboBox editável. Para componentes ComboBox que não são editáveis, esse valor é somente leitura.

O valor padrão é "".



Implementação
    public function get text():String
    public function set text(value:String):void

Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria um ComboBox editável que exibe o texto que está sendo inserido em uma ocorrência do componente 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

propriedade 
textField:fl.controls:TextInput  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém uma referência ao componente TextInput que o componente ComboBox contém. Use essa propriedade para acessar e manipular o componente TextInput subjacente. Por exemplo, é possível usar essa propriedade para alterar a seleção da caixa de texto ou para restringir o conjunto de caracteres que podem ser inseridos nessa caixa de texto.



Implementação
    public function get textField():fl.controls:TextInput

Exemplo  ( Como usar este exemplo )
O exemplo a seguir cria um componente ComboBox editável que permite que apenas 8 caracteres sejam inseridos:
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);
O exemplo a seguir cria um ComboBox e define o formato do texto para o campo de texto incorporado:
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);
O exemplo a seguir cria uma ocorrência do componente ComboBox e define um formato de texto personalizado para o campo de texto incorporado e o menu suspenso:
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

propriedade 
value:String  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém o rótulo de um item em um componente ComboBox editável. Para o componente ComboBox que não é editável, essa propriedade obtém os dados que o item contém.



Implementação
    public function get value():String

Exemplo  ( Como usar este exemplo )
O exemplo a seguir usa um componente Label para exibir a propriedade value para um ComboBox editável:
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;
}
Detalhes do construtor

ComboBox

()Construtor
public function ComboBox()

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Cria uma nova ocorrência do componente ComboBox.

Detalhes do método

addItem

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Acrescenta um item ao final da lista de itens.

Um item deve conter as propriedades label e data; no entanto, os itens que contêm outras propriedades também podem ser adicionados à lista. Por padrão, a propriedade label de um item é usada para exibir o rótulo da linha; a propriedade data é usada para armazenar os dados da linha.

Parâmetros

item:Object — O item a ser adicionado ao provedor de dados.

Elementos da API relacionados

addItemAt

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Insere um item na lista, na localização de índice especificada. Os índices de itens no local de índice especificado ou depois dele, são incrementados em 1.

Parâmetros

item:Object — O item a ser adicionado à lista.
 
index:uint — O índice ao qual o item é adicionado.

Elementos da API relacionados

close

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Fecha a lista suspensa.

Observação: chamar esse método envia o evento close. Se o componente ComboBox já estiver fechado, chamar esse método não tem efeitos.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria uma ocorrência do componente ComboBox e alterna a visibilidade do menu suspenso usando os métodos open() e 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étodo 
public function getItemAt(index:uint):Object

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Recupera o item no índice especificado.

Parâmetros

index:uint — O índice do item a ser recuperado.

Retorna
Object — O objeto no local de índice especificado.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria uma ocorrência do componente ComboBox e a usa para repetição e o método getItemAt() para copiar itens de ComboBox para um componente 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étodo 
public static function getStyleDefinition():Object

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Recupera o mapa de estilos padrão do componente atual. O mapa de estilos contém o tipo que é apropriado para o componente, de acordo com o estilo que o componente usa. Por exemplo, o estilo disabledTextFormat contém o valor null ou um objeto TextFormat. Você pode usar estes estilos e chamar setStyle() no componente atual. O código a seguir substitui o estilo disabledTextFormat padrão no componente especificado:

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

Retorna
Object — Objeto de estilos padrão.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria um navegador de estilo para várias classes de componentes:
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étodo 
public function itemToLabel(item:Object):String

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Recupera a string exibida pelo renderizador para o objeto de dados determinado com base nas propriedades labelField e labelFunction.

Observação: labelField não é usado se a propriedade labelFunction estiver definida como uma função de retorno.

Parâmetros

item:Object — O objeto a ser renderizado.

Retorna
String — A string a ser exibida com base nos dados.

Elementos da API relacionados

open

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Abre a lista suspensa.

Observação: chamar esse método envia o evento open. Se o componente ComboBox já estiver aberto, chamar esse método não tem efeitos.

Elementos da API relacionados

removeAll

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Remove todos os itens da lista.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir usa uma ocorrência do componente Button para remover os itens de um ComboBox usando o método 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étodo 
public function removeItem(item:Object):Object

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Remove o item especificado da lista.

Parâmetros

item:Object — O item a ser removido.

Retorna
Object — O item que foi removido.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir demonstra como remover um item de uma lista, depois que ele é clicado:
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étodo 
public function removeItemAt(index:uint):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Remove o item na posição de índice especificada. Os locais de índice de itens com índices maiores do que o avanço de índice especificado na matriz por 1.

Esse é um método do componente List que está disponível em uma ocorrência do componente ComboBox.

Parâmetros

index:uint — Índice do item a ser removido.


Lança
RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.

Elementos da API relacionados

replaceItemAt

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

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Substitui o item na localização de índice especificada por outro item. Esse método modifica o provedor de dados do componente List. Se o provedor de dados for compartilhado com outros elementos, os dados fornecidos a esses componentes também são atualizados.

Parâmetros

item:Object — O item para substituir o item no local de índice especificado.
 
index:uint — A posição de índice do item a ser substituído.

Retorna
Object — O item que foi substituído.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir substitui o item selecionado atualmente em um ComboBox pelo valor de um componente TextInput usando o método 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étodo 
public function sortItems(... sortArgs):*

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Classifica os elementos do provedor de dados atual. Esse método realiza uma classificação com base nos valores Unicode dos elementos. ASCII é um subconjunto de Unicode.

Parâmetros

... sortArgs — Os argumentos contra os quais ocorre a classificação.

Retorna
* — O valor de retorno depende de os parâmetros serem passados a esse método ou não. Para obter mais informações, consulte o método Array.sort(). Observe que esse método retorna 0, quando o parâmetro sortArgs é definido como Array.UNIQUESORT.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir classifica os itens em uma ocorrência ComboBox de acordo com cada texto de rótulo de item. Os itens a serem classificados são passados a uma função de classificação, upperCaseSort(), que compara duas propriedades label dos itens e retorna um valor booliano, dependendo da ordem na qual o item deve aparecer.
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étodo 
public function sortItemsOn(field:String, options:Object = null):*

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos.

Parâmetros

field:String — O campo no qual classificar.
 
options:Object (default = null) — Classificar argumentos que são usados para substituir o comportamento de classificação padrão. Separe dois ou mais argumentos com o operador OR (|) bit a bit.

Retorna
* — O valor de retorno depende de os parâmetros serem passados a esse método ou não. Para obter mais informações, consulte o método Array.sortOn(). Observe que esse método retorna 0, quando o parâmetro sortOption está definido como Array.UNIQUESORT.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

Os exemplos a seguir têm base na ocorrência de ComboBox com nome cb, que contém quatro elementos rotulados como "Maçãs", "Bananas", "cerejas" e "Uvas":
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

O exemplo a seguir cria um ComboBox e classifica os itens usando o método 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;
}
Detalhe do evento

change

Evento
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.CHANGE

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando o usuário altera a seleção do componente ComboBox ou, se o componente ComboBox for editável, sempre que o usuário fizer um pressionamento de tecla no campo de texto.

Observação: Enquanto a tabela abaixo especifica que o evento change surge em bolha, isto não acontece para o controle fl.controls.ComboBox.

A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblestrue
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO objeto que tem seus respectivos valores modificados. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.

close

Evento  
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.CLOSE

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando a lista suspensa é dispensada por algum motivo.

A constante Event.CLOSE define o valor da propriedade type de um objeto de evento close.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO objeto cuja conexão foi fechada.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria uma ocorrência do componente ComboBox e alterna a visibilidade do menu suspenso usando os métodos open() e 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();
    }
}

Elementos da API relacionados

enter

Evento  
Tipo do objeto de evento: fl.events.ComponentEvent
propriedade ComponentEvent.type = fl.events.ComponentEvent.ENTER

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado se a propriedade editable for definida como true e o usuário pressionar a tecla Enter enquanto digita em campo de texto editável.

Define o valor da propriedade type de um objeto de evento enter.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
targetO objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento.

itemRollOut

Evento  
Tipo do objeto de evento: fl.events.ListEvent
propriedade ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OUT

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando o usuário rola o ponteiro para fora de um item no componente.

Define o valor da propriedade type de um objeto de evento itemRollOut.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
columnIndexO índice com base em zero da coluna que contém o renderizador.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
indexO índice com base em zero do DataProvider que contém o renderizador.
itemUma referência aos dados que pertencem ao renderizador.
rowIndexO índice com base em zero da linha que contém o renderizador.
targetO objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento.

Elementos da API relacionados

itemRollOver

Evento  
Tipo do objeto de evento: fl.events.ListEvent
propriedade ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OVER

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando o usuário rola o ponteiro sobre um item no componente.

Define o valor da propriedade type de um objeto de evento itemRollOver.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
columnIndexO índice com base em zero da coluna que contém o renderizador.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
indexO índice com base em zero do DataProvider que contém o renderizador.
itemUma referência aos dados que pertencem ao renderizador.
rowIndexO índice com base em zero da linha que contém o renderizador.
targetO objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria um componente ComboBox que é aberto quando o usuário rola sobre a ocorrência do componente:
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;
}

Elementos da API relacionados

open

Evento  
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.OPEN

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando o usuário clica no botão suspenso para exibir a lista suspensa. Despachado também quando o usuário clica no campo de texto, se o componente ComboBox não for editável.

A constante Event.OPEN define o valor da propriedade type de um objeto de evento open.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO objeto de rede que abriu uma conexão.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir cria um componente Button que abre uma lista suspensa do componente ComboBox usando o método open(). O menu suspenso fecha depois de 1 segundo, a menos que o usuário posicione o mouse sobre ComboBox ou seu menu suspenso:
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();
}

Elementos da API relacionados

scroll

Evento  
Tipo do objeto de evento: fl.events.ScrollEvent
propriedade ScrollEvent.type = fl.events.ScrollEvent.SCROLL

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Despachado quando o usuário rola pela lista suspensa do componente ComboBox.

Define o valor da propriedade type de um objeto de evento scroll.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
delta1; um valor que indica a quantidade de rolagem realizada.
direçãovertical; a direção da barra de rolagem.
position0; a posição da miniatura da barra de rolagem após ela ser movida.
targetO objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento.
ComboBoxExample.as

Este exemplo demonstra como ouvir os eventos de um ComboBox.
  1. Arraste um ComboBox para o palco e nomeie-o cb.
  2. Salve esse código como ComboBoxExample.as no mesmo diretório de FLA.
  3. Defina DocumentClass em FLA como 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 ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.