List

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

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

El componente List muestra información basada en listas y resulta idóneo para la visualización de conjuntos de información.

El componente List consta de elementos, filas y un proveedor de datos que se describen del siguiente modo:

Item: objeto de ActionScript que suele incluir una propiedad descriptiva label y otra propiedad data que almacena los datos asociados al elemento.
Row: componente utilizado para mostrar el elemento.
Proveedor de datos: Componente que modela los elementos que muestra el componente List.

De forma predeterminada, el componente List emplea la clase CellRenderer para proporcionar las filas en las que se muestran los elementos de la lista. Estas filas se pueden crear mediante programación; se suele hacer asignando subclases a la clase CellRenderer. La clase CellRenderer implementa la interfaz ICellRenderer, que proporciona el conjunto de propiedades y métodos que el componente List utiliza para manipular las filas y enviar datos e información de estado a cada fila para su visualización. Esto incluye información sobre la selección y definición de tamaño de datos.

El componente List proporciona métodos que actúan en su proveedor de datos; por ejemplo, los métodos addItem() y removeItem(). Puede utilizar estos y otros métodos para manipular los datos de cualquier conjunto que se encuentre en el mismo fotograma que un componente List y, posteriormente, difundir los cambios en varias vistas. Si un componente List no se proporciona con un proveedor de datos externo, estos métodos crean automáticamente una instancia de un proveedor de datos y la exponen a través de la propiedad List.dataProvider. El componente List representa todas las filas mediante una clase Sprite que implementa la interfaz ICellRenderer. Para especificar este procesador, utilice la propiedad List.cellRenderer. Asimismo, puede crear una instancia de Array u obtener una en un servidor y utilizarla como modelo de datos para varias listas, cuadros combinados, cuadrículas de datos, etc.

