SelectableList

Paquete	fl.controls
Clase	public class SelectableList
Herencia	SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementa	IFocusManagerComponent
Subclases	DataGrid, List, TileList

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

SelectableList es la clase base de todos los componentes basados en listas como, por ejemplo, List, TileList, DataGrid y ComboBox. Esta clase ofrece métodos y propiedades que se emplean para la representación y el diseño de filas, así como para definir estilos de barra de desplazamiento y proveedores de datos.

Nota: esta clase no crea ningún componente; sólo se expone para que pueda ampliarse.

Elementos de API relacionados

fl.controls.DataGrid
fl.controls.List
fl.controls.TileList
fl.data.DataProvider

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		accessibilityImplementation : AccessibilityImplementation La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties Las opciones de accesibilidad actuales para este objeto de visualización.	DisplayObject
		allowMultipleSelection : Boolean Obtiene un valor booleano que indica si se pueden seleccionar a la vez varios elementos de lista.	SelectableList
		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
		blendShader : Shader [solo escritura] Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo.	DisplayObject
		buttonMode : Boolean Especifica el modo de botón de este elemento sprite.	Sprite
		cacheAsBitmap : Boolean Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización.	DisplayObject
		cacheAsBitmapMatrix : Matrix Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true.	DisplayObject
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		contextMenu : NativeMenu 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.	SelectableList
		doubleClickEnabled : Boolean Especifica si este objeto recibe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [solo lectura] 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
		enabled : Boolean Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.	UIComponent
		filters : Array Conjunto indexado 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 [solo lectura] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.	Sprite
		height : Number [override] 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
		horizontalLineScrollSize : Number Obtiene o define un valor que describe la cantidad de contenido que se va a desplazar en sentido horizontal cuando se hace clic en una flecha de desplazamiento.	BaseScrollPane
		horizontalPageScrollSize : Number Obtiene o define el recuento de píxeles de desplazamiento de la guía de la barra de desplazamiento horizontal al presionar el cuadro de desplazamiento.	BaseScrollPane
		horizontalScrollBar : ScrollBar [solo lectura] Obtiene una referencia a la barra de desplazamiento horizontal.	BaseScrollPane
		horizontalScrollPolicy : String Obtiene o define un valor que indica el estado de la barra de desplazamiento horizontal.	BaseScrollPane
		horizontalScrollPosition : Number Obtiene o define un valor que describe la posición horizontal de la barra de desplazamiento horizontal en el panel de desplazamiento en píxeles.	BaseScrollPane
		length : uint [solo lectura] Obtiene el número de elementos del proveedor de datos.	SelectableList
		loaderInfo : LoaderInfo [solo lectura] 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
		maxHorizontalScrollPosition : Number [override] Obtiene o define el número de píxeles que la lista desplaza a la derecha, si la propiedad horizontalScrollPolicy se define como ScrollPolicy.ON.	SelectableList
		maxVerticalScrollPosition : Number [solo lectura] Obtiene la posición máxima de desplazamiento vertical para el contenido actual en píxeles.	BaseScrollPane
		metaData : Object Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4.	DisplayObject
		mouseChildren : Boolean Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes.	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 [solo lectura] Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		mouseY : Number [solo lectura] Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		name : String Indica el nombre de instancia de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.	InteractiveObject
		numChildren : int [solo lectura] 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 [solo lectura] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.	DisplayObject
		root : DisplayObject [solo lectura] 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
		rotationX : Number Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationY : Number Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationZ : Number Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rowCount : uint [solo lectura] Obtiene el número de filas que son al menos parcialmente visibles en la lista.	SelectableList
		scale9Grid : Rectangle La cuadrícula de escala aplicada actualmente.	DisplayObject
		scaleX : Number [override] Multiplica la anchura actual del componente por un factor de escala.	UIComponent
		scaleY : Number [override] Multiplica la altura actual del componente por un factor de escala.	UIComponent
		scaleZ : Number Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto.	DisplayObject
		scrollRect : Rectangle Los límites del rectángulo de desplazamiento del objeto de visualización.	DisplayObject
		selectable : Boolean Obtiene o define un valor booleano que indica si se pueden seleccionar los elementos de la lista.	SelectableList
		selectedIndex : int Obtiene o define el índice del elemento que está seleccionado en una lista de selección única.	SelectableList
		selectedIndices : Array Obtiene o define un conjunto que contiene los elementos que se han seleccionado en una lista de selección múltiple.	SelectableList
		selectedItem : Object Obtiene o define el elemento seleccionado en una lista de selección única.	SelectableList
		selectedItems : Array Obtiene o define un conjunto que contiene los objetos para los elementos que se han seleccionado en una lista de selección múltiple.	SelectableList
		softKeyboard : String Controla la apariencia del teclado virtual.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).	InteractiveObject
		soundTransform : flash.media:SoundTransform Controla el sonido dentro de este elemento sprite.	Sprite
		stage : Stage [solo lectura] 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
		textSnapshot : flash.text:TextSnapshot [solo lectura] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		transform : flash.geom: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
		useBitmapScrolling : Boolean Cuando se define como true, la propiedad cacheAsBitmap para el contenido de desplazamiento se define como true. Si se define como false, este valor se desactiva.	BaseScrollPane
		useHandCursor : Boolean Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el puntero pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.	Sprite
		verticalLineScrollSize : Number Obtiene o define un valor que describe cuántos píxeles se van a desplazar en sentido vertical cuando se hace clic en una flecha de desplazamiento.	BaseScrollPane
		verticalPageScrollSize : Number Obtiene o define el recuento de píxeles de desplazamiento de la guía de la barra de desplazamiento vertical al presionar el cuadro de desplazamiento.	BaseScrollPane
		verticalScrollBar : ScrollBar [solo lectura] Obtiene una referencia a la barra de desplazamiento vertical.	BaseScrollPane
		verticalScrollPolicy : String Obtiene o define un valor que indica el estado de la barra de desplazamiento vertical.	BaseScrollPane
		verticalScrollPosition : Number Obtiene o define un valor que describe la posición vertical de la barra de desplazamiento vertical en el panel de desplazamiento en píxeles.	BaseScrollPane
		visible : Boolean [override] Obtiene o define un valor que indica si la instancia del componente actual es visible.	UIComponent
		width : Number [override] Obtiene o define la anchura del componente, expresada en píxeles.	UIComponent
		x : Number [override] 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 [override] Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.	UIComponent
		z : Number Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D.	DisplayObject

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		SelectableList() Crea una instancia de SelectableList nueva.	SelectableList
		addChild(child:DisplayObject):DisplayObject Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 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
		addItem(item:Object):void Anexa un elemento al final de la lista de elementos.	SelectableList
		addItemAt(item:Object, index:uint):void Inserta un elemento en la lista en la ubicación del índice especificado.	SelectableList
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 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
		clearRendererStyle(name:String, column:int = -1):void Borra un estilo que se define en los procesadores de la lista.	SelectableList
		clearSelection():void Borra el elemento seleccionado en ese momento y define la propiedad selectedIndex como -1.	SelectableList
		clearStyle(style:String):void Elimina una propiedad de estilo de esta instancia de componente.	UIComponent
		contains(child:DisplayObject):Boolean Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		drawFocus(focused:Boolean):void Muestra u oculta el indicador de selección en este componente.	UIComponent
		drawNow():void Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.	UIComponent
		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
		getChildAt(index:int):DisplayObject Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Devuelve el objeto de visualización secundario que sale con el nombre especificado.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Devuelve la posición de índice de una instancia secundaria de DisplayObject.	DisplayObjectContainer
		getFocus():InteractiveObject Recupera el objeto que está seleccionado actualmente.	UIComponent
		getItemAt(index:uint):Object Recupera el elemento en el índice especificado.	SelectableList
		getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int Devuelve el índice del siguiente elemento de dataProvider en el que el primer carácter de la etiqueta coincide con el carácter de cadena especificado.	SelectableList
		getObjectsUnderPoint(point:Point):Array Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		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
		getRendererStyle(name:String, column:int = -1):Object Recupera un estilo que se define en los procesadores de la lista.	SelectableList
		getStyle(style:String):Object Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.	UIComponent
		getStyleDefinition():Object [estática] Devuelve la asignación de estilos predeterminada del componente actual.	SelectableList
		globalToLocal(point:Point):Point Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional.	DisplayObject
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		hitTestObject(obj:DisplayObject):Boolean Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj.	DisplayObject
		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
		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
		invalidateItem(item:Object):void Invalida un procesador de elementos concreto.	SelectableList
		invalidateItemAt(index:uint):void Invalida el procesador del elemento en el índice especificado.	SelectableList
		invalidateList():void Invalida toda la lista y obliga a volver a dibujar los elementos de la lista.	SelectableList
		isItemSelected(item:Object):Boolean Comprueba si el elemento especificado está seleccionado en la lista.	SelectableList
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		itemToCellRenderer(item:Object):ICellRenderer Recupera ICellRenderer para un objeto determinado, si existe.	SelectableList
		itemToLabel(item:Object):String Recupera la cadena que el procesador muestra para el objeto de datos especificado basado en las propiedades de etiqueta del objeto.	SelectableList
		local3DToGlobal(point3d:Vector3D):Point Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario.	DisplayObject
		localToGlobal(point:Point):Point Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).	DisplayObject
		mergeStyles(... list):Object [estática] Combina los estilos de varias clases en un objeto.	UIComponent
		move(x:Number, y:Number):void Mueve el componente a la posición especificada dentro de su elemento principal.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeAll():void Elimina todos los elementos de la lista.	SelectableList
		removeChild(child:DisplayObject):DisplayObject Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		removeItem(item:Object):Object Elimina el elemento especificado de la lista.	SelectableList
		removeItemAt(index:uint):Object Elimina el elemento en la posición del índice especificado.	SelectableList
		replaceItemAt(item:Object, index:uint):Object Sustituye por otro el elemento en la ubicación del índice especificado.	SelectableList
		requestSoftKeyboard():Boolean Muestra un teclado virtual.	InteractiveObject
		scrollToIndex(newCaretIndex:int):void Desplaza la lista hasta el elemento en el índice especificado.	SelectableList
		scrollToSelected():void Desplaza la lista hasta el elemento en la ubicación indicada por el valor actual de la propiedad selectedIndex.	SelectableList
		setChildIndex(child:DisplayObject, index:int):void Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.	DisplayObjectContainer
		setFocus():void Selecciona este componente.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		setRendererStyle(name:String, style:Object, column:uint = 0):void Define un estilo en los procesadores de la lista.	SelectableList
		setSize(width:Number, height:Number):void Define el componente en la anchura y altura especificadas.	UIComponent
		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.	SelectableList
		sortItemsOn(field:String, options:Object = null):* Ordena los elementos del proveedor de datos actual por uno o varios de sus campos.	SelectableList
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado en un dispositivo táctil.	Sprite
		stopAllMovieClips():void Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto.	DisplayObjectContainer
		stopDrag():void Finaliza el método startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Finaliza el método startTouchDrag() para su uso con dispositivos táctiles.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.	DisplayObjectContainer
		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
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		validateNow():void Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.	UIComponent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean 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

