List

Pacote	fl.controls
Classe	public class List
Herança	List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementações	IFocusManagerComponent

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

O componente List exibe informações com base em lista e é ideal para a exibição de matrizes de informações.

O componente List consiste em itens, linhas e um provedor de dados, descritos da seguinte maneira:

Item: um objeto ActionScript que geralmente contém uma propriedade label descritiva e uma propriedade data, que armazena os dados associados a esse item.
Linha: um componente utilizado para exibir o item.
Provedor de dados: um componente que modela os itens exibidos pelo componente List.

Por padrão, o componente List usa a classe CellRenderer para fornecer as linhas nas quais os itens da lista são exibidos. É possível criar essas linhas de forma programática; isso é feito geralmente subclassificando a classe CellRenderer. A classe CellRenderer implementa a interface ICellRenderer, que fornece um conjunto de propriedades e métodos, que são utilizados pelo componente List para manipular suas linhas e enviar dados e informações de estado para cada linha para exibição. Isso inclui informações sobre o dimensionamento e a seleção de dados.

O componente List fornece métodos que agem em seu provedor de dados -- por exemplo, os métodos addItem() e removeItem(). É possível usar esses e outros métodos para manipular os dados de qualquer matriz existente no mesmo quadro de um componente List e, em seguida, transmitir as alterações para várias exibições. Se um componente List não for fornecido com um provedor de dados externo, esses métodos criam automaticamente uma ocorrência de um provedor de dados e a expõe por meio da propriedade List.dataProvider. O componente List renderiza cada linha usando um Sprite que implementa a interface ICellRenderer. Para especificar esse renderizador, use a propriedade List.cellRenderer. É possível também criar uma ocorrência de Array ou obter uma de um servidor e usá-la como um modelo de dados para várias listas, caixas de combinação, grades de dados, e assim por diante.

