O nome do campo ou propriedade no item data provider associado à coluna. Cada controle AdvancedDataGridColumn requer essa propriedade e/ou a propriedade labelFunction para ser ajustada para poder calcular o texto a ser mostrado para o representante de item. Se as propriedade dataField e labelFunction são ajustadas, os dados são mostrados usando o labelFunction e armazenados usando o dataField. Se a propriedade nomeada no dataField não existir, o sortCompareFunction deve ser ajustado para que a ordenação funcione corretamente.

Esse valor dessa propriedade não é necessariamente o String que é mostrado no cabeçalho da coluna. Essa propriedade é usada somente para acessar os dados no data provider. Para maiores informações, veja a propriedade headerText.

Essa propriedade pode ser usada como a fonte para a união de dados.

Ver também

O nome do campo no data provider para ser mostrado como data tip. Como padrão, o controle AdvancedDataGrid procura uma propriedade com nome label em cada item data provider e mostra ele. No entanto, se o data provider não conter uma propriedade label, você pode ajustar a propriedade dataTipField para especificar uma propriedade diferente.

Essa propriedade pode ser usada como a fonte para a união de dados.

Especifica uma função callback para executar em cada item do data provider para determinar seu data tip. This property is used by the itemToDataTip() method.

Como padrão o controle procura uma propriedade com nome label em cada item data provider e mostra ele como sendo seu dataTip. No entanto, alguns data providers não tem uma propriedade label ou outra propriedade que você pode usar para mostrar dados nas fileiras. Por exemplo, você talvez tenha um data provide que contém os campos lastName e firstName, mas você quer mostrar nomes inteiros como sendo o dataTip. Você pode especificar uma função para a propriedade dataTipFunction que retorna um único String contendo o valor para ambos os campos. Você pode também usar a propriedade dataTipFunction para manejar a formatação e localização.

A função deve pegar um único parâmetro do Object, contendo o elemento data provider, e retornar um String.

Essa propriedade pode ser usada como a fonte para a união de dados.

Um indicador que indica se os itens na coluna podem ser editados. Se true, e se a propriedade editable do AdvancedDataGrid também for true, os itens nas colunas pode ser editadas e pode ser também editadas individualmente.

O valor padrão é true.

O nome da propriedade do editor de item que contém os novos dados para o item de lista. Por exemplo, o itemEditor padrão é TextInput, então o valor padrão da propriedade editorDataField é "text", que especifica a propriedade text do controle TextInput.

O valor padrão é "text".

A altura do editor de item, em pixels, relativo ao tamanho do representante de item. Essa propriedade pode ser usada para fazer com que o editor se sobreponha ao representante de item em alguns pixels para compensar uma borda em volta do editor. Nota que mudando esses valores enquanto o editor estiver sendo mostrado não afetará o editor atual, mas afetará o próximo representante de item que abre o editor.

O valor padrão é 0.

Um indicador que indica se o editor de item usa a tecla Enter.Se true o editor de item usa a tecla Enter e o AdvancedDataGrid não irá procurar a tecla Enter e mover o editor em repsosta. Nota que alterando esse valor enquanto o editor é mostrado não surtirá efeito no editor atual, mas afetará o próximo representante de item que abre um editor.

O valor padrão é false.

A largura do editor de item, em pixels, relativo ao tamanho do representante de item. Essa propriedade pode ser usada para fazer com que o editor se sobreponha ao representante de item em alguns pixels para compensar uma borda em volta do editor. Nota que mudando esses valores enquanto o editor estiver sendo mostrado não afetará o editor atual, mas afetará o próximo representante de item que abre o editor.

O valor padrão é 0.

O local x do canto superior esquerdo de um editor de item, em pixels, relativo ao canto esquerdo superior do item. Essa propriedade pode ser usada para fazer com que o editor se sobreponha ao representante de item em alguns pixels para compensar uma borda em volta do editor. Nota que mudando esses valores enquanto o editor estiver sendo mostrado não afetará o editor atual, mas afetará o próximo representante de item que abre o editor.

O valor padrão é 0.