Métodos protegidos

Ocultar métodos protegidos heredados

Mostrar métodos protegidos heredados

	Método		Definido por
		getStyleValue(name:String):Object Devuelve el estilo especificado para un componente; tiene en cuenta todos los estilos definidos en el nivel global, en el nivel de componentes y en el nivel de instancias.	UIComponent

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
added	Se distribuye cuando un objeto de visualización se añade a la lista de visualización.	DisplayObject
addedToStage	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
change	Se distribuye cuando se selecciona un elemento diferente de la lista.	SelectableList
clear	Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual.	InteractiveObject
click	Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
contextMenu	Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.	InteractiveObject
copy	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual.	InteractiveObject
cut	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual.	InteractiveObject
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
doubleClick	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
enterFrame	[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.	DisplayObject
exitFrame	[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual.	DisplayObject
focusIn	Se distribuye después de que un objeto de visualización quede seleccionado.	InteractiveObject
focusOut	Se distribuye después de que un objeto de visualización deje de estar seleccionado.	InteractiveObject
frameConstructed	[evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma.	DisplayObject
gestureDirectionalTap	Se distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles.	InteractiveObject
gestureLongPress	Se distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gesturePan	Se distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
gestureRotate	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureSwipe	Se distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureTap	Se distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureZoom	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
hide	Se distribuye cuando la visibilidad del componente cambia de visible a invisible.	UIComponent
imeStartComposition	Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME	InteractiveObject
itemClick	Se distribuye cuando el usuario hace clic en un elemento del componente.	SelectableList
itemDoubleClick	Se distribuye cuando el usuario hace doble clic rápidamente en un elemento del componente.	SelectableList
itemRollOut	Se distribuye cuando el usuario deja de pasar el puntero del ratón sobre un elemento del componente.	SelectableList
itemRollOver	Se distribuye cuando el usuario pasa el puntero del ratón sobre un elemento del componente.	SelectableList
keyDown	Se distribuye cuando el usuario pulsa una tecla.	InteractiveObject
keyFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.	InteractiveObject
keyUp	Se distribuye cuando el usuario suelta una tecla.	InteractiveObject
middleClick	Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
middleMouseDown	Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
middleMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.	InteractiveObject
mouseMove	Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.	InteractiveObject
mouseOut	Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.	InteractiveObject
mouseOver	Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.	InteractiveObject
mouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseWheel	Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject.	InteractiveObject
move	Se distribuye cuando se mueve el componente.	UIComponent
nativeDragComplete	Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.	InteractiveObject
nativeDragDrop	Distribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.	InteractiveObject
nativeDragExit	Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.	InteractiveObject
nativeDragOver	Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.	InteractiveObject
nativeDragStart	Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
paste	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual.	InteractiveObject
proximityBegin	Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityEnd	Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityMove	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad.	InteractiveObject
proximityOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityOver	Se distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOver	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla).	InteractiveObject
releaseOutside	Se distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject.	InteractiveObject
removed	Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.	DisplayObject
removedFromStage	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
render	[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar.	DisplayObject
resize	Se distribuye cuando se cambia el tamaño del componente.	UIComponent
rightClick	Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
rightMouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rightMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rollOut	Se distribuye cuando el usuario dejar de pasar el puntero del ratón sobre el componente.	SelectableList
rollOver	Se distribuye cuando el usuario pasa el puntero del ratón sobre el componente.	SelectableList
scroll	Se distribuye cuando el usuario se desplaza horizontal o verticalmente.	SelectableList
selectAll	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual.	InteractiveObject
show	Se distribuye cuando la visibilidad del componente cambia de invisible a visible.	UIComponent
softKeyboardActivate	Se distribuye inmediatamente una vez mostrado el teclado en pantalla.	InteractiveObject
softKeyboardActivating	Se distribuye inmediatamente antes de que se muestre el teclado en pantalla.	InteractiveObject
softKeyboardDeactivate	Se distribuye inmediatamente una vez oculto el teclado en pantalla.	InteractiveObject
tabChildrenChange	Se distribuye cuando cambia el valor del indicador tabChildren del objeto.	InteractiveObject
tabEnabledChange	Se distribuye cuando cambia el indicador tabEnabled del objeto.	InteractiveObject
tabIndexChange	Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.	InteractiveObject
textInput	Se distribuye cuando un usuario escribe uno o varios caracteres de texto.	InteractiveObject
touchBegin	Se distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo).	InteractiveObject
touchEnd	Se distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
touchMove	Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto.	InteractiveObject
touchOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchTap	Se distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject

Estilos

Los estilos son comunes o están asociados a un tema específico. Si el estilo es común, se puede utilizar con cualquier tema. Si un estilo está asociado a un tema específico, solo se puede utilizar si la aplicación usa dicho tema.

Estilos comunes

Haga clic para obtener más información sobre los estilos

Ocultar estilos heredados

Mostrar estilos heredados

	Descripción	Definido por
cellRenderer	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 La clase que proporciona el procesador de celdas para cada elemento del componente. El valor predeterminado es `fl.contols.listClasses.CellRenderer`.	SelectableList
contentPadding	Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El relleno que separa el borde de la lista de su contenido, expresado en píxeles. El valor predeterminado es `null`.	SelectableList
disabledAlpha	Tipo: Number Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El valor alfa que se definirá en la lista cuando la propiedad `enabled` sea `false`. El valor predeterminado es `null`.	SelectableList
disabledTextFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.	UIComponent
downArrowDisabledSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento cuando está desactivado.	BaseScrollPane
downArrowDownSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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.	BaseScrollPane
downArrowOverSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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.	BaseScrollPane
downArrowUpSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el botón de flecha abajo de la barra de desplazamiento.	BaseScrollPane
focusRectPadding	Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.	UIComponent
focusRectSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto que se utilizará para mostrar los indicadores de selección.	UIComponent
repeatDelay	Tipo: Number Formato: Time Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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`.	BaseScrollPane
repeatInterval	Tipo: Number Formato: Time Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El intervalo, en milisegundos, entre los eventos `buttonDown` que se distribuyen después del retardo especificado por el estilo `repeatDelay`.	BaseScrollPane
skin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 La clase que proporciona el aspecto para el fondo del componente. El valor predeterminado es `List_skin`.	SelectableList
textFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente.	UIComponent
thumbDisabledSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto que se utiliza para indicar el estado desactivado del deslizador.	BaseScrollPane
thumbDownSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el deslizador de la barra de desplazamiento cuando se hace clic en el deslizador.	BaseScrollPane
thumbIcon	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como icono para el deslizador de la barra de desplazamiento.	BaseScrollPane
thumbOverSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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.	BaseScrollPane
thumbUpSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el deslizador de la barra de desplazamiento.	BaseScrollPane
trackDisabledSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto utilizado para indicar una guía desactivada.	BaseScrollPane
trackDownSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto utilizado para indicar el estado presionado.	BaseScrollPane
trackOverSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto utilizado para indicar el estado por encima del ratón para la guía de desplazamiento.	BaseScrollPane
trackUpSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto utilizado para indicar el estado no presionado del ratón para la guía de desplazamiento.	BaseScrollPane
upArrowDisabledSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento cuando está desactivada.	BaseScrollPane
upArrowDownSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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.	BaseScrollPane
upArrowOverSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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.	BaseScrollPane
upArrowUpSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Nombre de la clase que se utiliza como aspecto para el botón de flecha arriba de la barra de desplazamiento.	BaseScrollPane

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		version : String = "3.0.3.1" Número de versión de los componentes.	UIComponent

Información sobre propiedades

allowMultipleSelection

propiedad

allowMultipleSelection:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene un valor booleano que indica si se pueden seleccionar a la vez varios elementos de lista. El valor true especifica que se pueden llevar a cabo varias selecciones al mismo tiempo; false determina que sólo se puede seleccionar un elemento cada vez.

El valor predeterminado es false.

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

Elementos de API relacionados

selectable

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea una instancia List nueva y se realiza el seguimiento de las propiedades selectedIndex y selectedIndices cuando los elementos seleccionados de la lista cambian:


import fl.controls.List;
import fl.data.DataProvider;

var items:XML = <items>
        <item label="Item A" />
        <item label="Item B" />
        <item label="Item C" />
    </items>;

var dp:DataProvider = new DataProvider(items);

var myList:List = new List();
myList.dataProvider = dp;
myList.allowMultipleSelection = true;
myList.move(10, 10);
myList.setSize(320, 240);
myList.addEventListener(Event.CHANGE, changeHandler);
addChild(myList);

function changeHandler(event:Event):void {
    var lst:List = event.currentTarget as List;
    trace("change:");
    trace("\t" + "selectedIndex:", lst.selectedIndex);
    trace("\t" + "selectedIndices:", lst.selectedIndices);
    trace("\t" + "Number selected items:", lst.selectedIndices.length);
}

dataProvider

propiedad

dataProvider:DataProvider

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

El valor predeterminado es null.

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

length

propiedad

length:uint [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene el número de elementos del proveedor de datos.

Implementación
public function get length():uint

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea una instancia de componente List y se define la propiedad rowCount en el número actual de elementos de la lista:


import fl.controls.List;

var myList:List = new List();
myList.addItem({label:"Item A"});
myList.addItem({label:"Item B"});
myList.addItem({label:"Item C"});
myList.addItem({label:"Item D"});
myList.rowCount = myList.length;
myList.move(10, 10);
addChild(myList);

maxHorizontalScrollPosition

propiedad

maxHorizontalScrollPosition:Number[override]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define el número de píxeles que la lista desplaza a la derecha, si la propiedad horizontalScrollPolicy se define como ScrollPolicy.ON.

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

Elementos de API relacionados

fl.containers.BaseScrollPane.horizontalScrollPosition
fl.containers.BaseScrollPane.maxVerticalScrollPosition

rowCount

propiedad

rowCount:uint [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene el número de filas que son al menos parcialmente visibles en la lista.

Nota: esta propiedad se debe anular en cualquier clase que amplíe SelectableList.

El valor predeterminado es 0.

Implementación
public function get rowCount():uint

Ejemplo ( Cómo utilizar este ejemplo )

En este ejemplo, se define el tamaño de una lista y se determina el número posible de filas visibles al realizar el seguimiento de la propiedad rowCount:


import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
var i:uint;
for(i=0; i<100; i++) {
    dp.addItem( { label: "Item " + i } );
}

var list:List = new List();
list.setSize(100,300);
list.dataProvider = dp;
addChild(list);

trace(list.rowCount); // 15

selectable

propiedad

selectable:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica si se pueden seleccionar los elementos de la lista. El valor true determina que se pueden seleccionar los elementos; false indica que no se puede realizar la operación.

El valor predeterminado es true.

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

Elementos de API relacionados

allowMultipleSelection

selectedIndex

propiedad

selectedIndex:int

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

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

Elementos de API relacionados

selectedIndices
selectedItem

Ejemplo ( Cómo utilizar este ejemplo )

Este ejemplo realiza el seguimiento del índice de etiqueta y fila de cualquier elemento de la lista en el que se haga clic:


import fl.controls.List;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
var i:uint;
for (i = 0; i < 5; i++) {
    dp.addItem( { label: "Sample Name"} );
}

var list:List = new List();
list.dataProvider = dp;
list.addEventListener(Event.CHANGE,announceClickedItem)
addChild(list);

function announceClickedItem(e:Event):void {
    trace("You have clicked: " + list.selectedItem.label + " in row " + list.selectedIndex);
}

selectedIndices

propiedad

selectedIndices:Array

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un conjunto que contiene los elementos que se han seleccionado en una lista de selección múltiple.

Para sustituir la selección actual mediante programación, puede realizar una asignación explícita de esta propiedad. Se puede borrar la selección actual definiendo esta propiedad como un conjunto vacío o como un valor de undefined. Si no hay elementos seleccionados en la lista, esta propiedad será undefined.

La secuencia de valores del conjunto refleja el orden en que se han seleccionado los elementos en la lista de selección múltiple. Por ejemplo, si hace clic en el segundo elemento de la lista, después en el tercero y, finalmente, en el último, esta propiedad contiene un conjunto de valores con la siguiente secuencia: [1,2,0].

Implementación
public function get selectedIndices():Array
public function set selectedIndices(value:Array):void

Elementos de API relacionados

allowMultipleSelection
selectedIndex
selectedItems

selectedItem

propiedad

selectedItem:Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define el elemento seleccionado en una lista de selección única. En una lista de selección múltiple en la que se seleccionan varios elementos, esta propiedad incluye el elemento seleccionado en último lugar.

Si no se realiza ninguna selección, el valor de esta propiedad es null.

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

Elementos de API relacionados

selectedIndex
selectedItems

Ejemplo ( Cómo utilizar este ejemplo )

Este ejemplo realiza el seguimiento del índice de etiqueta y fila de cualquier elemento de la lista en el que se haga clic:


import fl.controls.List;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
var i:uint;
for (i = 0; i < 5; i++) {
    dp.addItem( { label: "Sample Name"} );
}

var list:List = new List();
list.dataProvider = dp;
list.addEventListener(Event.CHANGE,announceClickedItem)
addChild(list);

function announceClickedItem(e:Event):void {
    trace("You have clicked: " + list.selectedItem.label + " in row " + list.selectedIndex);
}

selectedItems

propiedad

selectedItems:Array

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un conjunto que contiene los objetos para los elementos que se han seleccionado en una lista de selección múltiple.

En una lista de selección única, el valor de esta propiedad es un conjunto que contiene el único elemento seleccionado. En una lista de selección única, la propiedad allowMultipleSelection se define como false.

Implementación
public function get selectedItems():Array
public function set selectedItems(value:Array):void

Elementos de API relacionados

allowMultipleSelection
selectedIndices
selectedItem

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crean instancias de componente List y se copian los elementos seleccionados de la lista A a la B:


import fl.controls.List;
import fl.data.DataProvider;

var listA:List = new List();
listA.allowMultipleSelection = true;
listA.addItem({label:"Item A"});
listA.addItem({label:"Item B"});
listA.addItem({label:"Item C"});
listA.addItem({label:"Item D"});
listA.addItem({label:"Item E"});
listA.addItem({label:"Item F"});
listA.addItem({label:"Item G"});
listA.move(10, 10);
listA.addEventListener(Event.CHANGE, changeHandler);
addChild(listA);

var listB:List = new List();
listB.selectable = false;
listB.move(120, 10);
addChild(listB);

function changeHandler(event:Event):void {
    if (listA.selectedItems.length > 0) {
        listB.dataProvider = new DataProvider(listA.selectedItems);
    }
}

Información sobre constructores

()

Información sobre

public function SelectableList()

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Crea una instancia de SelectableList nueva.

Información sobre métodos

addItem

()

método

public function addItem(item:Object):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

addItemAt()

addItemAt

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Emite

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

Elementos de API relacionados

addItem()
replaceItemAt()

clearRendererStyle

()

método

public function clearRendererStyle(name:String, column:int = -1):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Borra un estilo que se define en los procesadores de la lista.

Parámetros

	`name:String` — Nombre del estilo que se va a borrar.

	`column:int` (default = `-1`)

Elementos de API relacionados

getRendererStyle()
setRendererStyle()

clearSelection

()

método

public function clearSelection():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Borra el elemento seleccionado en ese momento y define la propiedad selectedIndex como -1.

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea una instancia de componente List y se borran los elementos seleccionados en la lista cuando se hace clic en un componente Button:


import fl.controls.Button;
import fl.controls.List;
import fl.data.DataProvider;

var data:XML = <items>
        <item label="Person A" id="p001" />
        <item label="Person B" id="p002" />
        <item label="Person C" id="p003" />
    </items>;

var dp:DataProvider = new DataProvider(data);

var myList:List = new List();
myList.allowMultipleSelection = false;
myList.dataProvider = dp;
myList.move(10, 10);
myList.selectedIndex = 0;
addChild(myList);

var clearButton:Button = new Button();
clearButton.label = "Clear selection";
clearButton.move(120, 10);
clearButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(clearButton);

function clickHandler(event:MouseEvent):void {
    trace("selectedIndex (before):", myList.selectedIndex);
    myList.clearSelection();
    trace("selectedIndex (after):", myList.selectedIndex);
}

getItemAt

()

método

public function getItemAt(index:uint):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Emite

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

getNextIndexAtLetter

()

método

public function getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Devuelve el índice del siguiente elemento de dataProvider en el que el primer carácter de la etiqueta coincide con el carácter de cadena especificado. Si la búsqueda llega al final del dataProvider sin buscar todos los elementos, realizará un bucle y volverá de nuevo al principio. La búsqueda no incluye startIndex.

Parámetros

	`firstLetter:String` — El carácter de la cadena de búsqueda.

	`startIndex:int` (default = `-1`) — El índice de dataProvider desde el que se comienza.

Valor devuelto

int — El índice del siguiente elemento en dataProvider.

getRendererStyle

()

método

public function getRendererStyle(name:String, column:int = -1):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera un estilo que se define en los procesadores de la lista.

Parámetros

	`name:String` — Nombre del estilo que se va a recuperar.

	`column:int` (default = `-1`) — Valor del estilo que se va a recuperar.

Valor devuelto

Object

Elementos de API relacionados

clearRendererStyle()
setRendererStyle()

getStyleDefinition

()

método

public static function getStyleDefinition():Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

fl.core.UIComponent.getStyle()
fl.core.UIComponent.setStyle()
fl.managers.StyleManager

Ejemplo ( Cómo utilizar este 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;
}

invalidateItem

()

método

public function invalidateItem(item:Object):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Invalida un procesador de elementos concreto.

Parámetros

item:Object — Elemento del proveedor de datos que se va a invalidar.

Elementos de API relacionados

invalidateItemAt()
invalidateList()

invalidateItemAt

()

método

public function invalidateItemAt(index:uint):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Invalida el procesador del elemento en el índice especificado.

Parámetros

index:uint — Índice del elemento del proveedor de datos que se va a invalidar.

Elementos de API relacionados

invalidateItem()
invalidateList()

invalidateList

()

método

public function invalidateList():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Invalida toda la lista y obliga a volver a dibujar los elementos de la lista.

Elementos de API relacionados

invalidateItem()
invalidateItemAt()

isItemSelected

()

método

public function isItemSelected(item:Object):Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Comprueba si el elemento especificado está seleccionado en la lista.

Parámetros

item:Object — Elemento que se va a comprobar.

Valor devuelto

Boolean — Este método devuelve true si se selecciona el elemento especificado; de lo contrario, si el elemento presenta un valor null o no se incluye en la lista, el método devuelve false.

itemToCellRenderer

()

método

public function itemToCellRenderer(item:Object):ICellRenderer

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera ICellRenderer para un objeto determinado, si existe. Este método siempre devuelve null.

Parámetros

item:Object — Elemento del proveedor de datos.

Valor devuelto

ICellRenderer — Valor null.

Ejemplo ( Cómo utilizar este ejemplo )

En el siguiente ejemplo, se muestra cómo adquirir el procesador de celdas para un elemento seleccionado en una lista:

import fl.controls.List;
import fl.controls.listClasses.ListData;
import fl.controls.listClasses.CellRenderer;
import fl.events.ListEvent;

var sampleItem1:Object = { label:"John Alpha" };
var sampleItem2:Object = { label:"Mary Bravo" };
var sampleItem3:Object = { label:"Trevor Gamma" };
var sampleItem4:Object = { label:"Susan Delta" };        

var myList:List;
myList = new List();
myList.move(10,10);
myList.addItem(sampleItem1);
myList.addItem(sampleItem2);
myList.addItem(sampleItem3);
myList.addItem(sampleItem4);
myList.addEventListener(ListEvent.ITEM_CLICK, listItemSelected);
addChild(myList);

function listItemSelected(e:ListEvent):void {
    var cr:CellRenderer = myList.itemToCellRenderer(e.item) as CellRenderer;
    var listData:ListData = cr.listData;

    trace("You have selected row: " + listData.row);
}

itemToLabel

()

método

public function itemToLabel(item:Object):String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera la cadena que el procesador muestra para el objeto de datos especificado basado en las propiedades label del objeto. Este método está pensado para que se sobrescriba en los subcomponentes. Por ejemplo, List tiene labelField y labelFunction para derivar la etiqueta.

Parámetros

item:Object

Valor devuelto

String

removeAll

()

método

public function removeAll():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Elimina todos los elementos de la lista.

removeItem

()

método

public function removeItem(item:Object):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Emite

RangeError — No se pudo encontrar el elemento.

Elementos de API relacionados

removeAll()
removeItemAt()

removeItemAt

()

método

public function removeItemAt(index:uint):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Elimina el elemento en la posición del índice especificado. Los índices de los elementos tras la ubicación del índice especificado o en la misma se reducen en 1.

Parámetros

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

Valor devuelto

Object — Elemento que se ha eliminado.

Elementos de API relacionados

removeAll()
removeItem()
replaceItemAt()

replaceItemAt

()

método

public function replaceItemAt(item:Object, index:uint):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Emite

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

Elementos de API relacionados

removeItemAt()

scrollToIndex

()

método

public function scrollToIndex(newCaretIndex:int):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Desplaza la lista hasta el elemento en el índice especificado. Si el índice está fuera de rango, la posición de desplazamiento no cambia.

Parámetros

newCaretIndex:int — Ubicación del índice hacia el que se va a realizar el desplazamiento.

scrollToSelected

()

método

public function scrollToSelected():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Desplaza la lista hasta el elemento en la ubicación indicada por el valor actual de la propiedad selectedIndex.

Elementos de API relacionados

selectedIndex
scrollToIndex()

setRendererStyle

()

método

public function setRendererStyle(name:String, style:Object, column:uint = 0):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Define un estilo en los procesadores de la lista.

Parámetros

	`name:String` — Nombre del estilo que se va a definir.

	`style:Object` — Valor del estilo que se va a definir.

	`column:uint` (default = `0`)

Elementos de API relacionados

clearRendererStyle()
getRendererStyle()

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un componente List y se utiliza el método setRendererStyle() para aplicar un formato de texto a los elementos de la lista:


import fl.controls.List;

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

var myList:List = new List();
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.setRendererStyle("textFormat", myTextFormat);
myList.width = 150;
myList.move(10, 10);
addChild(myList);

En el ejemplo siguiente, se crea un componente DataGrid y se utiliza el método setRendererStyle() para aplicar un formato de texto a los elementos de la lista:


import fl.controls.DataGrid;

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

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("column1");
myDataGrid.addColumn("column2");
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.setStyle("headerTextFormat", myTextFormat);
myDataGrid.setRendererStyle("textFormat", myTextFormat);
myDataGrid.width = 300;
myDataGrid.move(10, 10);
addChild(myDataGrid);

En el ejemplo siguiente, se crea un componente TileList y se utiliza el método setRendererStyle() para aplicar un formato de texto a los elementos de la lista:


import fl.controls.TileList;

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

var myTileList:TileList = new TileList();
myTileList.addItem({label:"Image 1", source:"http://www.helpexamples.com/flash/images/image1.jpg"});
myTileList.addItem({label:"Image 2", source:"http://www.helpexamples.com/flash/images/image2.jpg"});
myTileList.addItem({label:"Image 3", source:"http://www.helpexamples.com/flash/images/image3.jpg"});
myTileList.setRendererStyle("textFormat", myTextFormat);
myTileList.columnWidth = 100;
myTileList.rowHeight = 67;
myTileList.columnCount = 3;
myTileList.rowCount = 1;
myTileList.move(10, 10);
addChild(myTileList);

En el ejemplo siguiente, se crea un componente ComboBox y se utiliza el método setRendererStyle() para aplicar un formato de texto a los elementos de la lista:


import fl.controls.ComboBox;

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

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.textField.setStyle("textFormat", myTextFormat);
myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat);
myComboBox.width = 150;
myComboBox.move(10, 10);
addChild(myComboBox);

sortItems

()

método

public function sortItems(... sortArgs):*

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

sortItemsOn()
Array.sort()

sortItemsOn

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

sortItems()
DataProvider.sortOn()

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se ordena una lista en función de un valor del proveedor de datos mediante el método sortItemsOn():


import fl.controls.List;
import fl.data.DataProvider;

var players:XML = <players>
        <player name="Player Q" avg="0.237" />
        <player name="Player W" avg="0.352" />
        <player name="Player E" avg="0.268" />
        <player name="Player R" avg="0.311" />
        <player name="Player T" avg="0.293" />
        <player name="Player Y" avg="0.33" />
    </players>;

var dp:DataProvider = new DataProvider(players);

var playerList:List = new List();
playerList.labelFunction = myLabelFunction;
playerList.dataProvider = dp;
playerList.sortItemsOn("avg", Array.NUMERIC | Array.DESCENDING);
playerList.move(10, 10);
playerList.setSize(160, 120);
addChild(playerList);

function myLabelFunction(item:Object):String {
    return item.name + " (" + Number(item.avg).toFixed(3) + ")";
}

Información sobre eventos

change

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.CHANGE

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando se selecciona un elemento diferente de la lista.

La constante Event.CHANGE define el valor de la propiedad type 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`	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.

itemClick

Evento

Tipo de objeto de evento: fl.events.ListEvent
propiedad ListEvent.type = fl.events.ListEvent.ITEM_CLICK

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando el usuario hace clic en un elemento del componente.

El evento click se distribuye antes de que cambie el valor del componente. Para identificar la fila y la columna en las que se ha hecho clic, utilice las propiedades del objeto de evento; no emplee las propiedades selectedIndex ni selectedItem.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`true`
`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.

itemDoubleClick

Evento

Tipo de objeto de evento: fl.events.ListEvent
propiedad ListEvent.type = fl.events.ListEvent.ITEM_DOUBLE_CLICK

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando el usuario hace doble clic rápidamente en un elemento del componente. A diferencia del evento click, doubleClick se distribuye una vez que cambia la propiedad selectedIndex del componente.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`true`
`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.

itemRollOut

Evento

Tipo de objeto de evento: fl.events.ListEvent
propiedad ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OUT

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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:

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.

Elementos de API relacionados

itemRollOver

Evento

Tipo de objeto de evento: fl.events.ListEvent
propiedad ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OVER

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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:

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.

Elementos de API relacionados

itemRollOut

rollOut

Evento

Tipo de objeto de evento: flash.events.MouseEvent
propiedad MouseEvent.type = flash.events.MouseEvent.ROLL_OUT

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando el usuario dejar de pasar el puntero del ratón sobre el componente.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`altKey`	`true` si la tecla Alt está activa (Windows).
`bubbles`	`false`
`buttonDown`	`true` si se pulsa el botón principal del ratón; en caso contrario; `false`.
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`commandKey`	`true` en Mac, si la tecla Comando está activa; `false` si está inactiva. Siempre es `false` en Windows.
`controlKey`	`true` si la tecla Control o Ctrl está activa; `false` si está inactiva.
`ctrlKey`	`true` en Windows o Linux, si la tecla Ctrl está activa. `true` en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, `false`.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`relatedObject`	El objeto de la lista de visualización al que señala ahora el dispositivo de señalización.
`localX`	La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado.
`localY`	La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado.
`movementX`	El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado.
`movementY`	El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado.
`shiftKey`	`true` si la tecla Mayús está activa; `false` si está inactiva.
`stageX`	La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario.
`stageY`	La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario.
`target`	La instancia InteractiveObject en el dispositivo de señalización. 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.

Elementos de API relacionados

rollOver

Evento

Tipo de objeto de evento: flash.events.MouseEvent
propiedad MouseEvent.type = flash.events.MouseEvent.ROLL_OVER

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`altKey`	`true` si la tecla Alt está activa (Windows).
`bubbles`	`false`
`buttonDown`	`true` si se pulsa el botón principal del ratón; en caso contrario; `false`.
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`commandKey`	`true` en Mac, si la tecla Comando está activa; `false` si está inactiva. Siempre es `false` en Windows.
`controlKey`	`true` si la tecla Control o Ctrl está activa; `false` si está inactiva.
`ctrlKey`	`true` en Windows o Linux, si la tecla Ctrl está activa. `true` en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, `false`.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`relatedObject`	El objeto de la lista de visualización al que señalaba el dispositivo de señalización.
`localX`	La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado.
`localY`	La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado.
`movementX`	El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado.
`movementY`	El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado.
`shiftKey`	`true` si la tecla Mayús está activa; `false` si está inactiva.
`stageX`	La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario.
`stageY`	La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario.
`target`	La instancia InteractiveObject en el dispositivo de señalización. 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.

Elementos de API relacionados

rollOut

scroll

Evento

Tipo de objeto de evento: fl.events.ScrollEvent
propiedad ScrollEvent.type = fl.events.ScrollEvent.SCROLL

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando el usuario se desplaza horizontal o verticalmente.

Define el valor de la propiedad type 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.

Avisos legales | Política de privacidad en línea

SelectableList - AS3 Flash

Clases x

allowMultipleSelection

dataProvider

length

maxHorizontalScrollPosition

rowCount

selectable

selectedIndex

selectedIndices

selectedItem

selectedItems

SelectableList

addItem

addItemAt

clearRendererStyle

clearSelection

getItemAt

getNextIndexAtLetter

getRendererStyle

getStyleDefinition

invalidateItem

invalidateItemAt

invalidateList

isItemSelected

itemToCellRenderer

itemToLabel

removeAll

removeItem

removeItemAt

replaceItemAt

scrollToIndex

scrollToSelected

setRendererStyle

sortItems

sortItemsOn

change

itemClick

itemDoubleClick

itemRollOut

itemRollOver

rollOut

rollOver

scroll