Paquetefl.controls
Clasepublic class ComboBox
HerenciaComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implementa IFocusManagerComponent

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

El componente ComboBox contiene una lista desplegable en la que el usuario puede seleccionar un único valor. Su funcionalidad es similar a la del elemento de formulario SELECT en HTML. El componente ComboBox se puede editar; el usuario puede escribir entradas que no estén en la lista en el fragmento TextInput del componente ComboBox.

Ver los ejemplos

Véase también

List
TextInput


Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedbuttonMode : Boolean
Especifica el modo de botón de este elemento sprite.
Sprite
 InheritedcacheAsBitmap : Boolean
Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : ContextMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
  dataProvider : DataProvider
Obtiene o establece el modelo de datos de la lista de elementos que se va a visualizar.
ComboBox
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
  dropdown : List
[read-only] Obtiene una referencia al componente List que contiene el componente ComboBox.
ComboBox
  dropdownWidth : Number
Obtiene o define la anchura máxima de la lista desplegable, expresada en píxeles.
ComboBox
 InheriteddropTarget : DisplayObject
[read-only] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.
Sprite
  editable : Boolean
Obtiene o define un valor booleano que indica si el componente ComboBox se puede editar o es de sólo lectura.
ComboBox
 Inheritedenabled : Boolean
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.
UIComponent
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 InheritedfocusManager : IFocusManager
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.
UIComponent
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.
Sprite
 Inheritedheight : Number
Obtiene o define la altura del componente, expresada en píxeles.
UIComponent
 InheritedhitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite.
Sprite
  labelField : String
Obtiene o define el nombre del campo del objeto dataProvider que se mostrará como etiqueta del campo TextInput y la lista desplegable.
ComboBox
  labelFunction : Function
Obtiene o define la función que se utilizará para obtener la etiqueta del elemento.
ComboBox
  length : int
[read-only] Obtiene el número de elementos de la lista.
ComboBox
 InheritedloaderInfo : LoaderInfo