O local y do canto superior esquerdo de um editor de item, em pixels, relativo ao canto esquerdo superior do item. Essa propriedade pode ser usada para fazer com que o editor se sobreponha ao representante de item em alguns pixels para compensar uma borda em volta do editor. Nota que mudando esses valores enquanto o editor estiver sendo mostrado não afetará o editor atual, mas afetará o próximo representante de item que abre o editor.

O valor padrão é 0.

Uma instância de uma subclasse do mx.formatters.Formatter. O controle usa essa classe para formatar o texto da coluna.

O valor padrão é null.

O factory da classe para as instâncias de representente de item que mostram o cabeçalho da coluna para a coluna. Você pode especificar um representante de um item drop-in, um representante de item inline, ou um componente de representante de item padrão como sendo o valor dessa propriedade.

O representante de item padrão é a classe AdvancedDataGridItemRenderer, que mostra os dados do item como texto.

Essa propriedade pode ser usada como a fonte para a união de dados.

Texto para o cabeçalho dessa coluna. Como padrão, o controle AdvancedDataGrid usa o valor da propriedade dataField como o texto do cabeçalho.

Essa propriedade pode ser usada como a fonte para a união de dados.

Ajustado para true para embrulhar o texto no cabeçalho da coluna se não couber em uma linha. Se undefined, a propriedade wordWrap do controle AdvancedDataGrid é usada. Essa propriedade exclui a propriedade headerWordWrap do controle AdvancedDataGrid.

O valor padrão é undefined.

Especifica o modo IME (editor de método de input). O mode IME permite que usuário usam textos em chinês, japonês, e coreano. Flex ajusta o modo IME quando o evento itemFocusIn ocorre, e ajusta de volta ao valor prévio quando o evento itemFocusOut ocorre. A classe flahs.system.IMEConversionMode define constantes para os valores válidos para essa propriedade.

O valor padrão é null, nesse caso ele usa o valor da propriedade imeMode do controle AdvancedDataGrid.

Ver também

Um factory da classe para as instâncias do editor de itens para usar para a coluna, quando for possível editar.

O valor padrão é o controle mx.controls.TextInput.

Ver também

A classe factory para instâncias de representantes de itens que mostram os dados para cada item na coluna. Você pode especificar um representante de um item drop-in, um representante de item inline, ou um componente de representante de item padrão como sendo o valor dessa propriedade.

O representante de item padrão é a classe AdvancedDataGridItemRenderer, que mostra os dados do item como texto.

Essa propriedade pode ser usada como a fonte para a união de dados.

Ver também

A função que determina o texto para mostrar nessa coluna. Como padrão, a coluna mostra o texto para o campo nos dados que combinam com o nome da coluna. No entanto, as vezes você pode querer mostrar o texto baseado em mais que um campo nos dados, ou mostrar alguma coisa que não tem o formato que você quer. Em tal caso, você especifica uma função callback labelFunction.

Para o controle AdvancedDataGrid, a assinatura do método tem o a seguinte forma:

labelFunction(item:Object, column:AdvancedDataGridColumn):String

onde item contém o item de objeto AdvancedDataGrid, e column especifica a coluna AdvancedDataGrid.

Uma função callback pode concatenar os campos firstName e lastName nos dados, ou faça alguma formatação padrão em um Date, ou converta um número para o mês no string para o mês.

Essa propriedade pode ser usada como a fonte para a união de dados.

A largura mínima da coluna, em pixels.

O valor padrão é 20.

Essa propriedade pode ser usada como a fonte para a união de dados.

Um indicador que indica que o representante de item é também um editor de item. Se essa propriedade for true, Flex ignora a propriedade itemEditor e usa o representante de item como editor para aquele item.

O valor padrão é false.

Ajustado para true se é permitido ao usuário mudar a largura da coluna. Se true, o usuário pode arrastar as linhas do grid que ficam entre os cabeçalhos das colunas para redefinir o tamanho da coluna.

O valor padrão é true.

