O nome do campo ou propriedade no item do data provider associado à coluna. Cada controle DataGridColumn requer que esse propriedade e/ou a propriedade labelFunction seja ajustada para calcular o texto que pode ser mostrado para o representante de item. Se as propriedades dataField e labelFunction são ajustadas, os dados são mostrados usando o labelFunction e ordenado usando o dataField. Se a propriedade nomeada no dataField não existir, o sortCompareFunction deveria ser ajustada 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.

Ver também

O nome do campo no data provider a ser mostrado como o datatip. Como padrão, o controle DataGrid procura por uma propriedade nomeada label e cada item data provider e mostra ela. No entanto, se o data provider não conter uma propriedade label, você pode ajustar a propriedade dataTipField para especificar uma propriedade diferente. Por exemplo, você poderia ajustar o valor para "FullName" quando um usuário vê um conjunto de nomes de pessoas incluídas de um banco de dados.

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. Essa propriedade é usada pelo método itemToDataTip.

Como padrão o controle procura por uma propriedade nomeada label em cada item data provider em o mostra como seu dataTip. No entanto, alguns data providers não têm uma propriedade label nem eles têm outra propriedade que você pode usar para mostrar os 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 é permitido que o usuário arraste a coluna a uma posição nova. Se true, o usuário pode arrastar os cabeçalhos das colunas a uma nova posição.

O valor padrão é true.

Um indicador que indica se os itens na coluna podem ser editados. Se true, e a propriedade aditável editable também for true, os itens em uma coluna são editáveis e podem ser editadas individualmente clicando em um item ou por navegação até o item usando as teclas Tab e Arrow.

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 DataGrid não irá procurar pela tecla Enter e move o editor em resposta. Note que alterar esse valor enquanto o editor é mostrado não terá 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.

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 DateGridItemRenderer, que mostra os dados dos 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 DataGrid usa o valor da propriedade dataField como o cabeçalho do texto.

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

Um indicador que indica se texto no cabeçalho será wordwrapped caso não caiba em uma linha. Se undefined, a propriedade wordWrap do controle DataGrid é usada.

O valor padrão é undefined.

Especifica o modo IME (editor do método de input). O IME permite aos usuários inputarem texto em chinês, japonês e koreano. Flex ajusta o modo IME quando o evento itemFocus ocorre, e ajusta de volta ao valor prévio quando o evento itemFocusOut ocorre. A classe flash.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 DataGrid.

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 é new ClassFactory(mx.controls.TextInput).

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 DateGridItemRenderer, que mostra os dados dos item como texto.

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

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 entante, as vezes você quer mostrar texto baseado em amis de um campo nos dados, ou mostrar algo que não tem o formato que você quer. Em tal caso você especifica uma função callback usando labelFunction.

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

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

Onde item contém o objeto de item do DataGrid, e column especifica a coluna DataGrid.

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.

O valor padrão é 20..

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

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 DateGridItemRenderer, que mostra os dados dos item como texto.

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.

Um indicador que indica se o usuário tem permissão para redimensionar 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.

Um indicador que indica se os datatips são mostrados 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.

Um indicador que indica se o usuário pode clicar no cabeçalho dessa coluna para ordenar o data provider. Se essa propriedade e a propriedade sortableColumns são ambos true, o controle DataGrid despacha um evento headerRelease quando o usuário solta o botão do mouse no cabeçalho dessa coluna. Se outro manejado não chama o método preventDefault() no evento headerRelease, a propriedade dataField ou sortCompareFunction na coluna é usada para reordenar os itens no dataProvider. Se nenhum outro manejador chama o método preventDefault() no evento headerRelease, a propriedade dataField ou sortCompareFunction na coluna é usada para reordenar os itens no dataProvider.

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 DataGrid 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.

Ajustar essa propriedade não começa uma ordenação; só ajusta a direção da ordenação. Clica no cabeçalho da coluna par executar a ordenação.

O valor padrão é false;.

Um indicador que indica se a coluna está visível. Se true, a coluna é visível.

O valor padrão é true.

A largura da coluna, em pixels. Se a propriedade horizontalScrollPolicy do DataGrid for false, todas as colunas devem caber na área que pode ser mostada, e o DataGrid não irá honrar a largura da coluna se a largura total das colunas se for muito pequena ou grande para a área a ser mostrada.

O valor padrão é 100.

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

Um indicador que indica se o texto em uma fileira para essa coluna é embrulhada se não couber em uma linha. Se undefined, a propriedade wordWrap do controle DataGrid é usada.

Só faz efeito se a propriedade DataGrid.variableRowHeight també for true.

O valor padrão é undefined.

Constructor.

Retorna o factory apropriado, usando o factory padrão caso nenhum tenha sido especificado.

Parâmetros

Retorna um String que o representante de item mostra como o datatip para o dado objeto de dados, baseado nas propriedades dataTipField e dataTipFuntion. Se o método não puder converter o parâmetro em um String, ele retornará um espaço único.

Esse método é para uso dos developers que estão criando subclasses da classe DataGridColumn. Não é para uso de developers de aplicativos.

Parâmetros

Retorna o String que o representante de item mostra para o objeto de dados. Se o controle DataGridColumn ou DataGrid tem uma propriedade labelFunction não-null, ele aplica a funão ao objeto de dados. Em outro caso, o método extrai os conteúdos do campo especificado pela propriedade dataField, ou pega o valor do string para o 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