[read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
 InheritedmouseChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para ratón.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 InheritedmouseX : Number
[read-only] Indica la coordenada x de la posición del ratón en píxeles.
DisplayObject
 InheritedmouseY : Number
[read-only] Indica la coordenada y de la posición del ratón en píxeles.
DisplayObject
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritednumChildren : int
[read-only] Devuelve el número de elementos secundarios de este objeto.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
  prompt : String
Obtiene o define la solicitud para el componente ComboBox.
ComboBox
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  restrict : String
Obtiene o define los caracteres que puede introducir un usuario en el campo de texto.
ComboBox
 Inheritedroot : DisplayObject
[read-only] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
  rowCount : uint
Obtiene o define el número máximo de filas que pueden aparecer una lista desplegable sin barra de desplazamiento.
ComboBox
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Multiplica la anchura actual del componente por un factor de escala.
UIComponent
 InheritedscaleY : Number
Multiplica la altura actual del componente por un factor de escala.
UIComponent
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
  selectedIndex : int
Obtiene o define el índice del elemento que está seleccionado en una lista de selección única.
ComboBox
  selectedItem : Object
Obtiene o define el valor del elemento que está seleccionado en la lista desplegable.
ComboBox
  selectedLabel : String
[read-only] Obtiene la cadena que aparece en el fragmento de TextInput del componente ComboBox.
ComboBox
 InheritedsoundTransform : SoundTransform
Controla el sonido dentro de este elemento sprite.
Sprite
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 InheritedtabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF.
InteractiveObject
  text : String
Obtiene o define el texto que incluye el cuadro de texto en un componente ComboBox editable.
ComboBox
  textField : TextInput
[read-only] Obtiene una referencia al componente TextInput incluido en el componente ComboBox.
ComboBox
 InheritedtextSnapshot : TextSnapshot
[read-only] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
 InheriteduseHandCursor : Boolean
Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.
Sprite
  value : String
[read-only] Obtiene la etiqueta de un elemento en un componente ComboBox editable.
ComboBox
 Inheritedversion : String = "3.0.0.15"
Número de versión de los componentes.
UIComponent
 Inheritedvisible : Boolean
Obtiene o define un valor que indica si la instancia del componente actual es visible.
UIComponent
 Inheritedwidth : Number
Obtiene o define la anchura del componente, expresada en píxeles.
UIComponent
 Inheritedx : Number
Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal.
UIComponent
 Inheritedy : Number
Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.
UIComponent
Métodos públicos
 MétodoDefinido por
  
Crea una instancia de componente ComboBox nueva.
ComboBox
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
  
Anexa un elemento al final de la lista de elementos.
ComboBox
  
addItemAt(item:Object, index:uint):void
Inserta un elemento en la lista en la ubicación del índice especificado.
ComboBox
 Inherited
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado.
DisplayObjectContainer
 Inherited
Elimina una propiedad de estilo de esta instancia de componente.
UIComponent
  
Cierra la lista desplegable.
ComboBox
 Inherited
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
DisplayObjectContainer
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
Muestra u oculta el indicador de selección en este componente.
UIComponent
 Inherited
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
 Inherited
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
DisplayObjectContainer
 Inherited
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
DisplayObjectContainer
 Inherited
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
DisplayObjectContainer
 Inherited
Recupera el objeto que está seleccionado actualmente.
UIComponent
  
Recupera el elemento en el índice especificado.
ComboBox
 Inherited
Devuelve una matriz de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
 Inherited
Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.
UIComponent
  
[static] Devuelve la asignación de estilos predeterminada del componente actual.
ComboBox
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario.
UIComponent
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
  
Recupera la cadena que muestra el procesador para el objeto de datos especificado según las propiedades labelField y labelFunction.
ComboBox
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
[static] Combina los estilos de varias clases en un objeto.
UIComponent
 Inherited
Mueve el componente a la posición especificada dentro de su elemento principal.
UIComponent
  
Abre la lista desplegable.
ComboBox
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
  
Elimina todos los elementos de la lista.
ComboBox
 Inherited
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
  
Elimina el elemento especificado de la lista.
ComboBox
  
Elimina el elemento en la posición del índice especificado.
ComboBox
  
Sustituye por otro el elemento en la ubicación del índice especificado.
ComboBox
 Inherited
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
DisplayObjectContainer
 Inherited
Selecciona este componente.
UIComponent
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
setSize(width:Number, height:Number):void
Define el componente en la anchura y altura especificadas.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Define una propiedad de estilo en esta instancia de componente.
UIComponent
  
sortItems(... sortArgs):*
Ordena los elementos del proveedor de datos actual.
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
Ordena los elementos del proveedor de datos actual por uno o varios de sus campos.
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permite al usuario arrastrar el elemento sprite especificado.
Sprite
 Inherited
Finaliza el método startDrag().
Sprite
 Inherited
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios.
DisplayObjectContainer
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.
UIComponent
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
   Se distribuye cuando el usuario cambia la selección en el componente ComboBox, o bien, si éste se puede editar, cada vez que se pulse una tecla en el campo de texto.ComboBox
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
   Se distribuye cuando se cierra la lista desplegable por cualquier motivo.ComboBox
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.InteractiveObject
   Se distribuye si la propiedad editable se define como true y el usuario presiona la tecla Intro al escribir en el campo de texto editable.ComboBox
 Inherited Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited Se distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 Inherited Se distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited Se distribuye cuando la visibilidad del componente cambia de visible a invisible.UIComponent
   Se distribuye cuando el usuario deja de pasar el puntero del ratón sobre un elemento del componente.ComboBox
   Se distribuye cuando el usuario pasa el puntero del ratón sobre un elemento del componente.ComboBox
 Inherited Se distribuye cuando el usuario pulsa una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando se mueve el componente.UIComponent
   Se distribuye cuando el usuario hace clic en el botón de lista desplegable para mostrar la lista.ComboBox
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando la lista de visualización se va a actualizar y mostrar.DisplayObject
 Inherited Se distribuye cuando se cambia el tamaño del componente.UIComponent
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
   Se distribuye cuando el usuario se desplaza por la lista desplegable del componente ComboBox.ComboBox
 Inherited Se distribuye cuando la visibilidad del componente cambia de invisible a visible.UIComponent
 Inherited Se distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.InteractiveObject
Estilos
 Estilo Descripción Definido por
  
buttonWidth
Tipo: Number   Formato: Length
El espacio que separa el borde derecho del componente del texto que representa el elemento seleccionado, expresado en píxeles. El botón forma parte del aspecto del fondo. El valor predeterminado es 24.
ComboBox
  
cellRenderer
Tipo: Class
La clase que proporciona el procesador de celdas para cada elemento del componente. El valor predeterminado es fl.controls.listClasses.CellRenderer.
ComboBox
  
contentPadding
Tipo: Number   Formato: Length
El relleno entre el contenido (el componente y la barra de desplazamiento) y el borde externo del fondo, expresado en píxeles. El valor predeterminado es 3.
ComboBox
  
disabledAlpha
Tipo: Class
El valor alfa que se definirá en la lista cuando la propiedad enabled sea false. El valor predeterminado es 0.5.
ComboBox
  
disabledSkin
Tipo: Class
El nombre de la clase que proporciona el fondo que aparece en el componente ComboBox cuando la propiedad enabled del componente se establece en false. El valor predeterminado es ComboBox_disabledSkin.
ComboBox
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.
UIComponent
  
downArrowDisabledSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento cuando está desactivado. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowDown_disabledSkin.
ComboBox
  
downArrowDownSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento cuando se hace clic en el botón de flecha. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowDown_downSkin.
ComboBox
  
downArrowOverSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento cuando el puntero del ratón está sobre el botón de flecha. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowDown_overSkin.
ComboBox
  
downArrowUpSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowDown_upSkin.
ComboBox
  
downSkin
Tipo: Class
El nombre de la clase que proporciona el fondo que aparece en el componente ComboBox cuando el ratón está seleccionado. El valor predeterminado es ComboBox_downSkin.
ComboBox
  
embedFonts
Tipo: Boolean
Indica si se utilizan contornos de fuentes incorporadas para representar el campo de texto. Si este valor es true, Flash Player representa el campo de texto utilizando contornos de fuentes incorporados. Si es false, Flash Player representa el campo de texto mediante fuentes del dispositivo.

Si define la propiedad embedFonts como true para un campo de texto, debe especificar una fuente para ese texto mediante la propiedad font de un objeto TextFormat aplicado al campo de texto. Si la fuente especificada no está incorporada en el archivo SWF, el texto no se mostrará.

El valor predeterminado es false.
ComboBox
 Inherited Tipo: Number   Formato: Length
El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.
UIComponent
 Inherited Tipo: Class
El aspecto que se utilizará para mostrar los indicadores de selección.
UIComponent
  
overSkin
Tipo: Class
El nombre de la clase que proporciona el fondo que aparece en el componente ComboBox cuando el ratón está sobre éste. El valor predeterminado es ComboBox_overSkin.
ComboBox
  
repeatDelay
Tipo: Number   Formato: Time
El número de milisegundos de espera después de que el evento buttonDown se distribuyera por primera vez antes de enviar un segundo evento buttonDown. El valor predeterminado es 500.
ComboBox
  
repeatInterval
Tipo: Number   Formato: Time
El intervalo, en milisegundos, entre los eventos buttonDown que se distribuyen después del retardo especificado por el estilo repeatDelay. El valor predeterminado es 35.
ComboBox
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente.
UIComponent
  
textPadding
Tipo: Number   Formato: Length
El espacio que separa el borde del texto que representa el elemento seleccionado, expresado en píxeles. El valor predeterminado es 3.
ComboBox
  
thumbArrowUpSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el deslizador de la barra de desplazamiento. El valor predeterminado es ScrollThumb_upSkin.
ComboBox
  
thumbDisabledSkin
Tipo: Class
El aspecto que se utiliza para indicar el estado desactivado del deslizador. El valor predeterminado es ScrollThumb_upSkin.
ComboBox
  
thumbDownSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el deslizador de la barra de desplazamiento cuando se hace clic en el deslizador. El valor predeterminado es ScrollThumb_downSkin.
ComboBox
  
thumbIcon
Tipo: Class
Nombre de la clase que se utiliza como icono para el deslizador de la barra de desplazamiento. El valor predeterminado es ScrollBar_thumbIcon.
ComboBox
  
thumbOverSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el deslizador de la barra de desplazamiento cuando el puntero del ratón está sobre el deslizador. El valor predeterminado es ScrollThumb_overSkin.
ComboBox
  
trackDisabledSkin
Tipo: Class
El aspecto utilizado para indicar una guía desactivada. El valor predeterminado es ScrollTrack_Skin.
ComboBox
  
trackDownSkin
Tipo: Class
El aspecto utilizado para indicar el estado presionado. El valor predeterminado es ScrollTrack_Skin.
ComboBox
  
trackOverSkin
Tipo: Class
El aspecto utilizado para indicar el estado por encima del ratón para la guía de desplazamiento. El valor predeterminado es ScrollTrack_Skin.
ComboBox
  
trackUpSkin
Tipo: Class
El aspecto utilizado para indicar el estado no presionado del ratón para la guía de desplazamiento. El valor predeterminado es ScrollTrack_Skin.
ComboBox
  
upArrowDisabledSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento cuando está desactivada. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowUp_disabledSkin.
ComboBox
  
upArrowDownSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento cuando se hace clic en el botón de flecha. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowUp_downSkin.
ComboBox
  
upArrowOverSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento cuando el puntero del ratón está sobre el botón de flecha. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowUp_overSkin.
ComboBox
  
upArrowUpSkin
Tipo: Class
Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento. Si cambia el aspecto, gráficamente o mediante programación, debe asegurarse de que el nuevo aspecto tiene la misma altura (para las barras de desplazamiento horizontal) o anchura (para las barras de desplazamiento vertical) que la guía de deslizamiento. El valor predeterminado es ScrollArrowUp_upSkin.
ComboBox
  
upSkin
Tipo: Class
El nombre de la clase que proporciona el fondo que aparece en el componente ComboBox. El valor predeterminado es ComboBox_upSkin.
ComboBox
Información sobre propiedades
dataProviderpropiedad
dataProvider:DataProvider  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o establece el modelo de datos de la lista de elementos que se va a visualizar. Varios componentes basados en listas pueden compartir un proveedor de datos. Los cambios realizados en el proveedor de datos están disponibles inmediatamente para todos los componentes que lo utilizan como origen de datos.


Implementación
    public function get dataProvider():DataProvider
    public function set dataProvider(value:DataProvider):void

Véase también


Ejemplo

En el siguiente ejemplo se muestra cómo establecer un proveedor de datos para un componente ComboBox. Cuando se actualice el proveedor de datos, ComboBox también se actualizará:

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++ } );
}
dropdownpropiedad 
dropdown:List  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene una referencia al componente List que contiene el componente ComboBox. No se crea una instancia en el cuadro combinado del subcomponente List hasta que se tenga que visualizar. No obstante, la lista se crea cuando se accede a la propiedad dropdown.