Ajustado para true para mostrar data tips na coluna. Se true, datatips são mostrados como texto nas fileiras. Datatips são tooltips designados para mostrarem o texto que é muito comprido para a fileira.

O valor padrão é false.

Ajustado para true para indicar que o usuário pode clicar no cabeçalho dessa coluna para ordenar o data provider. Se essa propriedade e a propriedade AdvancedDataGrid sortableColumns são ambos true, o controle AdvancedDataGrid despacha um evento headerRelease quando o usuário libera o botão do mouse no cabeçalho dessa coluna. Se nenhum outro handler chama o método preventDefault() no evento headerRelease, a propriedade dataField ou sortCompareFunction na coluna é usada para reordenar os itens no data provider.

O valor padrão é true.

Uma função callback que é chamada quando ordenando os dados na coluna. Se essa proriedade não for especificada, a ordenação tenta usar um string básico ou ordenação por número nos dados. Se o dado não for um srting ou número ou se a proriedade dataField não é uma propriedade válida do data provider, a ordenação não irá funcionar ou irá gerar uma exceção. Se você especificar um valor da propriedade labelFunction, você deve também providenciar uma função para a propriedade sortCompareFunction, se a ordenação não for permitida nessa coluna.

O controle AdvancedDataGrid usa essa função para ordenar os elementos da coleção do data provider. A assinatura de função da função callback leva dois parâmetros e tem a seguinte forma:

mySortCompareFunction(obj1:Object, obj2:Object):int 

obj1 — Um elemento de dados para comparar.

obj2 — Outro elemento de dados para comparar com o obj1.

A função deveria retornar um valor baseado na comparação dos objetos:

• -1 se obj1 apareça antes do obj2 em ordem ascendenter.
• 0 se obj1 = obj2.
• 1 se obj1 apareça depois do obj2 em ordem ascendente.

Note: Os parâmetros obj1 e obj2 são elementos data provider e não somente os dados para o item.

O valor padrão é null.

Essa propriedade pode ser usada como a fonte para a união de dados.

Indica se a ordenação da coluna é ascendente, false, ou descendente, true.

O valor padrão é false.

Uma função callback que é chamada quando está representando cada célula. A assinatura da função deveria ser:

function myStyleFunction(data:Object, column:AdvancedDataGridColumn):Object

data - objeto de dados associado ao item sendo representado.

column - instância AdvancedDataGrid com qual o representante de item está associado.

O valor de retorno deveria ser um objeto com estilos como propriedades tendo os valores requisitados. Por exemplo:

{ color:0xFF0000, fontWeight:"bold" }

Se true, a coluna é visível. Ajustado para false para esconder a coluna.

O valor padrão é true.

A largura da coluna, em pixels. Se a propriedade horizontalScrollPolicy do AdvancedDataGrid for false, todas as colunas visíveis devem caber na área mostrada, e o AdvancedDataGrid nem sempre irá honrar a largura das colunas se a largura total das colunas for muito pequena ou muito grande para a área mostrada.

O valor padrão é 100.

Essa propriedade pode ser usada como a fonte para a união de dados.

Ajustado para false para envolver o texto em uma filiera dessa coluna porque não cabe em uma linha. Se não definido, a propriedade do controle wordWrap do AdvancedDataGrid é usado.

O valor padrão é undefined.

Constructor.

Clona essa coluna e retorna um novo Column com as mesmas propriedades e estilos que essa. Não ajusta todas as propriedades disponíveis.

Retorna um String que o representante de item mostra como sendo o data tip para os objetos de dados, baseando-se nas propriedades dataTipField e dataTipFunction. Se o método não puder converter o parâmetro em um String, ele retornará um espaço único.

Esse método é usado por develepors que estão criando subclasses da classe AdvancedDataGrid. Não é para ser usado por developers de aplicativos.

Parâmetros

Retorna o String que o representante de item mostra para o objeto de dados. Se o AdvancedDataGridColumn ou seu controle AdvancedDataGrid tiver uma propriedade labelFunciton não nula, ele aplica a função ao objeto de dados. Se o método não puder converter o parâmetro em um String, ele retornará um espaço único.

Parâmetros