Veja os exemplos

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		accessibilityImplementation : AccessibilityImplementation A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties As opções de acessibilidade atuais para este objeto de exibição.	DisplayObject
		allowMultipleSelection : Boolean Obtém um valor booliano que indica se mais de um item de lista pode ser selecionado por vez.	SelectableList
		alpha : Number Indica o valor de transparência alfa do objeto especificado.	DisplayObject
		blendMode : String Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado.	DisplayObject
		blendShader : Shader [somente gravação] Define um shader usado para mesclar o primeiro plano e o segundo plano.	DisplayObject
		buttonMode : Boolean Especifica o modo de botão desta entidade gráfica.	Sprite
		cacheAsBitmap : Boolean Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição.	DisplayObject
		cacheAsBitmapMatrix : Matrix Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro.	DisplayObject
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		contextMenu : NativeMenu Especifica o menu de contexto associado a este objeto.	InteractiveObject
		dataProvider : DataProvider Obtém ou define o modelo de dados da lista de itens a serem visualizados.	SelectableList
		doubleClickEnabled : Boolean Especifica se o objeto recebe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [somente leitura] Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta.	Sprite
		enabled : Boolean Obtém ou define um valor que indica se o componente pode aceitar a interação do usuário.	UIComponent
		filters : Array Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição.	DisplayObject
		focusEnabled : Boolean Obtém ou define um valor booliano que indica se o componente pode receber foco depois que o usuário clicar nele.	UIComponent
		focusManager : IFocusManager Obtém ou define o FocusManager que controla o foco para este componente e seus semelhantes.	UIComponent
		focusRect : Object Especifica se este objeto exibe um retângulo de foco.	InteractiveObject
		graphics : Graphics [somente leitura] Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer.	Sprite
		height : Number [substituir] Obtém ou define a altura do componente, em pixels.	UIComponent
		hitArea : Sprite Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica.	Sprite
		horizontalLineScrollSize : Number Obtém ou define um valor que descreve a quantidade de conteúdo a ser rolada, horizontalmente, quando uma seta de rolagem for clicada.	BaseScrollPane
		horizontalPageScrollSize : Number Obtém ou define a contagem de pixels de acordo com a qual mover a miniatura de rolagem na barra de rolagem horizontal quando o controle da barra de rolagem for pressionado.	BaseScrollPane
		horizontalScrollBar : ScrollBar [somente leitura] Obtém uma referência à barra de rolagem horizontal.	BaseScrollPane
		horizontalScrollPolicy : String Obtém ou define um valor que indica o estado da barra de rolagem horizontal.	BaseScrollPane
		horizontalScrollPosition : Number Obtém ou define um valor que descreve a posição horizontal da barra de rolagem horizontal no painel de rolagem, em pixels.	BaseScrollPane
		iconField : String Obtém ou define o campo de item que fornece o ícone para o item.	List
		iconFunction : Function Obtém ou define a função a ser usada para obter o ícone do item.	List
		labelField : String Obtém ou define o nome do campo no objeto dataProvider a ser exibido como rótulo para a lista suspensa e o campo TextInput.	List
		labelFunction : Function Obtém ou define a função a ser usada para obter o rótulo do item.	List
		length : uint [somente leitura] Obtém o número de itens no provedor de dados.	SelectableList
		loaderInfo : LoaderInfo [somente leitura] Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence.	DisplayObject
		mask : DisplayObject O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado.	DisplayObject
		maxHorizontalScrollPosition : Number [substituir] Obtém ou define o número de pixels que a lista rola para a direita quando a propriedade horizontalScrollPolicy é definida como ScrollPolicy.ON.	SelectableList
		maxVerticalScrollPosition : Number [somente leitura] Obtém a posição de rolagem vertical máxima para o conteúdo atual, em pixels.	BaseScrollPane
		metaData : Object Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4.	DisplayObject
		mouseChildren : Boolean Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários.	InteractiveObject
		mouseFocusEnabled : Boolean Obtém ou define um valor que indica se o componente pode receber foco depois que o usuário clicar nele.	UIComponent
		mouseX : Number [somente leitura] Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels.	DisplayObject
		mouseY : Number [somente leitura] Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels.	DisplayObject
		name : String Indica o nome da ocorrência de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco.	InteractiveObject
		numChildren : int [somente leitura] Retorna o número de filhos deste objeto.	DisplayObjectContainer
		opaqueBackground : Object Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo.	DisplayObject
		parent : DisplayObjectContainer [somente leitura] Indica o objeto DisplayObjectContainer que contém esse objeto de exibição.	DisplayObject
		root : DisplayObject [somente leitura] Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF.	DisplayObject
		rotation : Number Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original.	DisplayObject
		rotationX : Number Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		rotationY : Number Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		rotationZ : Number Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		rowCount : uint [substituir] Obtém ou define o número de linhas que são pelo menos parcialmente visíveis na lista.	List
		rowHeight : Number Obtém ou define a altura de cada linha na lista, em pixels.	List
		scale9Grid : Rectangle A grade de dimensionamento atual que está em vigor.	DisplayObject
		scaleX : Number [substituir] Multiplica a largura atual do componente por um fator escalar.	UIComponent
		scaleY : Number [substituir] Multiplica a altura atual do componente por um fator escalar.	UIComponent
		scaleZ : Number Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto.	DisplayObject
		scrollRect : Rectangle Os limites do retângulo de rolagem do objeto de exibição.	DisplayObject
		selectable : Boolean Obtém ou define um valor booliano que indica se os itens na lista podem ser selecionados.	SelectableList
		selectedIndex : int Obtém ou define o índice do item selecionado em uma lista de seleção única.	SelectableList
		selectedIndices : Array Obtém ou define uma matriz que contém os itens que foram selecionados a partir de uma lista de seleção múltipla.	SelectableList
		selectedItem : Object Obtém ou define o item que foi selecionado a partir de uma lista de seleção única.	SelectableList
		selectedItems : Array Obtém ou define uma matriz que contém os objetos para os itens que foram selecionados a partir da lista de seleção múltipla.	SelectableList
		softKeyboard : String Controla a aparência do teclado suave.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS)	InteractiveObject
		soundTransform : flash.media:SoundTransform Controla o som nesta entidade gráfica.	Sprite
		stage : Stage [somente leitura] O Palco do objeto de exibição.	DisplayObject
		tabChildren : Boolean Determina se os filhos do objeto estão ativados para tabulação.	DisplayObjectContainer
		tabEnabled : Boolean Especifica se este objeto está na ordem de tabulação.	InteractiveObject
		tabIndex : int Especifica a ordem de tabulação de objetos em um arquivo SWF.	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [somente leitura] Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		transform : flash.geom:Transform Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição.	DisplayObject
		useBitmapScrolling : Boolean Quando definida como verdadeira, a propriedade cacheAsBitmap para o conteúdo de rolagem é definida como verdadeira; quando definida como falsa, esse valor é desativado.	BaseScrollPane
		useHandCursor : Boolean Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true".	Sprite
		verticalLineScrollSize : Number Obtém ou define um valor que descreve quantos pixels devem ser rolados verticalmente quando uma seta de rolagem for clicada.	BaseScrollPane
		verticalPageScrollSize : Number Obtém ou define a contagem de pixels de acordo com a qual mover a miniatura de rolagem na barra de rolagem vertical quando o controle da barra de rolagem for pressionado.	BaseScrollPane
		verticalScrollBar : ScrollBar [somente leitura] Obtém uma referência à barra de rolagem vertical.	BaseScrollPane
		verticalScrollPolicy : String Obtém ou define um valor que indica o estado da barra de rolagem vertical.	BaseScrollPane
		verticalScrollPosition : Number Obtém ou define um valor que descreve a posição vertical da barra de rolagem vertical no painel de rolagem, em pixels.	BaseScrollPane
		visible : Boolean [substituir] Obtém ou define um valor que indica se a ocorrência do componente atual é visível.	UIComponent
		width : Number [substituir] Obtém ou define a largura do componente, em pixels.	UIComponent
		x : Number [substituir] Obtém ou define a coordenada x que representa a posição do componente ao longo do eixo x em seu contêiner-pai.	UIComponent
		y : Number [substituir] Obtém ou define a coordenada y que representa a posição do componente ao longo do eixo y em seu contêiner-pai.	UIComponent
		z : Number Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai.	DisplayObject

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		List() Cria uma nova ocorrência do componente List.	List
		addChild(child:DisplayObject):DisplayObject Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		addItem(item:Object):void Acrescenta um item ao final da lista de itens.	SelectableList
		addItemAt(item:Object, index:uint):void Insere um item na lista, na localização de índice especificada.	SelectableList
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado.	DisplayObjectContainer
		clearRendererStyle(name:String, column:int = -1):void Apaga um estilo definido nos renderizadores da lista.	SelectableList
		clearSelection():void Apaga o item atualmente selecionado na lista e define a propriedade selectedIndex como -1.	SelectableList
		clearStyle(style:String):void Exclui uma propriedade de estilo desta ocorrência do componente.	UIComponent
		contains(child:DisplayObject):Boolean Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		drawFocus(focused:Boolean):void Mostra ou oculta o indicador de foco neste componente.	UIComponent
		drawNow():void Inicia uma operação imediata de desenho, sem invalidar nada como faz invalidateNow.	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Retorna o objeto de exibição-filho que existe com o nome especificado.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Retorna a posição de índice de uma ocorrência-filho de DisplayObject.	DisplayObjectContainer
		getFocus():InteractiveObject Recupera o objeto que possui foco no momento.	UIComponent
		getItemAt(index:uint):Object Recupera o item no índice especificado.	SelectableList
		getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int Retorna o índice do próximo item em dataProvider, no qual o primeiro caractere do rótulo corresponde a um caractere de string especificado.	SelectableList
		getObjectsUnderPoint(point:Point):Array Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas.	DisplayObject
		getRendererStyle(name:String, column:int = -1):Object Recupera um estilo definido nos renderizadores da lista.	SelectableList
		getStyle(style:String):Object Recupera uma propriedade de estilo definida na cadeia de pesquisa de estilo do componente.	UIComponent
		getStyleDefinition():Object [estático] Recupera o mapa de estilos padrão do componente atual.	List
		globalToLocal(point:Point):Point Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais).	DisplayObject
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		hitTestObject(obj:DisplayObject):Boolean Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Marca uma propriedade como inválida e redesenha o componente no quadro seguinte, a não ser que especificado de outra forma.	UIComponent
		invalidateItem(item:Object):void Invalida um renderizador de item específico.	SelectableList
		invalidateItemAt(index:uint):void Invalida o renderizador do item no índice especificado.	SelectableList
		invalidateList():void Invalida a lista inteira, forçando o redesenho dos itens da lista.	SelectableList
		isItemSelected(item:Object):Boolean Verifica se o item especificado está selecionado na lista.	SelectableList
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		itemToCellRenderer(item:Object):ICellRenderer Recupera ICellRenderer para um determinado objeto de item, se houver um.	SelectableList
		itemToLabel(item:Object):String [substituir] Recupera a string exibida pelo renderizador para o objeto de dados especificado com base nas propriedades labelField e labelFunction.	List
		local3DToGlobal(point3d:Vector3D):Point Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco.	DisplayObject
		localToGlobal(point:Point):Point Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais).	DisplayObject
		mergeStyles(... list):Object [estático] Mescla os estilos de várias classes em um objeto.	UIComponent
		move(x:Number, y:Number):void Move o componente até a posição especificada em seu pai.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeAll():void Remove todos os itens da lista.	SelectableList
		removeChild(child:DisplayObject):DisplayObject Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		removeItem(item:Object):Object Remove o item especificado da lista.	SelectableList
		removeItemAt(index:uint):Object Remove o item na posição de índice especificada.	SelectableList
		replaceItemAt(item:Object, index:uint):Object Substitui o item na localização de índice especificada por outro item.	SelectableList
		requestSoftKeyboard():Boolean Ativa um teclado virtual.	InteractiveObject
		scrollToIndex(newCaretIndex:int):void [substituir] Rola a lista até o item no índice especificado.	List
		scrollToSelected():void Rola a lista até o item na localização indicada pelo valor atual da propriedade selectedIndex.	SelectableList
		setChildIndex(child:DisplayObject, index:int):void Altera a posição de um filho existente no contêiner de objetos de exibição.	DisplayObjectContainer
		setFocus():void Define o foco para este componente.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setRendererStyle(name:String, style:Object, column:uint = 0):void Define um estilo nos renderizadores da lista.	SelectableList
		setSize(width:Number, height:Number):void Define o componente para a largura e altura especificadas.	UIComponent
		setStyle(style:String, value:Object):void Define uma propriedade de estilo nesta ocorrência do componente.	UIComponent
		sortItems(... sortArgs):* Classifica os elementos do provedor de dados atual.	SelectableList
		sortItemsOn(field:String, options:Object = null):* Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos.	SelectableList
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite ao usuário arrastar a entidade gráfica especificada.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque.	Sprite
		stopAllMovieClips():void Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto.	DisplayObjectContainer
		stopDrag():void Finaliza o método startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos.	DisplayObjectContainer
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		validateNow():void Valida e atualiza as propriedades e o layout deste objeto, redesenhando-o se necessário.	UIComponent
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Métodos protegidos