Implementación
    public function get dropdown():List
dropdownWidthpropiedad 
dropdownWidth:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define la anchura máxima de la lista desplegable, expresada en píxeles. El valor predeterminado de esta propiedad es la anchura del componente ComboBox (la anchura de la instancia de TextInput más la anchura de la instancia de BaseButton).

El valor predeterminado es 100.


Implementación
    public function get dropdownWidth():Number
    public function set dropdownWidth(value:Number):void

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se define su propiedad dropdownWidth en función del valor de un 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;
}

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se define su propiedad dropdownWidth en función de la longitud del texto en la lista desplegable:

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();
editablepropiedad 
editable:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define un valor booleano que indica si el componente ComboBox se puede editar o es de sólo lectura. El valor true determina que el componente ComboBox se puede editar; false indica lo contrario.

En un componente ComboBox editable, un usuario puede introducir valores en el cuadro de texto que no aparecen en la lista desplegable. El cuadro de texto muestra el texto del elemento de la lista. Si un componente ComboBox no se puede editar, el texto no se podrá introducir en el cuadro.

El valor predeterminado es false.


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

Ejemplo

En el ejemplo siguiente, se crea una instancia nueva de ComboBox editable que añade elementos personalizados al proveedor de datos al distribuir el evento enter:

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);
}
labelFieldpropiedad 
labelField:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define el nombre del campo del objeto dataProvider que se mostrará como etiqueta del campo TextInput y la lista desplegable.

