| Paquete | fl.controls |
| Clase | public class ComboBox |
| Herencia | ComboBox UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implementa | IFocusManagerComponent |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9.0.28.0 |
Véase también
| Propiedad | Definido por | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
| DisplayObject | |
![]() | alpha : Number
Indica el valor de transparencia alfa del objeto especificado.
| DisplayObject | |
![]() | blendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
| DisplayObject | |
![]() | buttonMode : Boolean
Especifica el modo de botón de este elemento sprite.
| Sprite | |
![]() | cacheAsBitmap : 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 | |
![]() | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
| Object | |
![]() | contextMenu : 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 | ||
![]() | doubleClickEnabled : 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 | ||
![]() | dropTarget : 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 | ||
![]() | enabled : Boolean
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.
| UIComponent | |
![]() | filters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
| DisplayObject | |
![]() | focusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
| UIComponent | |
![]() | focusManager : IFocusManager
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.
| UIComponent | |
![]() | focusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
| InteractiveObject | |
![]() | graphics : Graphics
[read-only]
Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.
| Sprite | |
![]() | height : Number
Obtiene o define la altura del componente, expresada en píxeles.
| UIComponent | |
![]() | hitArea : 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 | ||
![]() | loaderInfo : 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 | |
![]() | mask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
| DisplayObject | |
![]() | mouseChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para ratón.
| DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
| InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
| UIComponent | |
![]() | mouseX : Number
[read-only]
Indica la coordenada x de la posición del ratón en píxeles.
| DisplayObject | |
![]() | mouseY : Number
[read-only]
Indica la coordenada y de la posición del ratón en píxeles.
| DisplayObject | |
![]() | name : String
Indica el nombre de instancia de DisplayObject.
| DisplayObject | |
![]() | numChildren : int
[read-only]
Devuelve el número de elementos secundarios de este objeto.
| DisplayObjectContainer | |
![]() | opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
| DisplayObject | |
![]() | parent : 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 | ||
![]() | prototype : 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 | ||
![]() | root : 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 | |
![]() | rotation : 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 | ||
![]() | scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
| DisplayObject | |
![]() | scaleX : Number
Multiplica la anchura actual del componente por un factor de escala.
| UIComponent | |
![]() | scaleY : Number
Multiplica la altura actual del componente por un factor de escala.
| UIComponent | |
![]() | scrollRect : 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 | ||
![]() | soundTransform : SoundTransform
Controla el sonido dentro de este elemento sprite.
| Sprite | |
![]() | stage : Stage
[read-only]
El escenario del objeto de visualización.
| DisplayObject | |
![]() | tabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
| DisplayObjectContainer | |
![]() | tabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
| InteractiveObject | |
![]() | tabIndex : 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 | ||
![]() | textSnapshot : TextSnapshot
[read-only]
Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() | transform : 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 | |
![]() | useHandCursor : 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 | ||
![]() | version : String = "3.0.0.15"
Número de versión de los componentes.
| UIComponent | |
![]() | visible : Boolean
Obtiene o define un valor que indica si la instancia del componente actual es visible.
| UIComponent | |
![]() | width : Number
Obtiene o define la anchura del componente, expresada en píxeles.
| UIComponent | |
![]() | x : 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 | |
![]() | y : 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étodo | Definido por | ||
|---|---|---|---|
|
ComboBox()
Crea una instancia de componente ComboBox nueva.
| ComboBox | ||
![]() |
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() |
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() |
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 | ||
|
Inserta un elemento en la lista en la ubicación del índice especificado.
| ComboBox | ||
![]() |
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 | |
![]() |
Elimina una propiedad de estilo de esta instancia de componente.
| UIComponent | |
|
Cierra la lista desplegable.
| ComboBox | ||
![]() |
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
| DisplayObjectContainer | |
![]() |
Distribuye un evento en el flujo del evento.
| EventDispatcher | |
![]() |
Muestra u oculta el indicador de selección en este componente.
| UIComponent | |
![]() |
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.
| UIComponent | |
![]() |
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
| DisplayObject | |
![]() |
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
| DisplayObjectContainer | |
![]() |
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
| DisplayObjectContainer | |
![]() |
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
| DisplayObjectContainer | |
![]() |
Recupera el objeto que está seleccionado actualmente.
| UIComponent | |
|
Recupera el elemento en el índice especificado.
| ComboBox | ||
![]() |
Devuelve una matriz de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() |
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 | |
![]() |
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 | ||
![]() |
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
| DisplayObject | |
![]() |
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
| EventDispatcher | |
![]() |
Indica si un objeto tiene definida una propiedad especificada.
| Object | |
![]() |
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 | |
![]() |
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 | |
![]() |
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 | |
![]() |
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 | ||
![]() |
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
| DisplayObject | |
![]() |
[static]
Combina los estilos de varias clases en un objeto.
| UIComponent | |
![]() |
Mueve el componente a la posición especificada dentro de su elemento principal.
| UIComponent | |
|
Abre la lista desplegable.
| ComboBox | ||
![]() |
Indica si existe la propiedad especificada y si es enumerable.
| Object | |
|
Elimina todos los elementos de la lista.
| ComboBox | ||
![]() |
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() |
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
| DisplayObjectContainer | |
![]() |
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 | ||
![]() |
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
| DisplayObjectContainer | |
![]() |
Selecciona este componente.
| UIComponent | |
![]() |
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
| Object | |
![]() |
Define el componente en la anchura y altura especificadas.
| UIComponent | |
![]() |
Define una propiedad de estilo en esta instancia de componente.
| UIComponent | |
|
Ordena los elementos del proveedor de datos actual.
| ComboBox | ||
|
Ordena los elementos del proveedor de datos actual por uno o varios de sus campos.
| ComboBox | ||
![]() |
Permite al usuario arrastrar el elemento sprite especificado.
| Sprite | |
![]() |
Finaliza el método startDrag().
| Sprite | |
![]() |
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
| DisplayObjectContainer | |
![]() |
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 | |
![]() |
Devuelve la representación de cadena del objeto especificado.
| Object | |
![]() |
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.
| UIComponent | |
![]() |
Devuelve el valor simple del objeto especificado.
| Object | |
![]() |
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 | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
![]() | Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo. | EventDispatcher | ||
![]() | Se distribuye cuando un objeto de visualización se añade a la lista de visualización. | DisplayObject | ||
![]() | 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 | |||
![]() | 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 | |||
![]() | Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo. | EventDispatcher | ||
![]() | 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 | |||
![]() | Se distribuye cuando la cabeza lectora entra en un nuevo fotograma. | DisplayObject | ||
![]() | Se distribuye después de que un objeto de visualización quede seleccionado. | InteractiveObject | ||
![]() | Se distribuye después de que un objeto de visualización deje de estar seleccionado. | InteractiveObject | ||
![]() | 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 | |||
![]() | Se distribuye cuando el usuario pulsa una tecla. | InteractiveObject | ||
![]() | Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado. | InteractiveObject | ||
![]() | Se distribuye cuando el usuario suelta una tecla. | InteractiveObject | ||
![]() | 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 | ||
![]() | Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización. | InteractiveObject | ||
![]() | Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject. | InteractiveObject | ||
![]() | Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | ||
![]() | 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 | ||
![]() | 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 | ||
![]() | Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player. | InteractiveObject | ||
![]() | 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 | |||
![]() | Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización. | DisplayObject | ||
![]() | 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 | ||
![]() | Se distribuye cuando la lista de visualización se va a actualizar y mostrar. | DisplayObject | ||
![]() | Se distribuye cuando se cambia el tamaño del componente. | UIComponent | ||
![]() | Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | ||
![]() | 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 | |||
![]() | Se distribuye cuando la visibilidad del componente cambia de invisible a visible. | UIComponent | ||
![]() | Se distribuye cuando cambia el valor del indicador tabChildren del objeto. | InteractiveObject | ||
![]() | Se distribuye cuando cambia el indicador tabEnabled del objeto. | InteractiveObject | ||
![]() | Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto. | InteractiveObject | ||
| 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 | ||
![]() | 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 false. | ComboBox | ||
![]() | 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 | ||
![]() | 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 | ||
![]() | 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 | ||
| dataProvider | propiedad |
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.
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void
Véase también
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 | propiedad |
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.
public function get dropdown():List
| dropdownWidth | propiedad |
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.
public function get dropdownWidth():Number
public function set dropdownWidth(value:Number):void
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;
}
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();
| editable | propiedad |
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.
public function get editable():Boolean
public function set editable(value:Boolean):void
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);
}
| labelField | propiedad |
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".
public function get labelField():String
public function set labelField(value:String):void
Véase también
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);
| labelFunction | propiedad |
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.
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Véase también
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) + ")";
}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;
}
| length | propiedad |
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.
public function get length():int
Véase también
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);
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);
| prompt | propiedad |
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 "".
public function get prompt():String
public function set prompt(value:String):void
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);
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);
| restrict | propiedad |
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.
public function get restrict():String
public function set restrict(value:String):void
Véase también
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 | propiedad |
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.
public function get rowCount():uint
public function set rowCount(value:uint):void
Véase también
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;
}
| selectedIndex | propiedad |
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.
public function get selectedIndex():int
public function set selectedIndex(value:int):void
Véase también
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;
}
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;
}
| selectedItem | propiedad |
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.
public function get selectedItem():Object
public function set selectedItem(value:Object):void
Véase también
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;
}
}
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 | propiedad |
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.
public function get selectedLabel():String
Véase también
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;
}
| text | propiedad |
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 "".
public function get text():String
public function set text(value:String):void
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 | propiedad |
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.
public function get textField():TextInput
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.textField.maxChars = 8; myComboBox.move(10, 10); addChild(myComboBox);
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);
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 | propiedad |
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.
public function get value():String
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;
}
| 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.
| 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
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.
|
Object — Objeto en la ubicación del índice especificado.
|
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
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.
|
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
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.
|
Object — Elemento que se ha eliminado.
|
Véase también
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.
|
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.
|
Object — Elemento que se ha sustituido.
|
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.
|
* — 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
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 (|).
|
* — 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
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, ApplessortItemsOn():
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;
}
| change | Evento |
flash.events.Event
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 propiedadtype de un objeto de evento change.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto 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 |
flash.events.Event
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 propiedadtype de un objeto de evento close.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto cuya conexión se ha cerrado. |
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 |
fl.events.ComponentEvent
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.
type para un objeto de evento enter.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Error 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 |
fl.events.ListEvent
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 propiedadtype para un objeto de evento itemRollOut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
columnIndex | Índice basado en cero de la columna que contiene el procesador. |
currentTarget | Objeto 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. |
item | Referencia a los datos que pertenecen al procesador. |
rowIndex | Índice basado en cero de la fila que contiene el procesador. |
target | Error 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 |
fl.events.ListEvent
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 propiedadtype para un objeto de evento itemRollOver.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
columnIndex | Índice basado en cero de la columna que contiene el procesador. |
currentTarget | Objeto 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. |
item | Referencia a los datos que pertenecen al procesador. |
rowIndex | Índice basado en cero de la fila que contiene el procesador. |
target | Error 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. |
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 |
flash.events.Event
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 propiedadtype de un objeto de evento open.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha abierto una conexión. |
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 |
fl.events.ScrollEvent
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 propiedadtype de un objeto de evento scroll.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
delta | 1; valor que indica la cantidad de desplazamiento que se ha realizado.
|
direction | vertical; dirección de ScrollBar. |
position | 0; posición del deslizador Scrollbar después de que se haya movido. |
target | Error 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. |
Para realizar el ejemplo, siga estos pasos:
cb.
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