Ocultar métodos protegidos herdados

Mostrar métodos protegidos herdados

	Método		Definido por
		getStyleValue(name:String):Object Retorna o estilo especificado para um componente, considerando todos os estilos definidos nos níveis global, de componente e de ocorrência.	UIComponent

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
added	Despachado quando um objeto de exibição é adicionado à lista de exibição.	DisplayObject
addedToStage	Despachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido.	DisplayObject
change	Despachado quando um item diferente é selecionado na lista.	SelectableList
clear	Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto.	InteractiveObject
click	Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
contextMenu	Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.	InteractiveObject
copy	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto.	InteractiveObject
cut	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto.	InteractiveObject
deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
doubleClick	Despachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true".	InteractiveObject
enterFrame	[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro.	DisplayObject
exitFrame	[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual.	DisplayObject
focusIn	Despachado depois que um objeto de exibição ganha foco.	InteractiveObject
focusOut	Despachado depois que um objeto de exibição perde o foco.	InteractiveObject
frameConstructed	[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts.	DisplayObject
gestureDirectionalTap	Enviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque.	InteractiveObject
gestureLongPress	Despachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gesturePan	Despachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureRotate	Despachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureSwipe	Despachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureTap	Despachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque).	InteractiveObject
gestureZoom	Despachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque).	InteractiveObject
hide	Despachado depois que a visibilidade do componente muda de visível para invisível.	UIComponent
imeStartComposition	Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME	InteractiveObject
itemClick	Despachado quando o usuário clica em um item no componente.	SelectableList
itemDoubleClick	Despachado quando o usuário clica em um item no componente duas vezes em rápida sucessão.	SelectableList
itemRollOut	Despachado quando o usuário rola o ponteiro para fora de um item no componente.	SelectableList
itemRollOver	Despachado quando o usuário rola o ponteiro sobre um item no componente.	SelectableList
keyDown	Despachado quando o usuário pressiona uma tecla.	InteractiveObject
keyFocusChange	Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado.	InteractiveObject
keyUp	Despachado quando o usuário solta uma tecla.	InteractiveObject
middleClick	Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
middleMouseDown	Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
middleMouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseDown	Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseFocusChange	Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador.	InteractiveObject
mouseMove	Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject.	InteractiveObject
mouseOut	Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.	InteractiveObject
mouseOver	Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseWheel	Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject.	InteractiveObject
move	Despachado após a movimentação do componente.	UIComponent
nativeDragComplete	Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar.	InteractiveObject
nativeDragDrop	Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite.	InteractiveObject
nativeDragExit	Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite.	InteractiveObject
nativeDragOver	Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite.	InteractiveObject
nativeDragStart	Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().	InteractiveObject
paste	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto.	InteractiveObject
proximityBegin	Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela.	InteractiveObject
proximityEnd	Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela.	InteractiveObject
proximityMove	Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade.	InteractiveObject
proximityOut	Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityOver	Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityRollOut	Despachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityRollOver	Despachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela).	InteractiveObject
releaseOutside	Enviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject.	InteractiveObject
removed	Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição.	DisplayObject
removedFromStage	Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido.	DisplayObject
render	[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada.	DisplayObject
resize	Despachado após o redimensionamento do componente.	UIComponent
rightClick	Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
rightMouseDown	Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
rightMouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
rollOut	Despachado quando o usuário rola o ponteiro para fora do componente.	SelectableList
rollOver	Despachado quando o usuário rola o ponteiro sobre o componente.	SelectableList
scroll	Despachado quando o usuário rola horizontal ou verticalmente.	SelectableList
selectAll	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto.	InteractiveObject
show	Despachado depois que a visibilidade do componente muda de invisível para visível.	UIComponent
softKeyboardActivate	Despachado imediatamente depois que o teclado virtual é elevado.	InteractiveObject
softKeyboardActivating	Despachado imediatamente antes de o teclado virtual ser elevado.	InteractiveObject
softKeyboardDeactivate	Despachado imediatamente depois que o teclado virtual é baixado.	InteractiveObject
tabChildrenChange	Despachado quando o valor do sinalizador tabChildren do objeto é alterado.	InteractiveObject
tabEnabledChange	Despachado quando o sinalizador tabEnabled do objeto é alterado.	InteractiveObject
tabIndexChange	Despachado quando o valor da propriedade tabIndex do objeto é alterado.	InteractiveObject
textInput	Despachado quando um usuário introduz um ou vários caracteres do texto.	InteractiveObject
touchBegin	Despachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque).	InteractiveObject
touchEnd	Despachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque).	InteractiveObject
touchMove	Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido.	InteractiveObject
touchOut	Despachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchOver	Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchRollOut	Despachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque).	InteractiveObject
touchRollOver	Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchTap	Despachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject

Estilos

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

Estilos comuns

Clique para obter mais informações sobre estilos

Ocultar estilos herdados

Mostrar estilos herdados

	Descrição	Definido por
cellRenderer	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A classe que fornece o renderizador de célula para cada item no componente.	SelectableList
contentPadding	Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento separa a borda da lista de seu conteúdo, em pixels.	SelectableList
disabledAlpha	Tipo: Number Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O valor de alfa para definir a lista quando a propriedade `enabled` for `false`.	SelectableList
disabledTextFormat	Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente quando o botão é desabilitado.	UIComponent
downArrowDisabledSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando ele está desativado.	BaseScrollPane
downArrowDownSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando você clica no botão de seta.	BaseScrollPane
downArrowOverSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta.	BaseScrollPane
downArrowUpSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem.	BaseScrollPane
focusRectPadding	Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento que separa os limites externos do componente das arestas externas do indicador de foco, em pixels.	UIComponent
focusRectSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa a ser usada para exibir indicadores de foco.	UIComponent
repeatDelay	Tipo: Number Formato: Time Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O número de milissegundos a aguardar depois que o evento `buttonDown` é despachado pela primeira vez, antes do envio de um segundo evento `buttonDown`.	BaseScrollPane
repeatInterval	Tipo: Number Formato: Time Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O intervalo, em milissegundos, entre os eventos `buttonDown` despachados depois do atraso especificado pelo estilo `repeatDelay`.	BaseScrollPane
skin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A classe que fornece a capa para o plano de fundo do componente.	SelectableList
textFormat	Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente.	UIComponent
thumbDisabledSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado desativado da miniatura.	BaseScrollPane
thumbDownSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando você clica na miniatura.	BaseScrollPane
thumbIcon	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como ícone para a miniatura da barra de rolagem.	BaseScrollPane
thumbOverSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando o ponteiro do mouse está sobre a miniatura.	BaseScrollPane
thumbUpSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa usada para a miniatura da barra de rolagem.	BaseScrollPane
trackDisabledSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar uma faixa desativada.	BaseScrollPane
trackDownSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado para baixo de uma capa desativada.	BaseScrollPane
trackOverSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado do mouse sobre para a faixa de rolagem.	BaseScrollPane
trackUpSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado do mouse para cima para a faixa de rolagem.	BaseScrollPane
upArrowDisabledSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando ele está desativado.	BaseScrollPane
upArrowDownSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando você clica no botão de seta.	BaseScrollPane
upArrowOverSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta.	BaseScrollPane
upArrowUpSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem.	BaseScrollPane