De forma predeterminada, el componente muestra la propiedad label de cada elemento de dataProvider. Si los elementos de dataProvider no contienen ninguna propiedad label, puede definir labelField para utilizar una propiedad distinta.

Nota: labelField no se utiliza si la propiedad labelFunction se define como una función callback.

El valor predeterminado es "label".


Implementación
    public function get labelField():String
    public function set labelField(value:String):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox y se define la propiedad labelField para establecer un campo de etiqueta 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);
labelFunctionpropiedad 
labelFunction:Function  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define la función que se utilizará para obtener la etiqueta del elemento.

De forma predeterminada, el componente muestra la propiedad label de cada elemento de dataProvider. Sin embargo, es posible que algunos conjuntos de datos no dispongan de un campo label o de un campo cuyo valor se pueda utilizar como una etiqueta sin modificación. Por ejemplo, un conjunto de datos determinado puede almacenar nombres completos, pero mantenerlos en los campos lastName y firstName. En este caso, esta propiedad se puede utilizar para definir una función callback que concatene los valores de los campos lastName y firstName en una cadena de nombre completo que se vaya a mostrar.

Nota: labelField no se utiliza si la propiedad labelFunction se define como una función callback.


Implementación
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

Véase también


Ejemplo

En este ejemplo, se define la propiedad labelFunction de una lista en una función que da formato a la cadena que se muestra en cada celda:
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) + ")";
}

