SelectableList

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

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

SelectableList é a classe base de todos os componentes com base em lista; por exemplo, os componentes List, TileList, DataGrid e ComboBox. Essa classe fornece métodos e propriedades que são usados para a renderização e o layout de linhas, e para definir os estilos da barra de rolagem e os provedores de dados.

Observação: essa classe não cria um componente; ela é apenas exposta para que possa ser estendida.

Elementos da API relacionados

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

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
		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 [somente leitura] Obtém o número de linhas que são pelo menos parcialmente visíveis na lista.	SelectableList
		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
		SelectableList() Cria uma nova ocorrência de SelectableList.	SelectableList
		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.	SelectableList
		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 Recupera a string exibida pelo renderizador para o objeto de dados especificado com base nas propriedades de rótulo do objeto.	SelectableList
		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 Rola a lista até o item no índice especificado.	SelectableList
		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. O valor padrão é `fl.contols.listClasses.CellRenderer`.	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. O valor padrão é `null`.	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`. O valor padrão é `null`.	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. O valor padrão é `List_skin`.	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

allowMultipleSelection

propriedade

allowMultipleSelection:Boolean

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 um valor booliano que indica se mais de um item de lista pode ser selecionado por vez. Um valor true indica que várias seleções podem ser feitas de uma vez; um valor false indica que apenas um item pode ser selecionado por vez.

O valor padrão é false.

Implementação
public function get allowMultipleSelection():Boolean
public function set allowMultipleSelection(value:Boolean):void

Elementos da API relacionados

selectable

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria uma nova ocorrência List e rastreia as propriedades selectedIndex e selectedIndices, quando os itens na lista são alterados:


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

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

var dp:DataProvider = new DataProvider(items);

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

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

dataProvider

propriedade

dataProvider:DataProvider

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 modelo de dados da lista de itens a serem visualizados. Um provedor de dados pode ser compartilhado por vários componentes com base em lista. As alterações no provedor de dados estão imediatamente disponíveis a todos os componentes que o usam como uma fonte de dados.

O valor padrão é null.

Implementação
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void

length

propriedade

length:uint [somente leitura]

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 o número de itens no provedor de dados.

Implementação
public function get length():uint

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria uma ocorrência do componente List e define a propriedade rowCount como o número atual de itens na lista:


import fl.controls.List;

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

maxHorizontalScrollPosition

propriedade

maxHorizontalScrollPosition:Number[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 pixels que a lista rola para a direita, quando a propriedade horizontalScrollPolicy está definida como ScrollPolicy.ON.

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

Elementos da API relacionados

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

rowCount

propriedade

rowCount:uint [somente leitura]

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 o número de linhas que são pelo menos parcialmente visíveis na lista.

Observação: essa propriedade deve ser sobreposta em qualquer classe que estenda SelectableList.

O valor padrão é 0.

Implementação
public function get rowCount():uint

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

selectable

propriedade

selectable:Boolean

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 um valor booliano que indica se os itens na lista podem ser selecionados. Um valor true indica que os itens da lista podem ser selecionados; um valor false indica que não é possível fazer isso.

O valor padrão é true.

Implementação
public function get selectable():Boolean
public function set selectable(value:Boolean):void

Elementos da API relacionados

allowMultipleSelection

selectedIndex

propriedade

selectedIndex:int

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 índice do item selecionado em uma lista de seleção única. Uma lista de seleção única é uma lista na qual apenas um item pode ser selecionado por vez.

Um valor de -1 indica que nenhum item é selecionado; se várias seleções forem feitas, esse valor é igual ao índice do item que foi selecionado por último no grupo de itens selecionados.

Quando o ActionScript é usado para definir essa propriedade, o item no índice especificado substitui a seleção atual. Quando a seleção é alterada de forma programática, o objeto de evento change não é despachado.

Implementação
public function get selectedIndex():int
public function set selectedIndex(value:int):void

Elementos da API relacionados

selectedIndices
selectedItem

Exemplo ( Como usar este exemplo )

Esse exemplo rastreia o rótulo e o índice de linhas de qualquer item em uma lista que foi clicada.


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

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

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

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

selectedIndices

propriedade

selectedIndices:Array

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 uma matriz que contém os itens que foram selecionados a partir de uma lista de seleção múltipla.

Para substituir a seleção atual de forma programática, é possível fazer uma atribuição explícita a essa propriedade. É possível limpar a seleção atual definindo essa propriedade como uma matriz vazia ou como um valor de indefinido. Se nenhum item for selecionado na lista de itens, essa propriedade é indefinida.

A sequência de valores na matriz reflete a ordem na qual os itens foram selecionados na lista de seleção múltipla. Por exemplo, se você clicar no segundo item na lista e em seguida, no terceiro item e, finalmente, no primeiro item, essa propriedade contém uma matriz de valores na seguinte sequência: [1,2,0].

Implementação
public function get selectedIndices():Array
public function set selectedIndices(value:Array):void

Elementos da API relacionados

allowMultipleSelection
selectedIndex
selectedItems

selectedItem

propriedade

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

Obtém ou define o item que foi selecionado a partir de uma lista de seleção única. Para uma lista de seleção múltipla, na qual vários itens são selecinados, essa propriedade contém o item que foi selecionado por último.

Se nenhuma seleção for feita, o valor dessa propriedade é null.

Implementação
public function get selectedItem():Object
public function set selectedItem(value:Object):void

Elementos da API relacionados

selectedIndex
selectedItems

Exemplo ( Como usar este exemplo )

Esse exemplo rastreia o rótulo e o índice de linhas de qualquer item em uma lista que foi clicada.


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

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

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

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

selectedItems

propriedade

selectedItems:Array

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 uma matriz que contém os objetos para os itens que foram selecionados a partir da lista de seleção múltipla.

Para uma lista de seleção única, o valor dessa propriedade é uma matriz contendo o único item selecionado. Em uma lista de seleção única, a propriedade allowMultipleSelection é definida como false.

Implementação
public function get selectedItems():Array
public function set selectedItems(value:Array):void

Elementos da API relacionados

allowMultipleSelection
selectedIndices
selectedItem

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria ocorrências do componente List e copia os itens selecionados da lista A para a lista B:


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

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

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

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

Detalhes do construtor

()

Construtor

public function SelectableList()

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 de SelectableList.

Detalhes do método

addItem

()

método

public function addItem(item:Object):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

Acrescenta um item ao final da lista de itens.

Um item deve conter as propriedades label e data; no entanto, os itens que contêm outras propriedades também podem ser adicionados à lista. Por padrão, a propriedade label de um item é usada para exibir o rótulo da linha; a propriedade data é usada para armazenar os dados da linha.

Parâmetros

item:Object — O item a ser adicionado ao provedor de dados.

Elementos da API relacionados

addItemAt()

addItemAt

()

método

public function addItemAt(item:Object, index:uint):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

Insere um item na lista, na localização de índice especificada. Os índices de itens no local de índice especificado ou depois dele, são incrementados em 1.

Parâmetros

	`item:Object` — O item a ser adicionado à lista.

	`index:uint` — O índice ao qual o item é adicionado.

Lança

RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.

Elementos da API relacionados

addItem()
replaceItemAt()

clearRendererStyle

()

método

public function clearRendererStyle(name:String, column:int = -1):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

Apaga um estilo definido nos renderizadores da lista.

Parâmetros

	`name:String` — O nome do estilo a ser limpo.

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

Elementos da API relacionados

getRendererStyle()
setRendererStyle()

clearSelection

()

método

public function clearSelection():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

Limpa o item selecionado atualmente na lista e define a propriedade selectedIndex em -1.

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria uma ocorrência do componente List e limpa os itens da lista selecionados atualmente quando o componente Button é clicado:


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

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

var dp:DataProvider = new DataProvider(data);

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

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

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

getItemAt

()

método

public function getItemAt(index:uint):Object

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 item no índice especificado.

Parâmetros

index:uint — O índice do item a ser recuperado.

Retorna

Object — O objeto no local de índice especificado.

Lança

RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.

getNextIndexAtLetter

()

método

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

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

Retorna o índice do próximo item em dataProvider, no qual o primeiro caractere do rótulo corresponde a um caractere de string especificado. Se a pesquisa atingir o final do dataProvider sem procurar todos os itens, ela retornará ao início. A pesquisa não inclui o startIndex.

Parâmetros

	`firstLetter:String` — O caractere da string a ser procurado

	`startIndex:int` (default = `-1`) — O índice no dataProvider com o qual iniciar.

Retorna

int — O índice do próximo item no dataProvider.

getRendererStyle

()

método

public function getRendererStyle(name:String, column:int = -1):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 um estilo definido nos renderizadores da lista.

Parâmetros

	`name:String` — O nome do estilo a ser recuperado.

	`column:int` (default = `-1`) — O valor do estilo a ser recuperado.

Retorna

Object

Elementos da API relacionados

clearRendererStyle()
setRendererStyle()

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

invalidateItem

()

método

public function invalidateItem(item:Object):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

Invalida um renderizador de item específico.

Parâmetros

item:Object — O item no provedor de dados a ser invalidado.

Elementos da API relacionados

invalidateItemAt()
invalidateList()

invalidateItemAt

()

método

public function invalidateItemAt(index:uint):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

Invalida o renderizador do item no índice especificado.

Parâmetros

index:uint — O índice do item no provedor de dados a ser invalidado.

Elementos da API relacionados

invalidateItem()
invalidateList()

invalidateList

()

método

public function invalidateList():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

Invalida a lista inteira, forçando o redesenho dos itens da lista.

Elementos da API relacionados

invalidateItem()
invalidateItemAt()

isItemSelected

()

método

public function isItemSelected(item:Object):Boolean

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

Verifica se o item especificado está selecionado na lista.

Parâmetros

item:Object — O item a ser verificado.

Retorna

Boolean — Esse método retorna true se o item especificado for selecionado; caso contrário, se o item especificado tiver um valor de null ou se ele não for incluído na lista, esse método retorna false.

itemToCellRenderer

()

método

public function itemToCellRenderer(item:Object):ICellRenderer

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 ICellRenderer para um determinado objeto de item, se houver um. Esse método sempre retorna null.

Parâmetros

item:Object — O item no provedor de dados.

Retorna

ICellRenderer — Um valor de null.

Exemplo ( Como usar este exemplo )

O exemplo a seguir demonstra como adquirir o renderizador de célula para um item selecionado em uma lista:

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

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

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

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

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

itemToLabel

()

método

public function itemToLabel(item:Object):String

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 que o renderizador exibe para o objeto de dados determinado com base nas propriedades label do objeto. Esse método destina-se a ser sobrescrito em subcomponentes. Por exemplo, List tem um labelField e um labelFunction para derivar o rótulo.

Parâmetros

item:Object

Retorna

String

removeAll

()

método

public function removeAll():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

Remove todos os itens da lista.

removeItem

()

método

public function removeItem(item:Object):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

Remove o item especificado da lista.

Parâmetros

item:Object — O item a ser removido.

Retorna

Object — O item que foi removido.

Lança

RangeError — Não foi possível encontrar o item.

Elementos da API relacionados

removeAll()
removeItemAt()

removeItemAt

()

método

public function removeItemAt(index:uint):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

Remove o item na posição de índice especificada. Os índices de itens no local de índice especificado ou depois dele, são diminuídos em 1.

Parâmetros

index:uint — O índice do item no provedor de dados a ser removido.

Retorna

Object — O item que foi removido.

Elementos da API relacionados

removeAll()
removeItem()
replaceItemAt()

replaceItemAt

()

método

public function replaceItemAt(item:Object, index:uint):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

Substitui o item na localização de índice especificada por outro item. Esse método modifica o provedor de dados do componente List. Se o provedor de dados for compartilhado com outros elementos, os dados fornecidos a esses componentes também são atualizados.

Parâmetros

	`item:Object` — O item para substituir o item no local de índice especificado.

	`index:uint` — A posição de índice do item a ser substituído.

Retorna

Object — O item que foi substituído.

Lança

RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.

Elementos da API relacionados

removeItemAt()

scrollToIndex

()

método

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.

scrollToSelected

()

método

public function scrollToSelected():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 local indicado pelo valor atual da propriedade selectedIndex.

Elementos da API relacionados

selectedIndex
scrollToIndex()

setRendererStyle

()

método

public function setRendererStyle(name:String, style:Object, column:uint = 0):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

Define um estilo nos renderizadores da lista.

Parâmetros

	`name:String` — O nome do estilo a ser definido.

	`style:Object` — O valor do estilo a ser definido.

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

Elementos da API relacionados

clearRendererStyle()
getRendererStyle()

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria um componente List e usa o método setRendererStyle() para aplicar um formato de texto aos itens da lista:


import fl.controls.List;

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

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

O exemplo a seguir cria um componente List e usa o método setRendererStyle() para aplicar um formato de texto aos itens da lista:


import fl.controls.DataGrid;

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

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

O exemplo a seguir cria um componente TileList e usa o método setRendererStyle() para aplicar um formato de texto aos itens da lista:


import fl.controls.TileList;

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

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

O exemplo a seguir cria um componente ComboBox e usa o método setRendererStyle() para aplicar um formato de texto aos itens da lista:


import fl.controls.ComboBox;

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

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

sortItems

()

método

public function sortItems(... sortArgs):*

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

Classifica os elementos do provedor de dados atual. Esse método realiza uma classificação com base nos valores Unicode dos elementos. ASCII é um subconjunto de Unicode.

Parâmetros

... sortArgs — Os argumentos contra os quais ocorre a classificação.

Retorna

* — O valor de retorno depende de os parâmetros serem passados a esse método ou não. Para obter mais informações, consulte o método Array.sort(). Observe que esse método retorna 0, quando o parâmetro sortArgs é definido como Array.UNIQUESORT.

Elementos da API relacionados

sortItemsOn()
Array.sort()

sortItemsOn

()

método

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

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

Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos.

Parâmetros

	`field:String` — O campo no qual classificar.

	`options:Object` (default = `null`) — Classificar argumentos que são usados para substituir o comportamento de classificação padrão. Separe dois ou mais argumentos com o operador OR (\|) bit a bit.

Retorna

* — O valor de retorno depende de os parâmetros serem passados a esse método ou não. Para obter mais informações, consulte o método Array.sortOn(). Observe que esse método retorna 0, quando o parâmetro sortOption está definido como Array.UNIQUESORT.

Elementos da API relacionados

sortItems()
DataProvider.sortOn()

Exemplo ( Como usar este exemplo )

O exemplo a seguir classifica uma lista com base em um valor no provedor de dados usando o método sortItemsOn():


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

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

var dp:DataProvider = new DataProvider(players);

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

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

Detalhe do evento

change

Evento

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

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

Despachado quando um item diferente é selecionado na lista.

A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`true`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto que tem seus respectivos valores modificados. `target` não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade `currentTarget` para acessar o objeto na lista de exibição que está processando o evento no momento.

itemClick

Evento

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

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

Despachado quando o usuário clica em um item no componente.

O evento click é despachado antes da alteração do valor do componente. Para identificar a linha e a coluna que receberam cliques, use as propriedades do objeto de evento; não use as propriedades selectedIndex e selectedItem.

Define o valor da propriedade type de um objeto de evento itemClick.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	O índice com base em zero da coluna que contém o renderizador.
`currentTarget`	O objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
`index`	O índice com base em zero do DataProvider que contém o renderizador.
`item`	Uma referência aos dados que pertencem ao renderizador.
`rowIndex`	O índice com base em zero da linha que contém o renderizador.
`target`	O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade `currentTarget` para acessar o objeto ouvinte do evento.

itemDoubleClick

Evento

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

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

Despachado quando o usuário clica em um item no componente duas vezes em rápida sucessão. Ao contrário do evento click o evento doubleClick é despachado depois que o selectedIndex do componente é alterado.

Define o valor da propriedade type de um objeto de evento itemDoubleClick.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	O índice com base em zero da coluna que contém o renderizador.
`currentTarget`	O objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
`index`	O índice com base em zero do DataProvider que contém o renderizador.
`item`	Uma referência aos dados que pertencem ao renderizador.
`rowIndex`	O índice com base em zero da linha que contém o renderizador.
`target`	O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade `currentTarget` para acessar o objeto ouvinte do evento.

itemRollOut

Evento

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

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

Despachado quando o usuário rola o ponteiro para fora de um item no componente.

Define o valor da propriedade type de um objeto de evento itemRollOut.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`columnIndex`	O índice com base em zero da coluna que contém o renderizador.
`currentTarget`	O objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
`index`	O índice com base em zero do DataProvider que contém o renderizador.
`item`	Uma referência aos dados que pertencem ao renderizador.
`rowIndex`	O índice com base em zero da linha que contém o renderizador.
`target`	O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade `currentTarget` para acessar o objeto ouvinte do evento.

Elementos da API relacionados

itemRollOver

Evento

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

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

Despachado quando o usuário rola o ponteiro sobre um item no componente.

Define o valor da propriedade type de um objeto de evento itemRollOver.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`columnIndex`	O índice com base em zero da coluna que contém o renderizador.
`currentTarget`	O objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
`index`	O índice com base em zero do DataProvider que contém o renderizador.
`item`	Uma referência aos dados que pertencem ao renderizador.
`rowIndex`	O índice com base em zero da linha que contém o renderizador.
`target`	O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade `currentTarget` para acessar o objeto ouvinte do evento.

Elementos da API relacionados

itemRollOut

rollOut

Evento

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

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

Despachado quando o usuário rola o ponteiro para fora do componente.

Define o valor da propriedade type de um objeto de evento rollOut.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`altKey`	`true` caso a tecla Alt esteja ativa (Windows).
`bubbles`	`false`
`buttonDown`	`true` se o botão principal do mouse estiver pressionado; `false` se não estiver.
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`commandKey`	`true` no Mac se a tecla Command estiver ativa; `false` se estiver inativa. Sempre `false` no Windows.
`controlKey`	`true` se a tecla Ctrl ou Control estiver ativa; `false` se estiver inativa.
`ctrlKey`	`true` no Windows ou no Linux caso a tecla Ctrl esteja ativa. `true` no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, `false`.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`relatedObject`	O objeto da lista de exibição para o qual o dispositivo apontador aponta agora.
`localX`	A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado.
`localY`	A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado.
`movementX`	A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado.
`movementY`	A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado.
`shiftKey`	`true` se a tecla Shift estiver ativa; `false` se estiver inativa.
`stageX`	A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco.
`stageY`	A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco.
`target`	A ocorrência InteractiveObject sob o dispositivo apontador. `target` não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade `currentTarget` para acessar o objeto na lista de exibição que está processando o evento no momento.

Elementos da API relacionados

rollOver

Evento

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

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

Despachado quando o usuário rola o ponteiro sobre o componente.

Define o valor da propriedade type de um objeto de evento rollOver.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`altKey`	`true` caso a tecla Alt esteja ativa (Windows).
`bubbles`	`false`
`buttonDown`	`true` se o botão principal do mouse estiver pressionado; `false` se não estiver.
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`commandKey`	`true` no Mac se a tecla Command estiver ativa; `false` se estiver inativa. Sempre `false` no Windows.
`controlKey`	`true` se a tecla Ctrl ou Control estiver ativa; `false` se estiver inativa.
`ctrlKey`	`true` no Windows ou no Linux caso a tecla Ctrl esteja ativa. `true` no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, `false`.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`relatedObject`	O objeto da lista de exibição para o qual o dispositivo apontador estava apontando.
`localX`	A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado.
`localY`	A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado.
`movementX`	A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado.
`movementY`	A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado.
`shiftKey`	`true` se a tecla Shift estiver ativa; `false` se estiver inativa.
`stageX`	A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco.
`stageY`	A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco.
`target`	A ocorrência InteractiveObject sob o dispositivo apontador. `target` não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade `currentTarget` para acessar o objeto na lista de exibição que está processando o evento no momento.

Elementos da API relacionados

rollOut

scroll

Evento

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

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

Despachado quando o usuário rola horizontal ou verticalmente.

Define o valor da propriedade type de um objeto de evento scroll.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
`delta`	`1`; um valor que indica a quantidade de rolagem realizada.
`direção`	`vertical`; a direção da barra de rolagem.
`position`	`0`; a posição da miniatura da barra de rolagem após ela ser movida.
`target`	O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade `currentTarget` para acessar o objeto ouvinte do evento.

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

SelectableList - AS3 Flash

Classes x

allowMultipleSelection

dataProvider

length

maxHorizontalScrollPosition

rowCount

selectable

selectedIndex

selectedIndices

selectedItem

selectedItems

SelectableList

addItem

addItemAt

clearRendererStyle

clearSelection

getItemAt

getNextIndexAtLetter

getRendererStyle

getStyleDefinition

invalidateItem

invalidateItemAt

invalidateList

isItemSelected

itemToCellRenderer

itemToLabel

removeAll

removeItem

removeItemAt

replaceItemAt

scrollToIndex

scrollToSelected

setRendererStyle

sortItems

sortItemsOn

change

itemClick

itemDoubleClick

itemRollOut

itemRollOver

rollOut

rollOver

scroll