Pacote | fl.controls |
Classe | public class ComboBox |
Herança | ComboBox 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 |
Elementos da API relacionados
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 | ||
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. | ComboBox | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
dropdown : List [somente leitura]
Obtém uma referência ao componente List que o componente ComboBox contém. | ComboBox | ||
dropdownWidth : Number
Obtém ou define a largura máxima da lista suspensa, em pixels. | ComboBox | ||
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 | ||
editable : Boolean
Obtém ou define um valor booliano que indica se o componente ComboBox é editável ou somente leitura. | ComboBox | ||
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 | ||
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. | ComboBox | ||
labelFunction : Function
Obtém ou define a função a ser usada para obter o rótulo do item. | ComboBox | ||
length : int [somente leitura]
Obtém o número de itens na lista. | ComboBox | ||
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 | ||
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 | ||
prompt : String
Obtém ou define o prompt para o componente ComboBox. | ComboBox | ||
restrict : String
Obtém ou define os caracteres que um usuário pode inserir no campo de texto. | ComboBox | ||
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
Obtém ou define o número máximo de linhas que podem aparecer em uma lista suspensa que não tem uma barra de rolagem. | ComboBox | ||
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 | ||
selectedIndex : int
Obtém ou define o índice do item selecionado em uma lista de seleção única. | ComboBox | ||
selectedItem : Object
Obtém ou define o valor do item selecionado na lista suspensa. | ComboBox | ||
selectedLabel : String [somente leitura]
Obtém a string exibida na parte TextInput do componente ComboBox. | ComboBox | ||
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 | ||
text : String
Obtém ou define o texto que a caixa de texto contém em um componente ComboBox editável. | ComboBox | ||
textField : fl.controls:TextInput [somente leitura]
Obtém uma referência ao componente TextInput que o componente ComboBox contém. | ComboBox | ||
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 | ||
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 | ||
value : String [somente leitura]
Obtém o rótulo de um item em um componente ComboBox editável. | ComboBox | ||
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étodo | Definido por | ||
---|---|---|---|
ComboBox()
Cria uma nova ocorrência do componente ComboBox. | ComboBox | ||
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
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 | ||
Acrescenta um item ao final da lista de itens. | ComboBox | ||
Insere um item na lista, na localização de índice especificada. | ComboBox | ||
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 | ||
Exclui uma propriedade de estilo desta ocorrência do componente. | UIComponent | ||
Fecha a lista suspensa. | ComboBox | ||
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Mostra ou oculta o indicador de foco neste componente. | UIComponent | ||
Inicia uma operação imediata de desenho, sem invalidar nada como faz invalidateNow. | UIComponent | ||
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | ||
Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado. | DisplayObjectContainer | ||
Retorna o objeto de exibição-filho que existe com o nome especificado. | DisplayObjectContainer | ||
Retorna a posição de índice de uma ocorrência-filho de DisplayObject. | DisplayObjectContainer | ||
Recupera o objeto que possui foco no momento. | UIComponent | ||
Recupera o item no índice especificado. | ComboBox | ||
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 | ||
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 | ||
Recupera uma propriedade de estilo definida na cadeia de pesquisa de estilo do componente. | UIComponent | ||
[estático]
Recupera o mapa de estilos padrão do componente atual. | ComboBox | ||
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | DisplayObject | ||
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais). | DisplayObject | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
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 | ||
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 | ||
Marca uma propriedade como inválida e redesenha o componente no quadro seguinte, a não ser que especificado de outra forma. | UIComponent | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Recupera a string exibida pelo renderizador para o objeto de dados especificado com base nas propriedades labelField e labelFunction. | ComboBox | ||
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco. | DisplayObject | ||
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | DisplayObject | ||
[estático]
Mescla os estilos de várias classes em um objeto. | UIComponent | ||
Move o componente até a posição especificada em seu pai. | UIComponent | ||
Abre a lista suspensa. | ComboBox | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove todos os itens da lista. | ComboBox | ||
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Remove o item especificado da lista. | ComboBox | ||
Remove o item na posição de índice especificada. | ComboBox | ||
Substitui o item na localização de índice especificada por outro item. | ComboBox | ||
Ativa um teclado virtual. | InteractiveObject | ||
Altera a posição de um filho existente no contêiner de objetos de exibição. | DisplayObjectContainer | ||
Define o foco para este componente. | UIComponent | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Define o componente para a largura e altura especificadas. | UIComponent | ||
Define uma propriedade de estilo nesta ocorrência do componente. | UIComponent | ||
Classifica os elementos do provedor de dados atual. | ComboBox | ||
Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos. | ComboBox | ||
Permite ao usuário arrastar a entidade gráfica especificada. | Sprite | ||
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque. | Sprite | ||
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | ||
Finaliza o método startDrag(). | Sprite | ||
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque. | Sprite | ||
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | ||
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 | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Valida e atualiza as propriedades e o layout deste objeto, redesenhando-o se necessário. | UIComponent | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
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 |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[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 | |||
Despachado quando um objeto de exibição é adicionado à lista de exibição. | DisplayObject | |||
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 | |||
Despachado quando o usuário altera a seleção do componente ComboBox ou, se o componente ComboBox for editável, sempre que o usuário fizer um pressionamento de tecla no campo de texto. | ComboBox | |||
Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. | InteractiveObject | |||
Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando a lista suspensa é dispensada por algum motivo. | ComboBox | |||
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR. | InteractiveObject | |||
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 | |||
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 | |||
[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 | |||
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 | |||
Despachado se a propriedade editável for definida como true e o usuário pressionar a tecla Enter enquanto estiver digitando em um campo de texto editável. | ComboBox | |||
[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro. | DisplayObject | |||
[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual. | DisplayObject | |||
Despachado depois que um objeto de exibição ganha foco. | InteractiveObject | |||
Despachado depois que um objeto de exibição perde o foco. | InteractiveObject | |||
[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts. | DisplayObject | |||
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 | |||
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 | |||
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 | |||
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 | |||
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 | |||
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 | |||
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 | |||
Despachado depois que a visibilidade do componente muda de visível para invisível. | UIComponent | |||
Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME | InteractiveObject | |||
Define o valor da propriedade de tipo de um objeto de evento itemRollOut. | ComboBox | |||
Define o valor da propriedade de tipo de um objeto de evento itemRollOver. | ComboBox | |||
Despachado quando o usuário pressiona uma tecla. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. | InteractiveObject | |||
Despachado quando o usuário solta uma tecla. | InteractiveObject | |||
Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. | InteractiveObject | |||
Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado após a movimentação do componente. | UIComponent | |||
Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar. | InteractiveObject | |||
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 | |||
Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite. | InteractiveObject | |||
Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite. | InteractiveObject | |||
Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite. | InteractiveObject | |||
Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado quando o usuário clica no botão suspenso para exibir a lista suspensa. | ComboBox | |||
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 | |||
Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade. | InteractiveObject | |||
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 | |||
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 | |||
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 | |||
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 | |||
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 | |||
Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição. | DisplayObject | |||
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 | |||
[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada. | DisplayObject | |||
Despachado após o redimensionamento do componente. | UIComponent | |||
Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário rola pela lista suspensa do componente ComboBox. | ComboBox | |||
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 | |||
Despachado depois que a visibilidade do componente muda de invisível para visível. | UIComponent | |||
Despachado imediatamente depois que o teclado virtual é elevado. | InteractiveObject | |||
Despachado imediatamente antes de o teclado virtual ser elevado. | InteractiveObject | |||
Despachado imediatamente depois que o teclado virtual é baixado. | InteractiveObject | |||
Despachado quando o valor do sinalizador tabChildren do objeto é alterado. | InteractiveObject | |||
Despachado quando o sinalizador tabEnabled do objeto é alterado. | InteractiveObject | |||
Despachado quando o valor da propriedade tabIndex do objeto é alterado. | InteractiveObject | |||
Despachado quando um usuário introduz um ou vários caracteres do texto. | InteractiveObject | |||
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 | |||
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 | |||
Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. | InteractiveObject | |||
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 | |||
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 | |||
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 | |||
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 | |||
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 |
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.
Estilo | Descrição | Definido por | ||
---|---|---|---|---|
buttonWidth | 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 espaço que separa a borda direita do componente do texto que representa o item selecionado, em pixels. O botão é parte da capa do plano de fundo. O valor padrão é 24 . | ComboBox | ||
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.controls.listClasses.CellRenderer . | ComboBox | ||
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 Preenchimento entre o conteúdo (componente e barra de rolagem) e a borda externa do plano de fundo, em pixels. O valor padrão é 3 . | ComboBox | ||
disabledAlpha | 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 O valor de alfa para definir a lista quando a propriedade enabled for false .
O valor padrão é 0.5 . | ComboBox | ||
disabledSkin | 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 O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando a propriedade enabled do componente está definida como false .
O valor padrão é ComboBox_disabledSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_disabledSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_downSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_overSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowDown_upSkin . | ComboBox | ||
downSkin | 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 O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando o mouse está desativado. O valor padrão é ComboBox_downSkin . | ComboBox | ||
embedFonts | Tipo: Boolean Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Indica se os contornos de fonte incorporados são usados para renderizar o campo de texto. Se esse valor for true , o Flash Player renderiza o campo de texto usando contornos de fontes incorporados. Se esse valor for false , o Flash Player renderiza o campo de texto usando fontes do dispositivo.
Se você definir a propriedade false . | ComboBox | ||
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 | |||
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 | |||
overSkin | 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 O nome da classe que fornece o plano de fundo exibido no componente ComboBox, quando o mouse está sobre o componente. O valor padrão é ComboBox_overSkin . | ComboBox | ||
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 .
O valor padrão é 500 . | ComboBox | ||
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 .
O valor padrão é 35 . | ComboBox | ||
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 | |||
textPadding | 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 espaço que separa a borda do texto que representa o item selecionado, em pixels. O valor padrão é 3 . | ComboBox | ||
thumbArrowUpSkin | 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. O valor padrão é ScrollThumb_upSkin . | ComboBox | ||
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. O valor padrão é ScrollThumb_upSkin . | ComboBox | ||
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. O valor padrão é ScrollThumb_downSkin . | ComboBox | ||
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. O valor padrão é ScrollBar_thumbIcon . | ComboBox | ||
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. O valor padrão é ScrollThumb_overSkin . | ComboBox | ||
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. O valor padrão é ScrollTrack_Skin . | ComboBox | ||
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. O valor padrão é ScrollTrack_Skin . | ComboBox | ||
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. O valor padrão é ScrollTrack_Skin . | ComboBox | ||
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. O valor padrão é ScrollTrack_Skin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_disabledSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_downSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_overSkin . | ComboBox | ||
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. Se você alterar a capa graficamente ou de forma programática, é recomendável verificar se a nova capa tem a mesma altura (para barras de rolagem horizontais) ou largura (para barras de rolagem verticais) da faixa. O valor padrão é ScrollArrowUp_upSkin . | ComboBox | ||
upSkin | 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 O nome da classe que fornece o plano de fundo para o componente ComboBox. O valor padrão é ComboBox_upSkin . | ComboBox |
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.
Implementação
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); var cb:ComboBox = new ComboBox(); cb.dataProvider = dp; addChild(cb); var counter = 0; var t:Timer = new Timer(500); t.addEventListener(TimerEvent.TIMER,addAnotherItem); t.start(); function addAnotherItem(e:TimerEvent = null):void { dp.addItem( { label: "Item " + counter++ } ); }
dropdown | propriedade |
dropdown:List
[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 uma referência ao componente List que o componente ComboBox contém. O subcomponente List não tem ocorrências em ComboBox, até que seja necessário exibi-lo. No entanto, a lista é criada quando a propriedade dropdown
é acessada.
Implementação
public function get dropdown():List
dropdownWidth | propriedade |
dropdownWidth: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 largura máxima da lista suspensa, em pixels. O valor padrão dessa propriedade é a largura do componente ComboBox (a largura a ocorrência de TextInput mais a largura da ocorrência de BaseButton).
O valor padrão é 100.
Implementação
public function get dropdownWidth():Number
public function set dropdownWidth(value:Number):void
Exemplo ( Como usar este exemplo )
dropdownWidth
com base no valor de um componente Slider:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var mySlider:Slider = new Slider(); mySlider.minimum = 50; mySlider.maximum = 150; mySlider.liveDragging = true; mySlider.snapInterval = 5; mySlider.tickInterval = 10; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); mySlider.move(10, 10); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.move(10, 30); addChild(myComboBox); mySlider.value = myComboBox.dropdownWidth; function changeHandler(event:SliderEvent):void { myComboBox.dropdownWidth = event.value; }
dropdownWidth
com base no comprimento do texto na lista suspensa:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"The quick brown fox"}); myComboBox.addItem({label:"Lorem ipsum"}); myComboBox.addItem({label:"Little Miss Muffet"}); myComboBox.addItem({label:"Goldilocks and the three bears"}); myComboBox.addItem({label:"Jack and Jill"}); myComboBox.move(10, 30); addChild(myComboBox); var maxLength:Number = 0; var i:uint; for (i = 0; i < myComboBox.length; i++) { myComboBox.selectedIndex = i; myComboBox.drawNow(); var currText:String = myComboBox.text; var currWidth:Number = myComboBox.textField.textWidth; maxLength = Math.max(currWidth, maxLength); trace(currText, currWidth, maxLength); } myComboBox.selectedIndex = -1; myComboBox.dropdownWidth = maxLength + 20; myComboBox.open();
editable | propriedade |
editable: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 o componente ComboBox é editável ou somente leitura. Um valor true
indica que o componente ComboBox é editável; um valor false
indica que ele não é editável.
Em um componente ComboBox editável, um usuário pode inserir valores na caixa de texto que não é exibida na lista suspensa. A caixa de texto exibe o texto do item na lista. Se um componente ComboBox não é editável, o texto não pode ser inserido na caixa de texto.
O valor padrão é false.
Implementação
public function get editable():Boolean
public function set editable(value:Boolean):void
Exemplo ( Como usar este exemplo )
enter
é despachado:
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox; myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var myCB:ComboBox = event.currentTarget as ComboBox; dp.addItem({label:myCB.text}); myCB.text = ""; myCB.sortItemsOn("label", Array.CASEINSENSITIVE); }
labelField | 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
Exemplo ( Como usar este exemplo )
labelField
para definir um campo de texto personalizado:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["firstName","lastName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelField = "firstName"; myComboBox.move(10, 10); addChild(myComboBox);
labelFunction | 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.
Implementação
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
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) + ")"; }
labelField
para definir um campo de texto personalizado:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["lastName", "firstName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
length | propriedade |
length:int
[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 na lista. Essa propriedade pertence a um componente List, mas pode ser acessado em uma ocorrência de ComboBox.
O valor padrão é 0.
Implementação
public function get length():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
rowCount
com base na quantidade de itens em ComboBox:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.addItem({label:"Item E"}); myComboBox.addItem({label:"Item F"}); myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
rowCount
com base na quantidade de itens em ComboBox:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Item A"}); dp.addItem({label:"Item B"}); dp.addItem({label:"Item C"}); dp.addItem({label:"Item D"}); dp.addItem({label:"Item E"}); dp.addItem({label:"Item F"}); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
prompt | propriedade |
prompt: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 prompt para o componente ComboBox. Esse prompt é uma string exibia na parte de TextInput do ComboBox, quando selectedIndex
for -1. Geralmente, é uma string como "Selecione um...". Se um prompt não for definido, o componente ComboBox define a propriedade selectedIndex
como 0 e exibe o primeiro item na propriedade dataProvider
.
O valor padrão é "".
Implementação
public function get prompt():String
public function set prompt(value:String):void
Exemplo ( Como usar este exemplo )
prompt
e redimensiona a caixa de combinação para ajustar a largura do texto do prompt:
import fl.controls.ComboBox; var cbStyles:Object = ComboBox.getStyleDefinition(); var bW:Number = cbStyles.buttonWidth as Number var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an option..."; myComboBox.addItem({label:"Option 1"}); myComboBox.addItem({label:"Option 2"}); myComboBox.drawNow(); myComboBox.width = myComboBox.textField.textWidth + 35; myComboBox.dropdownWidth = myComboBox.width - bW; myComboBox.move(10, 10); addChild(myComboBox);
prompt
com base no número de itens em seu provedor de dados:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Getting Started"}); dp.addItem({label:"New Features"}); dp.addItem({label:"ActionScript"}); dp.addItem({label:"Components"}); dp.sortOn("label", Array.CASEINSENSITIVE); var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Topics (" + dp.length + ")"; myComboBox.dataProvider = dp; myComboBox.width = 150; myComboBox.move(10, 10); addChild(myComboBox);
restrict | propriedade |
restrict: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 os caracteres que um usuário pode inserir no campo de texto. Se o valor da propriedade restrict
for uma string de caracteres, você poderá digitar apenas os caracteres da string no campo de texto. A string é lida da esquerda para a direita. Se o valor da propriedade restrict
for null
, você poderá digitar qualquer caractere. Se o valor da propriedade restrict
for uma string vazia (""), não é possível inserir qualquer caractere. É possível especificar um intervalo usando o caractere hífen (-). Isso restringe apenas a interação com o usuário; um script pode colocar qualquer caractere no campo de texto.
O valor padrão é null.
Implementação
public function get restrict():String
public function set restrict(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
restrict
:
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.restrict = "0-9A-F"; myComboBox.textField.maxChars = 6; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var colorStr:String = ComboBox(event.currentTarget).text; var colorNum:uint = uint("0x" + colorStr); dp.addItem({label:colorStr, value:colorNum}); dp.sortOn("value", Array.NUMERIC); event.currentTarget.text = ""; }
rowCount | propriedade |
rowCount:uint
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 máximo de linhas que podem aparecer em uma lista suspensa que não tem uma barra de rolagem. Se o número de itens na lista suspensa exceder esse valor, a lista é redimensionada e uma barra de rolagem é exibida, se necessário. Se o número de itens na lista suspensa for menor do que esse valor, a lista suspensa é redimensionada para acomodar o número de itens que ela contém.
Esse comportamento é diferente do componente List, que sempre mostra o número de linhas especificado pela propriedade rowCount
, mesmo que inclua espaços vazios.
O valor padrão é 5.
Implementação
public function get rowCount():uint
public function set rowCount(value:uint):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
rowCount
para um componente ComboBox:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var numItems:uint = 8; var mySlider:Slider = new Slider(); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 1; mySlider.maximum = numItems; mySlider.liveDragging = true; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.move(10, 30); addChild(myComboBox); var i:uint; for (i = 0; i < numItems; i++) { myComboBox.addItem({label:"Item " + i}); } function changeHandler(event:SliderEvent):void { myComboBox.rowCount = event.value; }
selectedIndex | 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.
O valor padrão é 0.
Implementação
public function get selectedIndex():int
public function set selectedIndex(value:int):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
selectedIndex
da ocorrência do componente ComboBox:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.data.DataProvider; import fl.events.SliderEvent; var items:XML = <items> <item label="Item 1" /> <item label="Item 2" /> <item label="Item 3" /> <item label="Item 4" /> </items>; var dp:DataProvider = new DataProvider(items); var mySlider:Slider = new Slider(); mySlider.liveDragging = true; mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 0; mySlider.maximum = dp.length - 1; mySlider.width = 100; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.move(10, 30); addChild(myComboBox); function changeHandler(event:SliderEvent):void { myComboBox.selectedIndex = event.value; }
selectedIndex
em um rótulo no Palco:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an item..."; myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.addItem({label:"Item 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; }
selectedItem | 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 valor do item selecionado na lista suspensa. Se o usuário inserir texto na caixa de texto de um componente ComboBox editável, a propriedade selectedItem
fica indefinida
. Essa propriedade tem um valor apenas se o usuário selecionar um item ou se o ActionScript for usado para selecionar um item na lista suspensa. Se o componente ComboBox não for editável, o valor da propriedade selectedItem
é sempre válido. Se não houver itens na lista suspensa de um componente ComboBox editável, o valor dessa propriedade é null
.
O valor padrão é null.
Implementação
public function get selectedItem():Object
public function set selectedItem(value:Object):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.List; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select an item"; myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.move(10, 10); addChild(myComboBox); var myButton:Button = new Button(); myButton.label = "Copy"; myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var myList:List = new List(); myList.rowCount = myList.length; myList.selectable = false; myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myList); function clickHandler(event:MouseEvent):void { if (myComboBox.selectedIndex > -1) { myList.addItem(myComboBox.selectedItem); myList.rowCount = myList.length; } }
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var firstNameLabel:Label = new Label(); firstNameLabel.text = ""; firstNameLabel.autoSize = TextFieldAutoSize.LEFT; firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(firstNameLabel); var lastNameLabel:Label = new Label(); lastNameLabel.text = ""; lastNameLabel.autoSize = TextFieldAutoSize.LEFT; lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height); addChild(lastNameLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; var item:Object = cb.selectedItem; if (cb.selectedIndex > -1) { firstNameLabel.text = item.firstName; lastNameLabel.text = item.lastName; } } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
selectedLabel | propriedade |
selectedLabel:String
[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 a string exibida na parte TextInput do componente ComboBox. Esse valor é calculado a partir dos dados usando a propriedade labelField
ou labelFunction
.
Implementação
public function get selectedLabel():String
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
selectedLabel
para um ComboBox:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "selectedLabel: " + cb.selectedLabel; } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
text | propriedade |
text: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 texto que a caixa de texto contém em um componente ComboBox editável. Para componentes ComboBox que não são editáveis, esse valor é somente leitura.
O valor padrão é "".
Implementação
public function get text():String
public function set text(value:String):void
Exemplo ( Como usar este exemplo )
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ComponentEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.width = 300; myComboBox.move(10, 10); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.wordWrap = false; myTextArea.setSize(300, 200); myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myTextArea) function textInputHandler(event:TextEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\t" + event.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function enterHandler(event:ComponentEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function autoScroll(ta:TextArea):void { ta.verticalScrollPosition = ta.maxVerticalScrollPosition; }
textField | propriedade |
textField:fl.controls:TextInput
[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 uma referência ao componente TextInput que o componente ComboBox contém. Use essa propriedade para acessar e manipular o componente TextInput subjacente. Por exemplo, é possível usar essa propriedade para alterar a seleção da caixa de texto ou para restringir o conjunto de caracteres que podem ser inseridos nessa caixa de texto.
Implementação
public function get textField():fl.controls:TextInput
Exemplo ( Como usar este exemplo )
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.textField.maxChars = 8; myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; var comicSansTF:TextFormat = new TextFormat(); comicSansTF.font = "Comic Sans MS"; var myComboBox:ComboBox = new ComboBox(); myComboBox.textField.setStyle("textFormat", comicSansTF); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; import fl.data.DataProvider; var myTextFormat:TextFormat = new TextFormat(); myTextFormat.font = "Comic Sans MS"; myTextFormat.color = 0xFF0000; var fontArray:Array = Font.enumerateFonts(true); fontArray.sortOn("fontName", Array.CASEINSENSITIVE); var dp:DataProvider = new DataProvider(fontArray); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.dropdown.iconField = null; myComboBox.labelField = "fontName"; myComboBox.textField.setStyle("textFormat", myTextFormat); myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat); myComboBox.width = 200; myComboBox.move(10, 10); addChild(myComboBox);
value | propriedade |
value:String
[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 rótulo de um item em um componente ComboBox editável. Para o componente ComboBox que não é editável, essa propriedade obtém os dados que o item contém.
Implementação
public function get value():String
Exemplo ( Como usar este exemplo )
value
para um ComboBox editável:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); myComboBox.editable = true; addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "value: " + cb.value; } function nameLabelFunction(item:Object):String { var str:String; if (item == null) { str = myComboBox.value; } else { str = item.lastName + ", " + item.firstName; } return str; }
ComboBox | () | Construtor |
public function ComboBox()
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 ComboBox.
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 | () | 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.
|
Elementos da API relacionados
close | () | método |
public function close():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 |
Fecha a lista suspensa.
Observação: chamar esse método envia o evento close
. Se o componente ComboBox já estiver fechado, chamar esse método não tem efeitos.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
open()
e close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
getItemAt | () | método |
public function getItemAt(index:uint):Object
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.
|
Object — O objeto no local de índice especificado.
|
Exemplo ( Como usar este exemplo )
getItemAt()
para copiar itens de ComboBox para um componente DataGrid:
import fl.controls.ComboBox; import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1", price:0.34}); myComboBox.addItem({label:"Item 2", price:13.19}); myComboBox.addItem({label:"item 3", price:2.96}); myComboBox.addItem({label:"Item 4", price:3.49}); myComboBox.addItem({label:"Item 5", price:1.27}); myComboBox.move(10, 10); addChild(myComboBox); var indexCol:DataGridColumn = new DataGridColumn("index"); indexCol.headerText = ""; indexCol.sortOptions = Array.NUMERIC; var labelCol:DataGridColumn = new DataGridColumn("label"); labelCol.sortOptions = Array.CASEINSENSITIVE; var priceCol:DataGridColumn = new DataGridColumn("price"); priceCol.sortOptions = Array.NUMERIC; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(indexCol); myDataGrid.addColumn(labelCol); myDataGrid.addColumn(priceCol); myDataGrid.move(10, 40); myDataGrid.rowCount = myComboBox.length; myDataGrid.width = 180; addChild(myDataGrid); var i:uint; var item:Object; for (i = 0; i < myComboBox.length; i++) { item = myComboBox.getItemAt(i); myDataGrid.addItem({index:i, label:item.label, price:item.price}); }
getStyleDefinition | () | método |
public static function getStyleDefinition():Object
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());
Object — Objeto de estilos padrão.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | método |
public function itemToLabel(item:Object):String
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.
|
String — A string a ser exibida com base nos dados.
|
Elementos da API relacionados
open | () | método |
public function open():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 |
Abre a lista suspensa.
Observação: chamar esse método envia o evento open
. Se o componente ComboBox já estiver aberto, chamar esse método não tem efeitos.
Elementos da API relacionados
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.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
removeAll()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextInput; var greenTF:TextFormat; var redTF:TextFormat; var myTextInput:TextInput; var addButton:Button; var myComboBox:ComboBox; var removeButton:Button; greenTF = new TextFormat(); greenTF.color = 0x006600; redTF = new TextFormat(); redTF.color = 0xFF0000; myTextInput = new TextInput(); myTextInput.maxChars = 20; myTextInput.restrict = "a-zA-Z"; myTextInput.move(10, 10); addChild(myTextInput); addButton = new Button(); addButton.label = "(+) Add"; addButton.setStyle("textFormat", greenTF); addButton.move(120, 10); addButton.addEventListener(MouseEvent.CLICK, addClickHandler); addChild(addButton); myComboBox = new ComboBox(); myComboBox.move(10, 40); addChild(myComboBox); removeButton = new Button(); removeButton.label = "(-) Remove All"; removeButton.setStyle("textFormat", redTF); removeButton.move(120, 40); removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler); addChild(removeButton); function addClickHandler(event:MouseEvent):void { if (myTextInput.length > 0) { trace("adding item..."); myComboBox.addItem({label:myTextInput.text}); myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE); myTextInput.text = ""; } } function removeClickHandler(event:MouseEvent):void { trace("removing all items..."); myComboBox.removeAll(); }
removeItem | () | método |
public function removeItem(item:Object):Object
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.
|
Object — O item que foi removido.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.List; import fl.events.ListEvent; var myList:List = new List(); myList.addItem( { label: "Carrot" } ); myList.addItem( { label: "Turnip" } ); myList.addItem( { label: "Tomato" } ); myList.addItem( { label: "Blueberry" } ); myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem); addChild(myList); function removeSelectedItem(e:ListEvent):void { myList.removeItem(e.item); }
removeItemAt | () | método |
public function removeItemAt(index:uint):void
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 locais de índice de itens com índices maiores do que o avanço de índice especificado na matriz por 1.
Esse é um método do componente List que está disponível em uma ocorrência do componente ComboBox.
Parâmetros
index:uint — Índice do item a ser removido.
|
Lança
RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.
|
Elementos da API relacionados
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.
|
Object — O item que foi substituído.
|
Exemplo ( Como usar este exemplo )
replaceItemAt()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextArea; import fl.controls.TextInput; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user..."; myComboBox.addItem({label:"Person 1"}); myComboBox.addItem({label:"Person 2"}); myComboBox.addItem({label:"Person 3"}); myComboBox.addItem({label:"Person 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "a-zA-Z0-9"; myTextInput.maxChars = 12; myTextInput.move(10, 40); addChild(myTextInput) var myButton:Button = new Button(); myButton.label = "Replace item"; myButton.addEventListener(MouseEvent.CLICK, clickHandler); myButton.move(120, 40); addChild(myButton); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(10, 70); addChild(myTextArea); function changeHandler(event:Event):void { myTextInput.text = myComboBox.selectedLabel; } function clickHandler(event:MouseEvent):void { var cIndex:int = myComboBox.selectedIndex; if (cIndex > -1) { var newItem:Object = {label:myTextInput.text}; var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex); myComboBox.selectedIndex = cIndex; myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; } }
sortItems | () | método |
public function sortItems(... sortArgs):*
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.
|
* — 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
Exemplo ( Como usar este exemplo )
upperCaseSort()
, que compara duas propriedades label
dos itens e retorna um valor booliano, dependendo da ordem na qual o item deve aparecer.
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); cb.addItem( { label: "Mercury" } ); cb.addItem( { label: "Venus" } ); cb.addItem( { label: "Earth" } ); cb.addItem( { label: "planet" } ); cb.sortItems(upperCaseSort); addChild(cb); function upperCaseSort(a:Object, b:Object):Boolean { return a.label.toUpperCase() > b.label.toUpperCase(); }
sortItemsOn | () | método |
public function sortItemsOn(field:String, options:Object = null):*
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.
|
* — 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
Exemplo ( Como usar este exemplo )
cb
, que contém quatro elementos rotulados como "Maçãs"
, "Bananas"
, "cerejas"
e "Uvas"
:
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); addChild(cb); // First, populate the ComboBox with the elements. cb.addItem( { label: "Bananas" } ); cb.addItem( { label: "Apples" } ); cb.addItem( { label: "cherries" } ); cb.addItem( { label: "Grapes" } ); // The following statement sorts using the order parameter set to "ASC", // and results in a sort that places "cherries" at the bottom of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "ASC"); // resulting order: Apples, Bananas, Grapes, cherries // The following statement sorts using the order parameter set to "DESC", // and results in a sort that places "cherries" at the top of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "DESC"); // resulting order: cherries, Grapes, Bananas, Apples // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE. Note that an ascending sort is the default setting. cb.sortItemsOn("label", Array.CASEINSENSITIVE); // resulting order: Apples, Bananas, cherries, Grapes // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE | Array.DESCENDING. cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING); // resulting order: Grapes, cherries, Bananas, Apples
sortItemsOn()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE); myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
change | Evento |
flash.events.Event
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 o usuário altera a seleção do componente ComboBox ou, se o componente ComboBox for editável, sempre que o usuário fizer um pressionamento de tecla no campo de texto.
Observação: Enquanto a tabela abaixo especifica que o evento change
surge em bolha, isto não acontece para o controle fl.controls.ComboBox.
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. |
close | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.CLOSE
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 a lista suspensa é dispensada por algum motivo.
A constanteEvent.CLOSE
define o valor da propriedade type
de um objeto de evento close
.
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 Event com um ouvinte de evento. |
target | O objeto cuja conexão foi fechada. |
Exemplo ( Como usar este exemplo )
open()
e close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
Elementos da API relacionados
enter | Evento |
fl.events.ComponentEvent
propriedade ComponentEvent.type =
fl.events.ComponentEvent.ENTER
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 se a propriedade editable
for definida como true
e o usuário pressionar a tecla Enter enquanto digita em campo de texto editável.
type
de um objeto de evento enter
.
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. |
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 |
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 |
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. |
Exemplo ( Como usar este exemplo )
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ListEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler) myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(120, 10); addChild(myTextArea); function openHandler(event:Event):void { logEvent("ComboBox open"); } function closeHandler(event:Event):void { logEvent("ComboBox close"); } function itemRollOverHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function itemRollOutHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function rollOverHandler(event:MouseEvent):void { logEvent("ComboBox rollOver"); myComboBox.open(); } function rollOutHandler(event:MouseEvent):void { logEvent("ComboBox rollOut"); myComboBox.close(); } function dropdownRollOverHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOver"); // reopen ComboBox after it gets closed by the ComboBox rollOut event myComboBox.open(); } function dropdownRollOutHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOut"); myComboBox.close(); } function logEvent(text:String):void { myTextArea.appendText(text + "\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; }
Elementos da API relacionados
open | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.OPEN
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 no botão suspenso para exibir a lista suspensa. Despachado também quando o usuário clica no campo de texto, se o componente ComboBox não for editável.
A constanteEvent.OPEN
define o valor da propriedade type
de um objeto de evento open.
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 Event com um ouvinte de evento. |
target | O objeto de rede que abriu uma conexão. |
Exemplo ( Como usar este exemplo )
open()
. O menu suspenso fecha depois de 1 segundo, a menos que o usuário posicione o mouse sobre ComboBox ou seu menu suspenso:
import fl.controls.Button; import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); addChild(myComboBox); var myButton:Button = new Button(); myButton.emphasized = true; myButton.label = "open ComboBox"; myButton.move(120, 10); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var closeTimer:Timer = new Timer(1000, 1); closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler); function clickHandler(event:MouseEvent):void { myComboBox.open(); closeTimer.reset(); closeTimer.start(); } function timerCompleteHandler(event:TimerEvent):void { myComboBox.close(); } function rollOverHandler(event:MouseEvent):void { closeTimer.stop(); } function rollOutHandler(event:MouseEvent):void { myComboBox.close(); }
Elementos da API relacionados
scroll | 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 pela lista suspensa do componente ComboBox.
Define o valor da propriedadetype
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. |
- Arraste um ComboBox para o palco e nomeie-o
cb
. - Salve esse código como ComboBoxExample.as no mesmo diretório de FLA.
- Defina DocumentClass em FLA como ComboBoxExample.
package { import flash.display.Sprite import flash.text.TextField; import flash.events.Event; import fl.controls.ComboBox; public class ComboBoxExample extends Sprite { private var tf:TextField; public function ComboBoxExample() { setupComboBox(); setupTextField(); } private function setupTextField():void { tf = new TextField(); tf.x = 180; tf.y = 15; tf.autoSize = "left"; addChild(tf); } private function setupComboBox():void { cb.setSize(150,22); cb.addItem( { label: "MasterCard", data:1 } ); cb.addItem( { label: "Visa", data:2 } ); cb.addItem( { label: "American Express", data:3 } ); cb.addEventListener(Event.CHANGE, cardSelected); } private function cardSelected(e:Event):void { tf.text = "You have selected: " tf.appendText(cb.selectedItem.label); } } }
Wed Jun 13 2018, 11:10 AM Z