En el ejemplo siguiente, se crea un componente ComboBox y se define la propiedad labelField para establecer un campo de etiqueta 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;
}
lengthpropiedad 
length:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene el número de elementos de la lista. Esta propiedad pertenece al componente List, pero se puede acceder a ella desde una instancia de ComboBox.

El valor predeterminado es 0.


Implementación
    public function get length():int

Véase también


Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox y se define la propiedad rowCount en función del número de elementos contenidos en el componente 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);

En el ejemplo siguiente, se crea un componente ComboBox y se define la propiedad rowCount en función del número de elementos contenidos en el componente 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);
promptpropiedad 
prompt:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define la solicitud para el componente ComboBox. Esta solicitud es una cadena que aparece en el fragmento de TextInput de ComboBox cuando el valor de selectedIndex es -1. Suelen ser cadenas de tipo "Seleccione...". Si no se establece ninguna solicitud, el componente ComboBox define la propiedad selectedIndex como 0 y muestra el primer elemento en la propiedad dataProvider.

El valor predeterminado es "".


Implementación
    public function get prompt():String
    public function set prompt(value:String):void

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente ComboBox, se define la propiedad prompt y se cambia el tamaño del cuadro combinado para ajustar la anchura del texto de solicitud:

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);

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se define su propiedad prompt en función del número de elementos contenidos en el proveedor de datos:

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);
restrictpropiedad 
restrict:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define los caracteres que puede introducir un usuario en el campo de texto. Si el valor de la propiedad restrict es una cadena de caracteres, puede introducir caracteres solamente en la cadena del campo de texto. La cadena se lee de izquierda a derecha. Si el valor de la propiedad restrict es null, puede introducir cualquier carácter. Si el valor de la propiedad restrict es una cadena vacía (""), no se puede introducir ningún carácter. Se puede especificar un rango utilizando el carácter de guión (-). Esto sólo limita la interacción del usuario; un script puede introducir cualquier carácter en el campo de texto.

El valor predeterminado es null.


Implementación
    public function get restrict():String
    public function set restrict(value:String):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox editable que sólo permite introducir colores hexadecimales mediante la propiedad 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 = "";
}
rowCountpropiedad 
rowCount:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define el número máximo de filas que pueden aparecer una lista desplegable sin barra de desplazamiento. Si el número de elementos de la lista desplegable sobrepasa este valor, se ajustará el tamaño de la lista y se mostrará una barra de desplazamiento, si es necesario. Si el número de elementos de la lista desplegable es inferior a este valor, se ajustará el tamaño de la lista para acomodar el número de elementos que contiene.

Este comportamiento difiere del componente List, que siempre muestra el número de filas que especifique la propiedad rowCount aunque quede espacio vacío.

El valor predeterminado es 5.


Implementación
    public function get rowCount():uint
    public function set rowCount(value:uint):void

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente Slider para definir la propiedad rowCount para un 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;
}
selectedIndexpropiedad 
selectedIndex:int  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define el índice del elemento que está seleccionado en una lista de selección única. En las listas de selección única sólo se puede seleccionar un elemento cada vez.

El valor de -1 determina que no se ha seleccionado ningún elemento; si se realizan varias selecciones, este valor es igual al índice del elemento seleccionado en último lugar en el grupo de elementos seleccionados.