Ver los ejemplos

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
		iconField : String Obtiene o define el campo de elementos que proporciona el icono del elemento.	List
		iconFunction : Function Obtiene o define la función que se utilizará para obtener el icono del elemento.	List
		labelField : String Obtiene o define el nombre del campo del objeto dataProvider que se mostrará como etiqueta del campo TextInput y la lista desplegable.	List
		labelFunction : Function Obtiene o define la función que se utilizará para obtener la etiqueta del elemento.	List
		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 [override] Obtiene o define el número de filas que son al menos parcialmente visibles en la lista.	List
		rowHeight : Number Obtiene o define la altura de todas las filas de la lista, en píxeles.	List
		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
		List() Crea una instancia de componente List nueva.	List
		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.	List
		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 [override] Recupera la cadena que muestra el procesador para el objeto de datos especificado según las propiedades labelField y labelFunction.	List
		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 [override] Desplaza la lista hasta el elemento en el índice especificado.	List
		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.	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.	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`.	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.	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

iconField

propiedad

iconField: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

Obtiene o define el campo de elementos que proporciona el icono del elemento.

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

El valor predeterminado es "icon".

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

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea una lista con un icono para cada elemento. En la biblioteca debe existir un símbolo con el nombre RedBox y con la opción "Exportar para ActionScript" activada en sus propiedades de símbolo:

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

var dp:DataProvider = new DataProvider();
dp.addItem( { iconSource:RedBox, label:"Item 1" } );
dp.addItem( { iconSource:RedBox, label:"Item 2" } );
dp.addItem( { iconSource:RedBox, label:"Item 3" } );

var list:List = new List();
list.iconField = "iconSource";
list.dataProvider = dp;
addChild(list);

iconFunction

propiedad

iconFunction:Function

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 la función que se utilizará para obtener el icono del elemento.

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

El valor predeterminado es null.

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

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se utiliza la propiedad iconFunction para proporcionar un icono a un número limitado de elementos de una lista. Para que este ejemplo funcione correctamente, en la biblioteca debe existir un símbolo con el nombre RedBox y con la opción "Exportar para ActionScript" activada en sus propiedades de símbolo:

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

var dp:DataProvider = new DataProvider();
dp.addItem( { label:"Item 1" } );
dp.addItem( { label:"Item 2" } );
dp.addItem( { label:"Item 3" } );

var list:List = new List();
list.iconFunction = determineIcon;
list.dataProvider = dp;
addChild(list);

function determineIcon(item:Object):String {
    if(item.label == "Item 2") {
        return "RedBox";
    }
    else {
        return null;
    }
}

labelField

propiedad

labelField: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

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

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

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

El valor predeterminado es "label".

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

Elementos de API relacionados

labelFunction

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se muestra cada uno de los elementos de una lista con la propiedad abbreviatedLabel, en lugar de con la propiedad predeterminada label:

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

var dp:DataProvider = new DataProvider();
dp.addItem( { abbreviatedLabel:"NY", label:"New York" } );
dp.addItem( { abbreviatedLabel:"CA", label:"California" } );
dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } );
dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } );
dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } );

var list:List = new List();
list.setSize(40,100);
list.labelField = "abbreviatedLabel"
list.dataProvider = dp;
addChild(list);

labelFunction

propiedad

labelFunction:Function

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 la función que se utilizará para obtener la etiqueta del elemento.

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

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

El valor predeterminado es null.

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

Ejemplo ( Cómo utilizar este ejemplo )

En este ejemplo, se define la propiedad labelFunction de una lista en una función que da formato a la cadena que se muestra en cada celda:

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

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

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

function myLabelFunction(item:Object):String {
    return  item.name + " ($" + item.price.toFixed(2) + ")";
}

rowCount

propiedad

rowCount:uint[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 filas que son al menos parcialmente visibles en la lista.

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

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

En el ejemplo siguiente, se define el tamaño de un componente List mediante la propiedad rowCount en función del valor actual de un deslizador:


import fl.controls.Slider;
import fl.controls.List;
import fl.data.DataProvider;
import fl.events.SliderEvent;

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

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

var myList:List = new List();
myList.dataProvider = dp;
myList.move(mySlider.x, mySlider.y + 20);
myList.setSize(100, 50);
addChild(myList);

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

rowHeight

propiedad

rowHeight:Number

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 la altura de todas las filas de la lista, en píxeles.

El valor predeterminado es 20.

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

Información sobre constructores

()

Información sobre

public function List()

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 componente List nueva.

Información sobre métodos

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

itemToLabel

()

método

override 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 muestra el procesador para el objeto de datos especificado según las propiedades labelField y labelFunction.

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

Parámetros

item:Object — Objeto que se va a representar.

Valor devuelto

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

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se muestra cómo determinar la etiqueta de un elemento de lista cuando el ratón se sitúa sobre él:

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

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({label:"Carrot", price:0.43});
myDataProvider.addItem({label:"Tomato", price:0.34});
myDataProvider.addItem({label:"Blueberry", price:0.72});
myDataProvider.addItem({label:"Turnip", price:0.24});

var myList:List = new List();
myList.setSize(300,80);
myList.dataProvider = myDataProvider;
myList.labelFunction = myLabelFunction;
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel);
addChild(myList);

function myLabelFunction(item:Object):String {
    return item.label + " - Current price: ($" + item.price.toFixed(2) + ")";
}

function announceLabel(e:ListEvent):void {
    var list:List = e.target as List;
    var item:Object = e.item;
    trace("Label: " + item.label);
    trace("Label displayed: " + list.itemToLabel(item));
}

scrollToIndex

()

método

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

Ejemplos Cómo utilizar este ejemplo

ListExample.as

En este ejemplo se muestra cómo crear un componente List y llenar otras instancias del mismo con sus selecciones.

Añada las clases List, Button y Label a la biblioteca.
Guarde este código como ListExample.as en el mismo directorio que el archivo FLA.
Establece la clase DocumentClass del archivo FLA como ListExample.

package
{
    import flash.display.Sprite
    
    public class ListExample extends Sprite
    {
        import flash.events.*;
        import fl.data.DataProvider;
        import fl.controls.List
        import fl.controls.Label
        import fl.controls.Button
        
        private var clearButton:Button;
        private var availableItems:List;
        private var selectedItemList:List;
        private var selectedItemsList:List;

        public function ListExample() {
            createComponents();
            setupComponents();
        }

        private function setupComponents():void {
            var dp:Array = new Array();
            var i:uint;
            var count:uint = availableItems.rowCount * 2;
            
            for (i = 0; i < count; i++) {
                dp.push({label:"Item " + i});
            }
            
            availableItems.allowMultipleSelection = true;
            availableItems.dataProvider = new DataProvider(dp);
            availableItems.addEventListener(Event.CHANGE, updateLists);
            clearButton.addEventListener(MouseEvent.CLICK, clearHandler);            
        }
        
        private function clearHandler(event:MouseEvent):void {
            availableItems.clearSelection();
            // clear data providers
            selectedItemList.dataProvider = new DataProvider();
            selectedItemsList.dataProvider = new DataProvider();
        }
        
        private function updateLists(e:Event):void {
            selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider();
            selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems);
        }

        private function createComponents():void {
            clearButton = new Button();
            availableItems = new List();
            selectedItemList = new List();
            selectedItemsList = new List();
            var availableItemsLabel:Label = new Label();
            var selectedItemListLabel:Label = new Label();
            var selectedItemsListLabel:Label = new Label();
            
            clearButton.move(10,142);
            availableItems.move(10,32);
            selectedItemList.move(120,32);
            selectedItemsList.move(230,32);
            availableItemsLabel.move(10,10);
            selectedItemListLabel.move(120,10);
            selectedItemsListLabel.move(230,10);
            
            clearButton.label = "Clear Selection"
            availableItemsLabel.text = "Available Items";
            selectedItemListLabel.text = "Selected Item";
            selectedItemsListLabel.text = "All Selected Items";
            
            addChild(clearButton);
            addChild(availableItems);
            addChild(selectedItemList);
            addChild(selectedItemsList);
            addChild(availableItemsLabel);
            addChild(selectedItemListLabel);
            addChild(selectedItemsListLabel);
        }
    }
}

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

List - AS3 Flash

Clases x

iconField

iconFunction

labelField

labelFunction

rowCount

rowHeight

List

getStyleDefinition

itemToLabel

scrollToIndex