Pacote | fl.controls |
Classe | public class DataGrid |
Herança | DataGrid SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementações | IFocusManagerComponent |
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Um componente DataGrid é bem ajustado para a exibição de objetos que contêm várias propriedades. Os dados exibidos pelo componente DataGrid podem estar contidos em um objeto DataProvider, ou como uma matriz de objetos. As colunas de um componente DataGrid podem ser representadas por uma lista de objetos DataGridColumn, cada um contendo informações específicas à coluna.
O componente DataGrid fornece os seguintes recursos:
- Colunas de larguras diferentes ou de larguras fixas idênticas
- Colunas que o usuário pode redimensionar em tempo de execução
- Colunas que o usuário pode reordenar em tempo de execução usando o ActionScript
- Cabeçalhos de coluna opcionais personalizáveis
- Suporte para personalizar renderizadores de itens para exibir dados diferentes de texto em cada coluna
- Suporte para classificar dados clicando na coluna que os contém
O componente DataGrid é composto de subcomponentes, incluindo componentes ScrollBar, HeaderRenderer, CellRenderer, DataGridCellEditor e ColumnDivider, que podem ser encapados durante a criação ou em tempo de execução.
O componente DataGrid usa as seguintes classes, que podem ser encontradas no pacote dataGridClasses:
- DataGridColumn: descreve uma coluna em um componente DataGrid. Contém os índices, as larguras e outras propriedades da coluna. Não contém dados de célula.
- HeaderRenderer: exibe o cabeçalho da coluna para a coluna DataGrid. Contém o rótulo e outras propriedades do cabeçalho de coluna.
- DataGridCellEditor: gerencia a edição de dados para cada célula.
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 | ||
allowMultipleSelection : Boolean
Obtém um valor booliano que indica se mais de um item de lista pode ser selecionado por vez. | SelectableList | ||
alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | ||
blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | DisplayObject | ||
blendShader : Shader [somente gravação]
Define um shader usado para mesclar o primeiro plano e o segundo plano. | DisplayObject | ||
buttonMode : Boolean
Especifica o modo de botão desta entidade gráfica. | Sprite | ||
cacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro. | DisplayObject | ||
columns : Array
Obtém ou define uma matriz de objetos DataGridColumn, um para cada coluna que pode ser exibida. | DataGrid | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | ||
dataProvider : DataProvider
Obtém ou define o modelo de dados da lista de itens a serem visualizados. | SelectableList | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [somente leitura]
Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta. | Sprite | ||
editable : Boolean = false
Indica se o usuário pode ou não editar itens no provedor de dados. | DataGrid | ||
editedItemPosition : Object
Obtém ou define o índice de colunas e linhas do renderizador de item para o item do provedor de dados que está sendo editado. | DataGrid | ||
editedItemRenderer : ICellRenderer [somente leitura]
Obtém uma referência ao renderizador de item no componente DataGrid cujo item está sendo atualmente editado. | DataGrid | ||
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 | ||
headerHeight : Number
Obtém ou define a altura do cabeçalho DataGrid, em pixels. | DataGrid | ||
height : Number [substituir]
Obtém ou define a altura do componente, em pixels. | UIComponent | ||
hitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. | Sprite | ||
horizontalLineScrollSize : Number
Obtém ou define um valor que descreve a quantidade de conteúdo a ser rolada, horizontalmente, quando uma seta de rolagem for clicada. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Obtém ou define a contagem de pixels de acordo com a qual mover a miniatura de rolagem na barra de rolagem horizontal quando o controle da barra de rolagem for pressionado. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [somente leitura]
Obtém uma referência à barra de rolagem horizontal. | BaseScrollPane | ||
horizontalScrollPolicy : String [substituir]
Obtém ou define um valor booliano que indica se a barra de rolagem horizontal está sempre ativa. | DataGrid | ||
horizontalScrollPosition : Number
Obtém ou define um valor que descreve a posição horizontal da barra de rolagem horizontal no painel de rolagem, em pixels. | BaseScrollPane | ||
imeMode : String
Obtém ou define o modo do editor de métodos de entrada (IME). | DataGrid | ||
itemEditorInstance : Object
Uma referência à ocorrência atualmente ativa do editor de item, se houver. | DataGrid | ||
labelFunction : Function
Obtém ou define uma função que determina os campos de cada item a serem usados para o texto do rótulo. | DataGrid | ||
length : uint [somente leitura]
Obtém o número de itens no provedor de dados. | SelectableList | ||
loaderInfo : LoaderInfo [somente leitura]
Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. | DisplayObject | ||
mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | DisplayObject | ||
maxHorizontalScrollPosition : Number [substituir]
Obtém ou define o número de pixels que a lista rola para a direita quando a propriedade horizontalScrollPolicy é definida como ScrollPolicy.ON. | SelectableList | ||
maxVerticalScrollPosition : Number [somente leitura]
Obtém a posição de rolagem vertical máxima para o conteúdo atual, em pixels. | BaseScrollPane | ||
metaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4. | DisplayObject | ||
minColumnWidth : Number
Obtém ou define a largura máxima da coluna DataGrid, em pixels. | DataGrid | ||
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 | ||
resizableColumns : Boolean = true
Indica se o usuário pode alterar o tamanho das colunas. | DataGrid | ||
root : DisplayObject [somente leitura]
Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF. | DisplayObject | ||
rotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. | DisplayObject | ||
rotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rowCount : uint [substituir]
Obtém ou define o número de linhas que são pelo menos parcialmente visíveis na lista. | DataGrid | ||
rowHeight : Number
Obtém ou define a altura de cada linha no componente DataGrid, em pixels. | DataGrid | ||
scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | DisplayObject | ||
scaleX : Number [substituir]
Multiplica a largura atual do componente por um fator escalar. | UIComponent | ||
scaleY : Number [substituir]
Multiplica a altura atual do componente por um fator escalar. | UIComponent | ||
scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | ||
selectable : Boolean
Obtém ou define um valor booliano que indica se os itens na lista podem ser selecionados. | SelectableList | ||
selectedIndex : int
Obtém ou define o índice do item selecionado em uma lista de seleção única. | SelectableList | ||
selectedIndices : Array
Obtém ou define uma matriz que contém os itens que foram selecionados a partir de uma lista de seleção múltipla. | SelectableList | ||
selectedItem : Object
Obtém ou define o item que foi selecionado a partir de uma lista de seleção única. | SelectableList | ||
selectedItems : Array
Obtém ou define uma matriz que contém os objetos para os itens que foram selecionados a partir da lista de seleção múltipla. | SelectableList | ||
showHeaders : Boolean
Obtém ou define um valor booliano que indica se o componente DataGrid mostra cabeçalhos de coluna. | DataGrid | ||
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 | ||
sortableColumns : Boolean = true
Indica se o usuário pode classificar os itens no provedor de dados clicando em uma célula de cabeçalho de coluna. | DataGrid | ||
sortDescending : Boolean [somente leitura]
Obtém a ordem na qual uma coluna é classificada quando o usuário clica em seu cabeçalho. | DataGrid | ||
sortIndex : int [somente leitura]
Obtém o índice da coluna a ser classificada. | DataGrid | ||
soundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica. | Sprite | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | ||
tabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação. | DisplayObjectContainer | ||
tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | InteractiveObject | ||
tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição. | DisplayObject | ||
useBitmapScrolling : Boolean
Quando definida como verdadeira, a propriedade cacheAsBitmap para o conteúdo de rolagem é definida como verdadeira; quando definida como falsa, esse valor é desativado. | BaseScrollPane | ||
useHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true". | Sprite | ||
verticalLineScrollSize : Number
Obtém ou define um valor que descreve quantos pixels devem ser rolados verticalmente quando uma seta de rolagem for clicada. | BaseScrollPane | ||
verticalPageScrollSize : Number
Obtém ou define a contagem de pixels de acordo com a qual mover a miniatura de rolagem na barra de rolagem vertical quando o controle da barra de rolagem for pressionado. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [somente leitura]
Obtém uma referência à barra de rolagem vertical. | BaseScrollPane | ||
verticalScrollPolicy : String
Obtém ou define um valor que indica o estado da barra de rolagem vertical. | BaseScrollPane | ||
verticalScrollPosition : Number
Obtém ou define um valor que descreve a posição vertical da barra de rolagem vertical no painel de rolagem, em pixels. | BaseScrollPane | ||
visible : Boolean [substituir]
Obtém ou define um valor que indica se a ocorrência do componente atual é visível. | UIComponent | ||
width : Number [substituir]
Obtém ou define a largura do componente, em pixels. | UIComponent | ||
x : Number [substituir]
Obtém ou define a coordenada x que representa a posição do componente ao longo do eixo x em seu contêiner-pai. | UIComponent | ||
y : Number [substituir]
Obtém ou define a coordenada y que representa a posição do componente ao longo do eixo y em seu contêiner-pai. | UIComponent | ||
z : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai. | DisplayObject |
Método | Definido por | ||
---|---|---|---|
DataGrid()
Cria uma nova ocorrência do componente DataGrid. | DataGrid | ||
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 | ||
Adiciona uma coluna ao final da matriz de colunas. | DataGrid | ||
Insere uma coluna no índice especificado da matriz de colunas. | DataGrid | ||
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. | SelectableList | ||
Insere um item na lista, na localização de índice especificada. | SelectableList | ||
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 | ||
Apaga um estilo definido nos renderizadores da lista. | SelectableList | ||
Apaga o item atualmente selecionado na lista e define a propriedade selectedIndex como -1. | SelectableList | ||
Exclui uma propriedade de estilo desta ocorrência do componente. | UIComponent | ||
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | ||
Usa o editor especificado pela propriedade itemEditor para criar um editor de item para o renderizador de item no índice de colunas e linhas, identificado pela propriedade editedItemPosition. | DataGrid | ||
Fecha um editor de item atualmente aberto em um renderizador de item. | DataGrid | ||
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 | ||
Edita um determinado campo ou propriedade no componente DataGrid. | DataGrid | ||
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | ||
Obtém a ocorrência de um renderizador de célula na posição especificada em DataGrid. | DataGrid | ||
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 a coluna localizada no índice especificado da matriz de colunas. | DataGrid | ||
Recupera o número de colunas no componente DataGrid. | DataGrid | ||
Recupera o índice da coluna do nome especificado ou -1, se nenhuma correspondência for encontrada. | DataGrid | ||
Recupera o objeto que possui foco no momento. | UIComponent | ||
Recupera o item no índice especificado. | SelectableList | ||
Retorna o índice do próximo item em dataProvider, no qual o primeiro caractere do rótulo corresponde a um caractere de string especificado. | SelectableList | ||
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 um estilo definido nos renderizadores da lista. | SelectableList | ||
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. | DataGrid | ||
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 | ||
Invalida um renderizador de item específico. | SelectableList | ||
Invalida o renderizador do item no índice especificado. | SelectableList | ||
Invalida a lista inteira, forçando o redesenho dos itens da lista. | SelectableList | ||
Verifica se o item especificado está selecionado na lista. | SelectableList | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
[substituir]
O componente DataGrid tem várias células para qualquer item especificado e, portanto, o método itemToCellRenderer sempre retorna nulo. | DataGrid | ||
Recupera a string exibida pelo renderizador para o objeto de dados especificado com base nas propriedades de rótulo do objeto. | SelectableList | ||
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 | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove todos os itens da lista. | SelectableList | ||
Remove todas as colunas do componente DataGrid. | DataGrid | ||
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 a coluna localizada no índice especificado da matriz de colunas. | DataGrid | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Remove o item especificado da lista. | SelectableList | ||
Remove o item na posição de índice especificada. | SelectableList | ||
Substitui o item na localização de índice especificada por outro item. | SelectableList | ||
Ativa um teclado virtual. | InteractiveObject | ||
[substituir]
Rola a lista até o item no índice especificado. | DataGrid | ||
Rola a lista até o item na localização indicada pelo valor atual da propriedade selectedIndex. | SelectableList | ||
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 um estilo nos renderizadores da lista. | SelectableList | ||
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. | SelectableList | ||
Classifica os elementos do provedor de dados atual de acordo com um ou mais de seus campos. | SelectableList | ||
Redefine as larguras das colunas visíveis para o mesmo tamanho. | DataGrid | ||
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 um item diferente é selecionado na lista. | SelectableList | |||
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 depois que um usuário expande uma coluna horizontalmente. | DataGrid | |||
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 | |||
[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 o usuário clica em uma célula de cabeçalho. | DataGrid | |||
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 | |||
Despachado quando o usuário clica em um item no componente. | SelectableList | |||
Despachado quando o usuário clica em um item no componente duas vezes em rápida sucessão. | SelectableList | |||
Despachado depois que a propriedade editedItemPosition é definida e o item pode ser editado. | DataGrid | |||
Despachado depois que um usuário se prepara para editar um item, por exemplo, soltando o botão do mouse sobre o item. | DataGrid | |||
Despachado quando uma sessão de edição de item é finalizada por qualquer motivo. | DataGrid | |||
Despachado depois que um item recebe o foco. | DataGrid | |||
Despachado depois que um item perde o foco. | DataGrid | |||
Despachado quando o usuário rola o ponteiro para fora de um item no componente. | SelectableList | |||
Despachado quando o usuário rola o ponteiro sobre um item no componente. | SelectableList | |||
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 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 rola o ponteiro para fora do componente. | SelectableList | |||
Despachado quando o usuário rola o ponteiro sobre o componente. | SelectableList | |||
Despachado quando o usuário rola horizontal ou verticalmente. | SelectableList | |||
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 | ||
---|---|---|---|---|
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A classe que fornece o renderizador de célula para cada item no componente. | SelectableList | |||
columnDividerSkin | 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 divisor exibido entre as colunas. O valor padrão é DataGrid_columnDividerSkin . | DataGrid | ||
columnStretchCursorSkin | 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 cursor usado quando o mouse está entre os dois cabeçalhos de coluna e quando a propriedade resizableColumns está definida como verdadeira .
O valor padrão é DataGrid_columnStretchCursorSkin . | DataGrid | ||
Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento separa a borda da lista de seu conteúdo, em pixels. | SelectableList | |||
Tipo: Number Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O valor de alfa para definir a lista quando a propriedade enabled for false . | SelectableList | |||
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 | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando ele está desativado. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando você clica no botão de seta. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta para baixo da barra de rolagem. | BaseScrollPane | |||
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 | |||
headerDisabledSkin | 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 cada cabeçalho de coluna, quando o componente está desativado. O valor padrão é HeaderRenderer_disabledSkin . | DataGrid | ||
headerDisabledTextFormat | 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 formato a ser aplicado ao texto contido em cada cabeçalho de coluna, quando o componente é desativado. O valor padrão é null . | DataGrid | ||
headerDownSkin | 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 cada cabeçalho de coluna, quando o mouse está desativado. O valor padrão é HeaderRenderer_downSkin . | DataGrid | ||
headerOverSkin | 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 cada cabeçalho de coluna, quando o mouse está sobre o cabeçalho. O valor padrão é HeaderRenderer_overSkin . | DataGrid | ||
headerRenderer | 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 cada cabeçalho de coluna. O valor padrão é fl.controls.dataGridClasses.HeaderRenderer . | DataGrid | ||
headerSortArrowAscSkin | 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 a seta de classificação, quando a coluna classificada está na ordem crescente. O valor padrão é HeaderSortArrow_ascIcon . | DataGrid | ||
headerSortArrowDescSkin | 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 a seta de classificação, quando a coluna classificada está na ordem decrescente. O valor padrão é HeaderSortArrow_descIcon . | DataGrid | ||
headerTextFormat | 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 formato a ser aplicado ao texto contido em cada cabeçalho de coluna. O valor padrão é null . | DataGrid | ||
headerTextPadding | 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 a borda do cabeçalho da coluna do texto do cabeçalho da coluna, em pixels. O valor padrão é 5 . | DataGrid | ||
headerUpSkin | 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 cada cabeçalho de coluna. O valor padrão é HeaderRenderer_upSkin . | DataGrid | ||
Tipo: Number Formato: Time Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O número de milissegundos a aguardar depois que o evento buttonDown é despachado pela primeira vez, antes do envio de um segundo evento buttonDown . | BaseScrollPane | |||
Tipo: Number Formato: Time Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O intervalo, em milissegundos, entre os eventos buttonDown despachados depois do atraso especificado pelo estilo repeatDelay . | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A classe que fornece a capa para o plano de fundo do componente. | SelectableList | |||
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 | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado desativado da miniatura. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando você clica na miniatura. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como ícone para a miniatura da barra de rolagem. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para a miniatura da barra de rolagem, quando o ponteiro do mouse está sobre a miniatura. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa usada para a miniatura da barra de rolagem. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar uma faixa desativada. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado para baixo de uma capa desativada. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado do mouse sobre para a faixa de rolagem. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa usada para indicar o estado do mouse para cima para a faixa de rolagem. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando ele está desativado. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando você clica no botão de seta. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem, quando o ponteiro do mouse está sobre o botão de seta. | BaseScrollPane | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como capa para o botão de seta acima da barra de rolagem. | BaseScrollPane |
columns | propriedade |
columns:Array
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define uma matriz de objetos DataGridColumn, um para cada coluna que pode ser exibida. Se não estiver explicitamente definido, o componente DataGrid examina o primeiro item no provedor de dados, localiza suas propriedades e, em seguida, exibe essas propriedades em ordem alfabética.
É possível fazer alterações nas colunas e em sua ordem nessa matriz DataGridColumn. Depois de fazer as alterações, é necessário atribuir explicitamente a matriz alterada à propriedade colunas
. Se não for feita uma atribuição explícita, o conjunto de colunas usado anteriormente continuará a ser utilizado.
O valor padrão é [].
Implementação
public function get columns():Array
public function set columns(value:Array):void
Exemplo ( Como usar este exemplo )
colunas
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); function getRandomNumber():uint { return Math.round(Math.random() * 100); }
colunas
e o método getColumnCount()
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); trace("columns.length:", dg.columns.length); // 3 trace("getColumnCount():", dg.getColumnCount()); // 3 function getRandomNumber():uint { return Math.round(Math.random() * 100); }
editable | propriedade |
public var editable:Boolean = false
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 |
Indica se o usuário pode ou não editar itens no provedor de dados. Um valor de true
indica que o usuário pode editar itens no provedor de dados; um valor de false
indica que o usuário não pode fazer isso.
Se esse valor for true
, os renderizadores de itens no componente são editáveis. O usuário pode clicar em um renderizador de itens para abrir um editor.
É possível desativar a edição para colunas individuais do componente DataGrid usando a propriedade DataGridColumn.editable
ou tratando os eventos itemEditBeginning
e itemEditBegin
.
O valor padrão é false.
Elementos da API relacionados
editedItemPosition | propriedade |
editedItemPosition: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 índice de colunas e linhas do renderizador de item para o item do provedor de dados que está sendo editado. Se nenhum item estiver sendo editado, essa propriedade é null
.
Esse objeto tem dois campos:
columnIndex
: o índice de coluna com base em zero do item atualrowIndex
: o índice de linha com base em zero do item atual
Por exemplo: { columnIndex:2, rowIndex:3 }
A definição dessa propriedade rola o item para a exibição e envia o evento itemEditBegin
para abrir um editor de item no renderizador de item especificado.
O valor padrão é null.
Implementação
public function get editedItemPosition():Object
public function set editedItemPosition(value:Object):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.data.DataProvider; import fl.controls.*; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.columns = [ "col1", "col2", "col3" ]; dg.editable = true; dg.dataProvider = dp; dg.move(200,10); dg.setSize(200,300); addChild(dg); var rowIntro:Label = new Label(); rowIntro.text = "Row to edit:"; rowIntro.move(10,10); var colIntro:Label = new Label(); colIntro.text = "Column to edit:"; colIntro.move(10,30); var rowInputField:TextInput = new TextInput(); rowInputField.move(100,10); rowInputField.setSize(30,20); var colInputField:TextInput = new TextInput(); colInputField.move(100,30); colInputField.setSize(30,20); var editButton:Button = new Button(); editButton.move(10,60); editButton.label = "Edit"; editButton.addEventListener(MouseEvent.CLICK,editGrid); addChild(rowIntro); addChild(colIntro); addChild(rowInputField); addChild(colInputField); addChild(editButton); function editGrid(e:MouseEvent):void { dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) }; }
editedItemRenderer | propriedade |
editedItemRenderer:ICellRenderer
[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 renderizador de item no componente DataGrid cujo item está sendo atualmente editado. Se nenhum item estiver sendo editado, essa propriedade contém um valor de null
.
É possível obter o valor atual do item que está sendo editado usando-se a propriedade editedItemRenderer.data
de um ouvinte de evento para o evento itemEditBegin
ou itemEditEnd
.
Essa a uma propriedade somente leitura. Para definir um editor de item personalizado, use a propriedade itemEditor
da classe que representa a coluna relevante.
Implementação
public function get editedItemRenderer():ICellRenderer
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.data.DataProvider; import fl.controls.*; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.columns = [ "col1", "col2", "col3" ]; dg.editable = true; dg.dataProvider = dp; dg.move(200,10); dg.setSize(200,300); addChild(dg); var rowIntro:Label = new Label(); rowIntro.text = "Row to edit:"; rowIntro.move(10,10); var colIntro:Label = new Label(); colIntro.text = "Column to edit:"; colIntro.move(10,30); var rowInputField:TextInput = new TextInput(); rowInputField.move(100,10); rowInputField.setSize(30,20); var colInputField:TextInput = new TextInput(); colInputField.move(100,30); colInputField.setSize(30,20); var editButton:Button = new Button(); editButton.move(10,60); editButton.label = "Edit"; editButton.addEventListener(MouseEvent.CLICK,editGrid); addChild(rowIntro); addChild(colIntro); addChild(rowInputField); addChild(colInputField); addChild(editButton); function editGrid(e:MouseEvent):void { dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) }; }
headerHeight | propriedade |
headerHeight:Number
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define a altura do cabeçalho DataGrid, em pixels.
O valor padrão é 25.
Implementação
public function get headerHeight():Number
public function set headerHeight(value:Number):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
headerHeight
de uma ocorrência do componentes DataGrid:
import fl.controls.DataGrid; import fl.controls.Slider; import fl.events.SliderEvent; var headerHeightSlider:Slider = new Slider(); headerHeightSlider.minimum = 20; headerHeightSlider.maximum = 40; headerHeightSlider.snapInterval = 2; headerHeightSlider.tickInterval = 4; headerHeightSlider.liveDragging = true; headerHeightSlider.move(10, 10); headerHeightSlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(headerHeightSlider); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.headerHeight = headerHeightSlider.value; myDataGrid.addColumn("name"); myDataGrid.addColumn("value"); myDataGrid.addItem({name:"Person A", value:0.85}); myDataGrid.addItem({name:"Person B", value:0.87}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 30); addChild(myDataGrid); function changeHandler(event:SliderEvent):void { myDataGrid.headerHeight = event.value; myDataGrid.rowCount = myDataGrid.length; }
horizontalScrollPolicy | propriedade |
horizontalScrollPolicy:String
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor booliano que indica se a barra de rolagem horizontal está sempre ativa. A lista a seguir descreve os valores válidos:
ScrollPolicy.ON
: a barra de rolagem está sempre ativada.ScrollPolicy.OFF
: a barra de rolagem está sempre desativada.ScrollPolicy.AUTO
: o estado da barra de rolagem é alterado com base nos parâmetros que são passados ao métodosetScrollBarProperties()
.
Observação: se a largura combinada das colunas visíveis no componente DataGrid for menor do que a largura disponível do componente DataGrid, as colunas podem não expandir para preencher o espaço disponível do componente DataGrid, dependendo do valor da propriedade horizontalScrollPolicy
. A lista a seguir descreve esses valores e seus efeitos:
ScrollPolicy.ON
: a barra de rolagem horizontal fica desativada. As colunas não expandem para preencher o espaço disponível do componente DataGrid.ScrollPolicy.AUTO
: a barra de rolagem horizontal não fica visível. As colunas não expandem para preencher o espaço disponível do componente DataGrid.
O valor padrão é ScrollPolicy.OFF.
Implementação
override public function get horizontalScrollPolicy():String
override public function set horizontalScrollPolicy(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber(), col5:getRandomNumber(), col6:getRandomNumber(), col7:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200,300); dg.addColumn("col1"); dg.addColumn("col2"); dg.addColumn("col3"); dg.addColumn("col4"); dg.addColumn("col5"); dg.addColumn("col6"); dg.addColumn("col7"); dg.dataProvider = dp; dg.horizontalScrollPolicy = ScrollPolicy.ON; addChild(dg); function getRandomNumber():uint { return Math.round(Math.random() * 100); }
imeMode | propriedade |
imeMode: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 modo do editor de métodos de entrada (IME). IME torna possível o uso de um teclado QWERTY pelos usuários, para inserir caracteres do conjunto de caracteres chineses, japoneses e coreanos.
O Flash define o IME como o modo especificado quando o componente obtém o foco e o restaura para o valor original, depois que o componente perde o foco.
A classe flash.system.IMEConversionMode define constantes para os valores válidos para essa propriedade. Defina essa propriedade como null
para impedir o uso do IME com o componente.
Implementação
public function get imeMode():String
public function set imeMode(value:String):void
Elementos da API relacionados
itemEditorInstance | propriedade |
public var itemEditorInstance: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 |
Uma referência à ocorrência atualmente ativa do editor de item, se houver.
Para acessar a ocorrência do editor de item e o novo valor de item, quando um item está sendo editado, use a propriedade itemEditorInstance
. A propriedade itemEditorInstance
não é válida até depois que o ouvinte de eventos para o evento itemEditBegin
seja executado. Por essa razão, a propriedade itemEditorInstance
é normalmente acessada em um ouvinte de eventos para o evento itemEditEnd
.
A propriedade DataGridColumn.itemEditor
define a classe do editor de item e, portanto, o tipo de dados da ocorrência do editor de item.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
itemEditorInstance
de uma grade de dados para determinar o texto de uma célula, após a sua edição:
import fl.data.DataProvider; import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridCellEditor; import fl.controls.listClasses.ListData; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.addEventListener(DataGridEvent.ITEM_EDIT_END,onItemEditEnd); dg.dataProvider = dp; dg.editable = true; dg.setSize(300,200); addChild(dg); function onItemEditEnd(e:DataGridEvent):void { var cellEditor:DataGridCellEditor = dg.itemEditorInstance as DataGridCellEditor; var listData:ListData = cellEditor.listData; trace("After Edit: " + cellEditor.text); }
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 uma função que determina os campos de cada item a serem usados para o texto do rótulo.
O valor padrão é null.
Implementação
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var c1:DataGridColumn = new DataGridColumn("col1"); c1.sortOptions = Array.NUMERIC; var c2:DataGridColumn = new DataGridColumn("col2"); c2.sortOptions = Array.NUMERIC; var c3:DataGridColumn = new DataGridColumn("col3"); c3.sortOptions = Array.NUMERIC; var dg:DataGrid = new DataGrid(); dg.addColumn(c1); dg.addColumn(c2); dg.addColumn(c3); dg.dataProvider = dp; dg.labelFunction = currencyFormatter; dg.move(10, 10); dg.setSize(200, 300); addChild(dg); function getRandomNumber():Number { return Math.random() * 100; } function currencyFormatter(data:Object, column:DataGridColumn):String { return "$" + data[column.dataField].toFixed(2); }
minColumnWidth | propriedade |
minColumnWidth: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 coluna DataGrid, em pixels. Se esse valor for definido como NaN
, a largura mínima da coluna pode ser definida individualmente para cada coluna do componente DataGrid.
O valor padrão é NaN.
Implementação
public function get minColumnWidth():Number
public function set minColumnWidth(value:Number):void
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getString(), col2:getString(), col3:getString(), col4:getString(), col5:getString(), col6:getString(), col7:getString()}); } var dg:DataGrid = new DataGrid(); dg.setSize(450,300); dg.addColumn("col1"); dg.addColumn("col2"); dg.addColumn("col3"); dg.addColumn("col4"); dg.addColumn("col5"); dg.addColumn("col6"); dg.addColumn("col7"); dg.dataProvider = dp; dg.horizontalScrollPolicy = ScrollPolicy.ON; dg.minColumnWidth = 185; addChild(dg); function getString():String { return "This string requires a wide column"; }
resizableColumns | propriedade |
public var resizableColumns:Boolean = true
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 |
Indica se o usuário pode alterar o tamanho das colunas. Um valor de true
indica que o usuário pode alterar o tamanho da coluna; um valor de false
indica que o tamanho da coluna é fixo.
Se esse valor for true
, o usuário pode estender ou encolher as colunas do componente DataGrid arrastando as linhas de grade entre as células de cabeçalho. Além disso, se esse valor for true
, o usuário pode alterar o tamanho das colunas, a menos que as propriedades redimensionáveis
das colunas individuais sejam definidas como false
.
O valor padrão é true.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
resizableColumns
e sortableColumns
correspondentes como false
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var nameCol:DataGridColumn = new DataGridColumn("name"); nameCol.headerText = "NAME:"; nameCol.width = 120; var valueCol:DataGridColumn = new DataGridColumn("value"); valueCol.headerText = "VALUE:"; valueCol.width = 80; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name A", value:"Value A"}); myDataGrid.addItem({name:"Name B", value:"Value B"}); myDataGrid.addItem({name:"Name C", value:"Value C"}); myDataGrid.resizableColumns = false; myDataGrid.sortableColumns = false; myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
rowCount | propriedade |
rowCount:uint
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define o número de linhas que são pelo menos parcialmente visíveis na lista.
Implementação
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
rowCount
:
import fl.controls.DataGrid; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.move(10, 10); myDataGrid.setSize(300, 200); addChild(myDataGrid); var fixedHeight:uint = Math.min(myDataGrid.rowCount, myDataGrid.length); myDataGrid.rowCount = fixedHeight; trace(myDataGrid.width, myDataGrid.height); // 300 105
rowHeight | propriedade |
rowHeight:Number
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define a altura de cada linha no componente DataGrid, em pixels.
O valor padrão é 20.
Implementação
public function get rowHeight():Number
public function set rowHeight(value:Number):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.managers.StyleManager; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i = 0; i < totalEntries; i++) { dp.addItem( { col1:Math.random(), col2:Math.random(), col3:Math.random() } ); } var smallText:TextFormat = new TextFormat(); smallText.size = 9; smallText.font = "Verdana"; var dg:DataGrid = new DataGrid(); dg.columns = ["col1", "col2", "col3"]; dg.rowHeight = 14; dg.move(10, 10); dg.setSize(400, 300); dg.dataProvider = dp; dg.setStyle("textFormat", smallText); addChild(dg); StyleManager.setStyle("textFormat", smallText);
showHeaders | propriedade |
showHeaders: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 DataGrid mostra cabeçalhos de coluna. Um valor true
indica que o componente DataGrid mostra cabeçalhos de coluna; um valor false
indica que esse componente não faz isso.
O valor padrão é true.
Implementação
public function get showHeaders():Boolean
public function set showHeaders(value:Boolean):void
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:Math.random(), col2:Math.random()}); } var dg1:DataGrid = new DataGrid(); dg1.move(10,10); dg1.setSize(200,300); dg1.dataProvider = dp; addChild(dg1); var dg2:DataGrid = new DataGrid(); dg2.move(250,10); dg2.setSize(200,300); dg2.dataProvider = dp; dg2.showHeaders = false; addChild(dg2);
sortableColumns | propriedade |
public var sortableColumns:Boolean = true
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 |
Indica se o usuário pode classificar os itens no provedor de dados clicando em uma célula de cabeçalho de coluna. Se esse valor for true
, o usuário pode classificar os itens do provedor de dados clicando em uma célula de cabeçalho de coluna; se esse valor for false
, o usuário não pode fazer isso.
Se esse valor for true
, para impedir uma coluna individual de responder a um clique do mouse do usuário em uma célula de cabeçalho, defina a propriedade classificável
dessa coluna como false
.
O campo de classificação de uma coluna é a propriedade dataField
ou sortCompareFunction
do componente DataGridColumn. Se o usuário clicar em uma coluna mais de uma vez, a operação de classificação alterna entre a ordem crescente e decrescente.
Se essa propriedade e a propriedade classificável
de uma coluna forem definidas como verdadeiras
, o componente DataGrid envia um evento headerRelease
, depois que o usuário libera o botão do mouse da célula de cabeçalho da coluna. Se uma chamada não é feita ao método preventDefault()
de um método de manipulador do evento headerRelease
, o componente DataGrid realiza um classificação com base nos valores da propriedade dataField
ou sortCompareFunction
.
O valor padrão é true.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
sortableColumns
como false
para impedir que a lista seja classificável pelo usuário:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var data:XML = <dataProvider> <data col1="Person A" col2="11.383" /> <data col1="Person B" col2="3.399" /> <data col1="Person C" col2="25.624" /> </dataProvider> var dp:DataProvider = new DataProvider(data); var c1:DataGridColumn = new DataGridColumn("col1"); var c2:DataGridColumn = new DataGridColumn("col2"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(c1); myDataGrid.addColumn(c2); myDataGrid.dataProvider = dp; myDataGrid.move(10, 10); myDataGrid.setSize(160, 120); myDataGrid.sortableColumns = false; addChild(myDataGrid);
sortDescending | propriedade |
sortDescending:Boolean
[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 ordem na qual uma coluna é classificada quando o usuário clica em seu cabeçalho. Um valor true
indica que a coluna é classificada em ordem decrescente; um valor false
indica que a coluna é classificada em ordem crescente.
A propriedade sortDescending
não afeta o modo como o método de classificação conclui a operação de classificação. Por padrão, a operação de classificação envolve uma classificação de strings que diferencia maiúsculas de minúsculas. Para alterar esse comportamento, modifique as propriedades sortOptions
e sortCompareFunction
da classe DataGridColumn.
Observação: se você consultar essa propriedade em um ouvinte de eventos para o evento headerRelease
, o valor da propriedade identifica a ordem de classificação para a operação de classificação anterior. Isso ocorre porque a próxima classificação ainda não ocorreu.
O valor padrão é false.
Implementação
public function get sortDescending():Boolean
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
headerRelease
e rastreia as propriedades sortDescending
, sortIndex
e dataField
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dataXML:XML = <dataProvider> <data col1="Person A" col2="11.383" /> <data col1="Person B" col2="3.399" /> <data col1="Person C" col2="25.624" /> </dataProvider> var dp:DataProvider = new DataProvider(dataXML); var c1:DataGridColumn = new DataGridColumn("col1"); var c2:DataGridColumn = new DataGridColumn("col2"); c2.sortOptions = Array.NUMERIC; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(c1); myDataGrid.addColumn(c2); myDataGrid.dataProvider = dp; myDataGrid.width = 160; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler); addChild(myDataGrid); function headerReleaseHandler(event:DataGridEvent):void { var myDG:DataGrid = event.currentTarget as DataGrid; var whichColumn:DataGridColumn = myDG.getColumnAt(event.columnIndex); trace("sortDescending:", myDG.sortDescending); trace("sortIndex:", myDG.sortIndex); trace("dataField:", whichColumn.dataField); trace(""); }
sortIndex | propriedade |
DataGrid | () | Construtor |
public function DataGrid()
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 DataGrid.
addColumn | () | método |
public function addColumn(column:*):DataGridColumn
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 |
Adiciona uma coluna ao final da matriz de colunas
.
Parâmetros
column:* — Uma string ou um objeto DataGridColumn.
|
DataGridColumn — O objeto DataGridColumn adicionado.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
addColumn()
:
import fl.controls.DataGrid; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("name"); myDataGrid.addColumn("value"); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
addColumn()
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var nameCol:DataGridColumn = new DataGridColumn("name"); var valueCol:DataGridColumn = new DataGridColumn("value"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { stateName:"California", stateAbbreviation:"CA" } ); dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } ); var dg:DataGrid = new DataGrid(); var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation")); var nameColumn:DataGridColumn = dg.addColumn("stateName"); abbreviationColumn.width = 100; nameColumn.width = 200; dg.move(10,10); dg.width = 300; dg.rowCount = 2; dg.dataProvider = dp; addChild(dg);
addColumnAt | () | método |
public function addColumnAt(column:*, index:uint):DataGridColumn
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 uma coluna no índice especificado na matriz de colunas
.
Parâmetros
column:* — A string ou o objeto DataGridColumn que representa a coluna a ser inserida.
| |
index:uint — O índice de matrizes que identifica o local no qual a coluna deve ser inserida.
|
DataGridColumn — O objeto DataGridColumn que foi inserido na matriz de colunas.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { stateName:"California", stateAbbreviation:"CA" } ); dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } ); var dg:DataGrid = new DataGrid(); var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation")); var nameColumn:DataGridColumn = dg.addColumn("stateName"); abbreviationColumn.width = 100; nameColumn.width = 200; dg.move(10,10); dg.width = 300; dg.rowCount = 2; dg.dataProvider = dp; addChild(dg);
createItemEditor | () | método |
public function createItemEditor(colIndex:uint, rowIndex: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 |
Usa o editor especificado na propriedade itemEditor
para criar um editor de item para o renderizador de item no índice de coluna e linha, identificado pela propriedade editedItemPosition
.
Esse método define a ocorrência do editor como a propriedade itemEditorInstance
.
É possível chamar esse método no ouvinte de eventos para o evento itemEditBegin
. Para criar um editor a partir de outro código, defina a propriedade editedItemPosition
para gerar o evento itemEditBegin
.
Parâmetros
colIndex:uint — O índice de colunas do item a ser editado no provedor de dados.
| |
rowIndex:uint — O índice de linhas do item a ser editado no provedor de dados.
|
destroyItemEditor | () | método |
public function destroyItemEditor():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 um editor de item atualmente aberto em um renderizador de item. Esse método é normalmente chamado no ouvinte de eventos para o evento itemEditEnd
, depois que uma chamada é realizada para o método preventDefault()
para impedir que o ouvinte de eventos padrão seja executado.
editField | () | método |
public function editField(index:uint, dataField:String, data: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 |
Edita um determinado campo ou propriedade no componente DataGrid.
Parâmetros
index:uint — O índice do item do provedor de dados a ser editado.
| |
dataField:String — O nome do campo ou da propriedade no item do provedor de dados a ser editado.
| |
data:Object — O novo valor de dados.
|
Lança
RangeError — O índice especificado é menor do que 0 ou maior ou igual ao comprimento do provedor de dados.
|
getCellRendererAt | () | método |
public function getCellRendererAt(row:uint, column:uint):ICellRenderer
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém a ocorrência de um renderizador de célula na posição especificada em DataGrid.
Observação: esse método retorna null
para posições que não são visíveis (ou seja, roladas para fora da exibição).
Parâmetros
row:uint — Um índice de linha.
| |
column:uint — Um índice de coluna.
|
ICellRenderer — O objeto ICellRenderer na posição especificada, ou null , se não houver renderizadores de células nessa posição.
|
getColumnAt | () | método |
public function getColumnAt(index:uint):DataGridColumn
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 coluna localizada no índice especificado na matriz de colunas
.
Parâmetros
index:uint — O índice da coluna a ser recuperada, ou null , se a coluna não for encontrada.
|
DataGridColumn — O objeto DataGridColumn encontrado no índice especificado.
|
Elementos da API relacionados
getColumnCount | () | método |
public function getColumnCount():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 |
Recupera o número de colunas no componente DataGrid.
Retornauint — Recupera o número de colunas contidas no componente DataGrid.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
colunas
e o método getColumnCount()
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); trace("columns.length:", dg.columns.length); // 3 trace("getColumnCount():", dg.getColumnCount()); // 3 function getRandomNumber():uint { return Math.round(Math.random() * 100); }
columnStretch
é despachado:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.events.DataGridEvent; var nameCol:DataGridColumn = new DataGridColumn("name"); var valueCol:DataGridColumn = new DataGridColumn("value"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler); addChild(myDataGrid); function columnStretchHandler(event:DataGridEvent):void { var col:DataGridColumn; for each (col in myDataGrid.columns) { trace(col.dataField + ":", col.width + "px") } trace(""); }
getColumnIndex | () | método |
public function getColumnIndex(name:String):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 |
Recupera o índice da coluna do nome especificado ou -1, se nenhuma correspondência for encontrada.
Parâmetros
name:String — O campo de dados da coluna a ser localizada.
|
int — O índice do local no qual a coluna do nome especificado é encontrada.
|
Elementos da API relacionados
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; }
itemToCellRenderer | () | método |
override public function itemToCellRenderer(item:Object):ICellRenderer
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
O componente DataGrid tem várias células para cada item determinado, de modo que o método itemToCellRenderer
sempre retorna null
.
Parâmetros
item:Object — O item no provedor de dados.
|
ICellRenderer — null .
|
removeAllColumns | () | método |
public function removeAllColumns():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 todas as colunas do componente DataGrid.
Elementos da API relacionados
removeColumnAt | () | método |
public function removeColumnAt(index:uint):DataGridColumn
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 a coluna localizada no índice especificado da matriz de colunas
.
Parâmetros
index:uint — O índice da coluna a ser removida.
|
DataGridColumn — O objeto DataGridColumn removido. Esse método retorna null , se uma coluna não for encontrada no índice especificado.
|
Elementos da API relacionados
scrollToIndex | () | método |
override public function scrollToIndex(newCaretIndex:int):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Rola a lista até o item no índice especificado. Se o índice estiver fora da faixa, a posição de rolagem não é alterada.
Parâmetros
newCaretIndex:int — O local do índice até o qual ocorre a rolagem.
|
spaceColumnsEqually | () | método |
public function spaceColumnsEqually():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 |
Redefine as larguras das colunas visíveis para o mesmo tamanho.
columnStretch | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.COLUMN_STRETCH
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 depois que um usuário expande uma coluna horizontalmente.
A constanteDataGridEvent.COLUMN_STRETCH
define o valor da propriedade type
de um objeto de evento columnStretch
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | O nome do campo ou propriedade nos dados associados à coluna do item. |
itemRenderer | O renderizador de cabeçalho da coluna que foi expandida. |
motivo | null |
rowIndex | O índice com base em zero do item no provedor de dados. |
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 )
columnStretch
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler); addChild(myDataGrid); function columnStretchHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; var column:DataGridColumn; var columnArray:Array = dg.columns; var dgColWidth:String; trace("resized column:", event.dataField); trace("columnIndex:", event.columnIndex); for each (column in columnArray) { dgColWidth = Number(column.width / dg.width * 100).toFixed(1); trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)"); } trace("----------"); }
headerRelease | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.HEADER_RELEASE
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 depois que o usuário clica em uma célula de cabeçalho.
A constanteDataGridEvent.HEADER_RELEASE
define o valor da propriedade type
de um objeto de evento headerRelease
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | O nome do campo ou propriedade nos dados associados à coluna do item. |
itemRenderer | O renderizador de cabeçalho que foi clicado. |
motivo | null |
rowIndex | -1 |
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 )
headerRelease
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler); addChild(myDataGrid); function headerReleaseHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")"); trace("sortIndex:", dg.sortIndex); trace("sortDescending:", dg.sortDescending); trace("----------"); }
itemEditBegin | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_BEGIN
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 depois que a propriedade editedItemPosition
é definida e o item pode ser editado.
DataGridEvent.ITEM_EDIT_BEGIN
define o valor da propriedade type
de um objeto de evento itemEditBegin
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | null |
itemRenderer | O renderizador de item para o item a ser editado. |
motivo | null |
rowIndex | O índice com base em zero do item no provedor de dados. |
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
itemEditBeginning | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_BEGINNING
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 depois que um usuário se prepara para editar um item, por exemplo, soltando o botão do mouse sobre o item.
A constanteDataGridEvent.ITEM__EDIT_BEGINNING
define o valor da propriedade type
de um objeto de evento itemEditBeginning
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | O nome do campo ou propriedade nos dados associados à coluna do item. |
itemRenderer | O renderizador de item para o item a ser editado. |
motivo | null |
rowIndex | O índice com base em zero do item no provedor de dados. |
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
itemEditEnd | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_END
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 uma sessão de edição de item é finalizada por qualquer motivo.
A constanteDataGridEvent.ITEM_EDIT_END
define o valor da propriedade type
de um objeto de evento itemEditEnd
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | O nome do campo ou propriedade nos dados associados à coluna do item. |
itemRenderer | O renderizador de item para o item a ser editado. |
motivo | Uma constante que define o motivo do evento. O valor deve ser um membro da classe DataGridEventReason . |
rowIndex | O índice com base em zero do item no provedor de dados. |
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
itemFocusIn | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.ITEM_FOCUS_IN
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 depois que um item recebe o foco.
A constanteDataGridEvent.ITEM_FOCUS_IN
define o valor da propriedade type
de um objeto de evento itemFocusIn
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | null |
itemRenderer | O renderizador de item para o item a ser editado. |
motivo | null |
rowIndex | O índice com base em zero do item no provedor de dados. |
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
itemFocusOut | Evento |
fl.events.DataGridEvent
propriedade DataGridEvent.type =
fl.events.DataGridEvent.ITEM_FOCUS_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 depois que um item perde o foco.
A constanteDataGridEvent.ITEM_FOCUS_OUT
define o valor da propriedade type
de um objeto de evento itemFocusOut
.
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 do cabeçalho da coluna na matriz columns do objeto DataGrid. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
dataField | null |
itemRenderer | O renderizador de item para o item a ser editado. |
motivo | null |
rowIndex | O índice com base em zero do item no provedor de dados. |
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
- Adicione o componente DataGrid à biblioteca.
- Salve esse código como DataGridExample.as no mesmo diretório que FLA.
- Defina DocumentClass em FLA como DataGridExample.
package { import flash.display.Sprite; import flash.events.Event; import flash.text.TextField; import fl.controls.DataGrid; public class DataGridExample extends Sprite { var sampleItem1:Object = { Name:"John Alpha", Number:"555-123-0101", Email:"jalpha@fictitious.com" }; var sampleItem2:Object = { Name:"Mary Bravo", Number:"555-372-3322", Email:"mbravo@fictitious.com" }; var sampleItem3:Object = { Name:"Trevor Gamma", Number:"555-485-1212", Email:"tgamma@fictitious.com" }; var sampleItem4:Object = { Name:"Susan Delta", Number:"555-987-3434", Email:"sdelta@fictitious.com" }; var dg:DataGrid; var tf1:TextField; var tf2:TextField; var tf3:TextField; public function DataGridExample() { createDataGrid(); createTextFields(); } private function createDataGrid():void { dg = new DataGrid(); dg.move(10,10); dg.setSize(500,125); dg.columns = ["Name","Number","Email"]; dg.addItem(sampleItem1); dg.addItem(sampleItem2); dg.addItem(sampleItem3); dg.addItem(sampleItem4); dg.addEventListener("change",gridItemSelected); dg.minColumnWidth = dg.width / 3; addChild(dg); } private function createTextFields():void { tf1 = new TextField(); tf2 = new TextField(); tf3 = new TextField(); tf1.x = tf2.x = tf3.x = 10; tf1.autoSize = tf2.autoSize = tf3.autoSize = "left"; tf1.y = 150; tf2.y = 175; tf3.y = 200; addChild(tf1); addChild(tf2); addChild(tf3); } private function gridItemSelected(e:Event):void { tf1.text = "Name: " + e.target.selectedItem.Name; tf2.text = "Number: " + e.target.selectedItem.Number; tf3.text = "Email: " + e.target.selectedItem.Email; } } }
Wed Jun 13 2018, 11:10 AM Z