Si ActionScript se emplea para definir esta propiedad, el elemento del índice especificado sustituye la selección actual. Si la selección se cambia mediante programación, no se distribuye ningún objeto de evento change.

El valor predeterminado es 0.


Implementación
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente Slider para definir la propiedad selectedIndex de la instancia de 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;
}

En el ejemplo siguiente, se crea un componente ComboBox y se muestra el valor de su propiedad selectedIndex en una etiqueta en el escenario:

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;
}
selectedItempropiedad 
selectedItem:Object  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define el valor del elemento que está seleccionado en la lista desplegable. Si el usuario introduce texto en el cuadro de texto de un componente ComboBox editable, la propiedad selectedItem es undefined. Esta propiedad tiene un valor sólo si el usuario selecciona un elemento o si ActionScript se utiliza para seleccionar un elemento de la lista desplegable. Si el componente ComboBox no se puede editar, el valor de la propiedad selectedItem siempre es válido. Si no hay elementos en la lista desplegable de un componente ComboBox editable, el valor de esta propiedad será null.

El valor predeterminado es null.


Implementación
    public function get selectedItem():Object
    public function set selectedItem(value:Object):void

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente Button para copiar elementos de un componente ComboBox a un 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;
    }
}

En el ejemplo siguiente, se utilizan dos componentes Label para mostrar el elemento seleccionado en un componente 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;
}
selectedLabelpropiedad 
selectedLabel:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene la cadena que aparece en el fragmento de TextInput del componente ComboBox. Este valor se calcula a partir de los datos mediante la propiedad labelField o labelFunction.


Implementación
    public function get selectedLabel():String

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente Label para mostrar la propiedad selectedLabel para un componente 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;
}
textpropiedad 
text:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene o define el texto que incluye el cuadro de texto en un componente ComboBox editable. Para los componentes de ComboBox que no se pueden editar, este valor es de sólo lectura.

El valor predeterminado es "".


Implementación
    public function get text():String
    public function set text(value:String):void

Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox editable que muestra el texto que se introduce en una instancia de 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;
}
textFieldpropiedad 
textField:TextInput  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene una referencia al componente TextInput incluido en el componente ComboBox. Utilice esta propiedad para acceder y manipular el componente subyacente TextInput. Por ejemplo, puede utilizar esta propiedad para cambiar la selección del cuadro de texto o limitar el conjunto de caracteres que se pueden introducir en él.


Implementación
    public function get textField():TextInput

Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox editable que permite introducir sólo 8 caracteres:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);

En el ejemplo siguiente, se crea un componente ComboBox y se define el formato de texto para el 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);

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se define un formato de texto personalizado para el campo de texto incorporado y el menú desplegable:

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);
valuepropiedad 
value:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene la etiqueta de un elemento en un componente ComboBox editable. Para los componentes ComboBox que no se puedan editar, esta propiedad obtiene los datos que contiene el elemento.


Implementación
    public function get value():String

Ejemplo

En el ejemplo siguiente, se utiliza un componente Label para mostrar la propiedad value para un componente ComboBox editable:

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;
}
Información sobre constructores
ComboBox()constructor
public function ComboBox()

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Crea una instancia de componente ComboBox nueva.

Información sobre métodos
addItem()método
public function addItem(item:Object):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Anexa un elemento al final de la lista de elementos.

Un elemento debe incluir propiedades label y data; no obstante, los elementos que contienen otras propiedades también se pueden añadir a la lista. De forma predeterminada, la propiedad label de un elemento se emplea para mostrar la etiqueta de la fila; la propiedad data se utiliza para almacenar los datos de la fila.

Parámetros

item:Object — Elemento que se va a añadir al proveedor de datos.

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Inserta un elemento en la lista en la ubicación del índice especificado. Los índices de los elementos tras la ubicación del índice especificado o en la misma se incrementan en 1.

Parámetros

item:Object — Elemento que se va a añadir a la lista.
 
index:uint — Índice al que se va a añadir el elemento.

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Cierra la lista desplegable.

Nota: al llamar a este método, se distribuye el evento close. Si ComboBox ya está cerrado, la llamada a este método no surtirá efecto.

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se activa la visibilidad del menú desplegable mediante los métodos open() y 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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Recupera el elemento en el índice especificado.

Parámetros

index:uint — Índice del elemento que se va a recuperar.