Constantes públicas

Ocultar constantes públicas herdadas

Mostrar constantes públicas herdadas

	Constante		Definido por
		version : String = "3.0.3.1" O número de versão dos componentes.	UIComponent

Detalhes da propriedade

iconField

propriedade

iconField:String

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o campo de item que fornece o ícone para o item.

Observação: iconField não é usado, se a propriedade iconFunction estiver definida como uma função de retorno.

O valor padrão é "icon".

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

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria uma lista com um ícone para cada item. É necessário que exista um símbolo com nome RedBox na biblioteca e que "Exportar para o ActionScript" esteja alternado em suas propriedades 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

propriedade

iconFunction:Function

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define a função a ser usada para obter o ícone do item.

Observação: iconField não é usado, se a propriedade iconFunction estiver definida como uma função de retorno.

O valor padrão é null.

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

Exemplo ( Como usar este exemplo )

O exemplo a seguir usa a propriedade iconFunction para fornecer um ícone a um número limitado de itens em uma lista. Para que esse exemplo funcione corretamente, é necessário que exista um símbolo com nome RedBox na biblioteca e que "Exportar para o ActionScript" esteja alternado em suas propriedades 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

propriedade

labelField:String

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

O valor padrão é "label".

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

Elementos da API relacionados

labelFunction

Exemplo ( Como usar este exemplo )

O exemplo a seguir exibe cada item em uma lista com a propriedade abbreviatedLabel, em vez da propriedade label padrão:

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

propriedade

labelFunction:Function

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

O valor padrão é null.

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

Exemplo ( Como usar este exemplo )

Esse exemplo define a propriedade labelFunction de uma lista como uma função que formata a string a ser exibida em cada célula:

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

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

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

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

rowCount

propriedade

rowCount:uint[substituir]

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o número de linhas que são pelo menos parcialmente visíveis na lista.

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

Exemplo ( Como usar este exemplo )

Esse exemplo define o tamanho de uma lista e determina o número de linhas potencialmente visíveis rastreando a propriedade 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

O exemplo a seguir define o tamanho de um componente List usando rowCount com base no valor atual de um seletor:


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

propriedade

rowHeight:Number

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define a altura de cada linha na lista, em pixels.

O valor padrão é 20.

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

Detalhes do construtor

()

Construtor

public function List()

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Cria uma nova ocorrência do componente List.

Detalhes do método

getStyleDefinition

()

método

public static function getStyleDefinition():Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

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

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

Retorna

Object — Objeto de estilos padrão.

Elementos da API relacionados

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

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria um navegador de estilo para várias classes de componentes:

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

itemToLabel

()

método

override public function itemToLabel(item:Object):String

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

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

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

Parâmetros

item:Object — O objeto a ser renderizado.

Retorna

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

Exemplo ( Como usar este exemplo )

O exemplo a seguir demonstra como determinar o rótulo de um item da lista, quando o mouse flutuar sobre esse item:

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Rola a lista até o item no índice especificado. Se o índice estiver fora da faixa, a posição de rolagem não é alterada.

Parâmetros

newCaretIndex:int — O local do índice até o qual ocorre a rolagem.

Exemplos Como usar este exemplo

ListExample.as

Esse exemplo demonstra como criar uma ocorrência e preencher outras ocorrências de List com suas seleções.

Adicione as classes List, Button e Label à biblioteca.
Salve esse código como ListExample.as no mesmo diretório de FLA.
Defina DocumentClass em 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);
        }
    }
}

Aspectos jurídicos | Política de privacidade on-line

List - AS3 Flash

Classes x

iconField

iconFunction

labelField

labelFunction

rowCount

rowHeight

List

getStyleDefinition

itemToLabel

scrollToIndex