Valor devuelto
Object — Objeto en la ubicación del índice especificado.

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se utiliza un bucle "for" y el método getItemAt() para copiar elementos del componente ComboBox a un 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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Devuelve la asignación de estilos predeterminada del componente actual. La asignación de estilos contiene el tipo adecuado para el componente, en función del estilo que ese componente utilice. Por ejemplo, el estilo disabledTextFormat contiene un valor null o un objeto TextFormat. Puede utilizar estos estilos y llamar a setStyle() en el componente actual. El código siguiente sustituye el estilo predeterminado disabledTextFormat en el componente especificado:

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

Valor devuelto
Object — Objeto de estilos predeterminados.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un navegador de estilos para varias clases 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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Recupera la cadena que muestra el procesador para el objeto de datos especificado según las propiedades labelField y labelFunction.

Nota: labelField no se utiliza si la propiedad labelFunction se define como una función callback.

Parámetros

item:Object — Objeto que se va a representar.

Valor devuelto
String — Cadena que se va a mostrar según los datos.

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Abre la lista desplegable.

Nota: al llamar a este método, se distribuye el evento open. Si el componente ComboBox ya está abierto, la llamada a este método no surtirá efecto.

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Elimina todos los elementos de la lista.

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza una instancia de componente Button para eliminar los elementos de un componente ComboBox mediante el 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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Elimina el elemento especificado de la lista.

Parámetros

item:Object — Elemento que se va a eliminar.

Valor devuelto
Object — Elemento que se ha eliminado.

Véase también


Ejemplo

En el siguiente ejemplo, se muestra cómo eliminar un elemento de una lista una vez que se hace clic en él:
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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Elimina el elemento en la posición del índice especificado. Las ubicaciones de índice de los elementos cuyos índices son superiores al índice especificado avanzan en la matriz por 1.

Éste es un método del componente List que está disponible desde una instancia del componente ComboBox.

Parámetros

index:uint — Índice del elemento que se va a eliminar.


Emite
RangeError — El índice especificado es inferior a 0 o mayor o igual que la longitud del proveedor de datos.

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Sustituye por otro el elemento en la ubicación del índice especificado. Este método modifica el proveedor de datos del componente List. Si el proveedor de datos se comparte con otros componentes, los datos que se proporcionan a estos componentes también se actualizan.

Parámetros

item:Object — Elemento que sustituirá al elemento de la ubicación del índice especificado.
 
index:uint — Posición del índice del elemento que se va a reemplazar.

Valor devuelto
Object — Elemento que se ha sustituido.

Ejemplo

En el ejemplo siguiente, se reemplaza el elemento seleccionado en un componente ComboBox por el valor de un componente TextInput mediante el 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):*

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Ordena los elementos del proveedor de datos actual. Este método lleva a cabo una ordenación en función de los valores Unicode de los elementos. ASCII es un subconjunto de Unicode.

Parámetros

... sortArgs — Argumentos con los que se va a realizar la ordenación.

Valor devuelto
* — El valor devuelto depende de si se pasa algún parámetro a este método. Para obtener más información, consulte el método Array.sort(). Observe que este método devuelve 0 si el parámetro sortArgs se define como Array.UNIQUESORT.

Véase también


Ejemplo

En el ejemplo siguiente, se ordenan los elementos de una instancia ComboBox en función del texto de etiqueta de cada elemento. Los elementos que se van a ordenar se pasan a una función de ordenación personalizada, upperCaseSort(), que compara dos propiedades label del elemento y devuelve un valor booleano en función del orden en el que deba aparecer el mismo:
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):*

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Ordena los elementos del proveedor de datos actual por uno o varios de sus campos.

Parámetros

field:String — Campo en el que se va a realizar la ordenación.
 
options:Object (default = null) — Argumentos de ordenación que se utilizan para anular el comportamiento de ordenación predeterminado. Separe dos o más argumentos con el operador OR en modo bit (|).

Valor devuelto
* — El valor devuelto depende de si se pasa algún parámetro a este método. Para obtener más información, consulte el método Array.sortOn(). Observe que este método devuelve 0 si el parámetro sortOption se define como Array.UNIQUESORT.

Véase también


Ejemplo

Los ejemplos siguientes se basan en una instancia de ComboBox denominada cb, que contiene cuatro elementos denominados "Apples", "Bananas", "cherries" y "Grapes":
import fl.controls.ComboBox;

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

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

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

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

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

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

En el ejemplo siguiente, se crea un componente ComboBox y se ordenan los elementos mediante el 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;
}
Información sobre eventos
change Evento
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.CHANGE

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando el usuario cambia la selección en el componente ComboBox, o bien, si éste se puede editar, cada vez que se pulse una tecla en el campo de texto.

Define el valor de la propiedad type de un objeto de evento change.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto al que se ha modificado su valor. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
close Evento  
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.CLOSE

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando se cierra la lista desplegable por cualquier motivo.

Define el valor de la propiedad type de un objeto de evento close.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto cuya conexión se ha cerrado.

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente ComboBox y se activa la visibilidad del menú desplegable mediante los métodos open() y 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();
    }
}

Véase también

enter Evento  
Tipo de objeto de evento: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye si la propiedad editable se define como true y el usuario presiona la tecla Intro al escribir en el campo de texto editable.

Define el valor de la propiedad type para un objeto de evento enter.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.
itemRollOut Evento  
Tipo de objeto de evento: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OUT

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando el usuario deja de pasar el puntero del ratón sobre un elemento del componente.

Define el valor de la propiedad type para un objeto de evento itemRollOut.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
columnIndexÍndice basado en cero de la columna que contiene el procesador.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
indexÍndice basado en cero de DataProvider que contiene el procesador.
itemReferencia a los datos que pertenecen al procesador.
rowIndexÍndice basado en cero de la fila que contiene el procesador.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Véase también

itemRollOver Evento  
Tipo de objeto de evento: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OVER

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando el usuario pasa el puntero del ratón sobre un elemento del componente.

Define el valor de la propiedad type para un objeto de evento itemRollOver.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
columnIndexÍndice basado en cero de la columna que contiene el procesador.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
indexÍndice basado en cero de DataProvider que contiene el procesador.
itemReferencia a los datos que pertenecen al procesador.
rowIndexÍndice basado en cero de la fila que contiene el procesador.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Ejemplo

En el ejemplo siguiente, se crea un componente ComboBox que se abre cuando el usuario sitúa el puntero del ratón sobre la instancia de 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;
}

Véase también

open Evento  
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.OPEN

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando el usuario hace clic en el botón de lista desplegable para mostrar la lista. Asimismo, se distribuye cuando el usuario hace clic en el campo de texto, si el componente ComboBox no se puede editar.

Define el valor de la propiedad type de un objeto de evento open.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto de red que ha abierto una conexión.

Ejemplo

En el ejemplo siguiente, se crea un componente Button que abre la lista desplegable de un componente ComboBox mediante el método open(). El menú desplegable se cierra transcurrido 1 segundo, a no ser que el usuario sitúe el ratón sobre el componente ComboBox o su menú desplegable:

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();
}

Véase también

scroll Evento  
Tipo de objeto de evento: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando el usuario se desplaza por la lista desplegable del componente ComboBox.

Define el valor de la propiedad type de un objeto de evento scroll.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
delta1; valor que indica la cantidad de desplazamiento que se ha realizado.
directionvertical; dirección de ScrollBar.
position0; posición del deslizador Scrollbar después de que se haya movido.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.
Ejemplos Cómo utilizar los ejemplos
ComboBoxExample.as

En este ejemplo, se muestra cómo detectar los eventos de una instancia ComboBox.

Para realizar el ejemplo, siga estos pasos:

  1. Arrastre un componente ComboBox al escenario y asígnele el nombre cb.
  2. Guarde este código como ComboBoxExample.as en el mismo directorio que el archivo FLA.
  3. Defina la clase Document como ComboBoxExample en el archivo FLA.
package
{
    import fl.controls.ComboBox;
    import flash.display.Sprite
    import flash.events.Event;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class ComboBoxExample extends Sprite
    {
        private var tf:TextField;

        public function ComboBoxExample() {
            setupComboBox();
            setupTextField();
        }

        private function setupTextField():void {
            tf = new TextField();
            tf.x = 230;
            tf.y = 15;
            tf.autoSize = TextFieldAutoSize.LEFT;
            addChild(tf);
        }

        private function setupComboBox():void {
            cb.setSize(200, 22);
            cb.prompt = "Select a Credit Card";
            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);
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/controls/ComboBox.html