DataGridTextColumn Classe

Referência

Definição

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma coluna DataGrid que hospeda conteúdo textual em suas células.

public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridTextColumn = class
    inherit DataGridBoundColumn

Public Class DataGridTextColumn
Inherits DataGridBoundColumn

Herança: Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn
DataGridTextColumn

Exemplos

O exemplo a seguir cria um DataGrid que tem colunas de texto personalizadas e usa dados XML como fonte. A ilustração anterior neste tópico mostra como esse código é exibido. Para obter mais informações sobre a associação a dados XML, consulte How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.

<Window.Resources>
    <XmlDataProvider x:Key="customerdata" Source="customers.xml" XPath="Data" />
</Window.Resources>
<Grid>
    <DataGrid AutoGenerateColumns="False" ItemsSource="{Binding Source={StaticResource customerdata}, XPath=Customer}">
        <DataGrid.Columns>
            <DataGridTextColumn Header="First Name" Binding="{Binding XPath=@FirstName}" FontFamily="Arial" FontStyle="Italic" />
            <DataGridTextColumn Header="Last Name" Binding="{Binding XPath=@LastName}" FontFamily="Arial" FontWeight="Bold" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Comentários

Use DataGridTextColumn para exibir colunas de dados como texto. A ilustração a seguir mostra um exemplo de dois tipos de DataGridTextColumn.

dois DataGridTextColumns DataGridTextColumns

Para criar uma coluna, adicione-a à coleção Columns. Para preencher a coluna, associe a coluna aos dados usando a propriedade Binding. A propriedade Binding é aplicada ao elemento TextBlock ou TextBox criado na coluna. O DataContext para o elemento em cada célula é o item de dados da linha em que a célula está. Portanto, para configurar a associação, você só precisa definir o Binding.Path. Opcionalmente, você pode especificar um Binding.Converter se quiser converter os dados ou o StringFormat. Para obter mais informações sobre a associação de dados, consultede associação de dados (WPF).

ObservaçãoDataGridTextColumn cria um elemento TextBlock no modo de não edição e um elemento TextBox no modo de edição.

Você pode personalizar o DataGridTextColumn definindo propriedades, como Width, Header, FontSizee IsReadOnly.

Se você quiser exibir outros tipos de dados, DataGrid fornecerá os seguintes tipos de coluna:

Tipo de coluna	Exibição de dados
DataGridHyperlinkColumn	Use para exibir dados de URI.
DataGridComboBoxColumn	Use para exibir dados de enumeração.
DataGridCheckBoxColumn	Use para exibir dados boolianos.

Se você quiser usar outros controles em seu DataGrid, poderá criar seus próprios tipos de coluna usando DataGridTemplateColumn.

Construtores

DataGridTextColumn()

Inicializa uma nova instância da classe DataGridTextColumn.

Campos

FontFamilyProperty	Identifica a propriedade de dependência FontFamily.
FontSizeProperty	Identifica a propriedade de dependência FontSize.
FontStyleProperty	Identifica a propriedade de dependência FontStyle.
FontWeightProperty	Identifica a propriedade de dependência FontWeight.
ForegroundProperty	Identifica a propriedade de dependência Foreground.

Propriedades

ActualWidth	Obtém a largura atual da coluna, em unidades independentes do dispositivo (1/96 polegada por unidade). (Herdado de DataGridColumn)
Binding	Obtém ou define a associação que associa a coluna a uma propriedade na fonte de dados. (Herdado de DataGridBoundColumn)
CanUserReorder	Obtém ou define um valor que indica se o usuário pode alterar a posição de exibição da coluna arrastando o cabeçalho da coluna. (Herdado de DataGridColumn)
CanUserResize	Obtém ou define um valor que indica se o usuário pode ajustar a largura da coluna usando o mouse. (Herdado de DataGridColumn)
CanUserSort	Obtém ou define um valor que indica se o usuário pode classificar a coluna clicando no cabeçalho da coluna. (Herdado de DataGridColumn)
CellStyle	Obtém ou define o estilo usado para renderizar células na coluna. (Herdado de DataGridColumn)
ClipboardContentBinding	Obtém ou define o objeto de associação a ser usado ao obter ou definir o conteúdo da célula para a área de transferência. (Herdado de DataGridBoundColumn)
DataGridOwner	Obtém o controle DataGrid que contém esta coluna. (Herdado de DataGridColumn)
DefaultEditingElementStyle	O valor padrão da propriedade EditingElementStyle.
DefaultElementStyle	O valor padrão da propriedade ElementStyle.
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual esse DispatcherObject está associado. (Herdado de DispatcherObject)
DisplayIndex	Obtém ou define a posição de exibição da coluna relativa às outras colunas no DataGrid. (Herdado de DataGridColumn)
DragIndicatorStyle	Obtém ou define o objeto de estilo a ser aplicado ao cabeçalho da coluna durante uma operação de arrastar. (Herdado de DataGridColumn)
EditingElementStyle	Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula no modo de edição. (Herdado de DataGridBoundColumn)
ElementStyle	Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula que não está no modo de edição. (Herdado de DataGridBoundColumn)
FontFamily	Obtém ou define a família de fontes para o conteúdo das células na coluna.
FontSize	Obtém ou define o tamanho da fonte para o conteúdo das células na coluna.
FontStyle	Obtém ou define o estilo da fonte para o conteúdo das células na coluna.
FontWeight	Obtém ou define o peso da fonte para o conteúdo das células na coluna.
Foreground	Obtém ou define o Brush usado para pintar o conteúdo de texto das células na coluna.
Header	Obtém ou define o conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStringFormat	Obtém ou define o padrão de formato a ser aplicado ao conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStyle	Obtém ou define o estilo usado ao renderizar o cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderTemplate	Obtém ou define o modelo que define a representação visual do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderTemplateSelector	Obtém ou define o objeto que seleciona qual modelo usar para o cabeçalho de coluna. (Herdado de DataGridColumn)
IsAutoGenerated	Obtém um valor que indica se a coluna é gerada automaticamente. (Herdado de DataGridColumn)
IsFrozen	Obtém um valor que indica se a coluna é impedida de rolar horizontalmente. (Herdado de DataGridColumn)
IsReadOnly	Obtém ou define um valor que indica se as células na coluna podem ser editadas. (Herdado de DataGridColumn)
IsSealed	Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject)
MaxWidth	Obtém ou define a restrição de largura máxima da coluna. (Herdado de DataGridColumn)
MinWidth	Obtém ou define a restrição de largura mínima da coluna. (Herdado de DataGridColumn)
SortDirection	Obtém ou define a direção de classificação (crescente ou decrescente) da coluna. (Herdado de DataGridColumn)
SortMemberPath	Obtém ou define um nome de propriedade, ou uma hierarquia delimitada por período de nomes de propriedade, que indica o membro pelo qual classificar. (Herdado de DataGridColumn)
Visibility	Obtém ou define a visibilidade da coluna. (Herdado de DataGridColumn)
Width	Obtém ou define a largura da coluna ou o modo de dimensionamento automático. (Herdado de DataGridColumn)

Métodos

CancelCellEdit(FrameworkElement, Object)	Faz com que a célula de coluna que está sendo editada reverta para o valor especificado.
CancelCellEdit(FrameworkElement, Object)	Faz com que a célula que está sendo editada reverta para o valor original não editado. (Herdado de DataGridColumn)
CheckAccess()	Determina se o thread de chamada tem acesso a esse DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um identificador de DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função de CoerceValueCallback especificada em metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject)
CommitCellEdit(FrameworkElement)	Executa qualquer validação necessária antes de sair do modo de edição.
CommitCellEdit(FrameworkElement)	Executa qualquer validação necessária antes de sair do modo de edição de célula. (Herdado de DataGridColumn)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObjectatual. (Herdado de DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Obtém um controle TextBox associado ao valor da propriedade Binding da coluna.
GenerateElement(DataGridCell, Object)	Obtém um controle de TextBlock somente leitura associado ao valor da propriedade Binding da coluna.
GetCellContent(DataGridRow)	Recupera o valor da propriedade Content para a célula na interseção desta coluna e da linha especificada. (Herdado de DataGridColumn)
GetCellContent(Object)	Obtém o valor da propriedade Content para a célula na interseção desta coluna e a linha que representa o item de dados especificado. (Herdado de DataGridColumn)
GetHashCode()	Obtém um código hash para este DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
NotifyPropertyChanged(String)	Notifica o DataGrid que contém esta coluna que uma propriedade de coluna foi alterada. (Herdado de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Notifica o DataGrid quando o valor da propriedade Binding é alterado. (Herdado de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Determina o valor da propriedade IsReadOnly com base nas regras de propriedade da grade de dados que contém esta coluna. (Herdado de DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Gera o evento CopyingCellClipboardContent. (Herdado de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Gera o evento PastingCellClipboardContent. (Herdado de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência neste DependencyObject for atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Chamado quando uma célula na coluna entra no modo de edição.
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject)
RefreshCellContent(FrameworkElement, String)	Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor de propriedade de coluna.
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a esse DispatcherObject. (Herdado de DispatcherObject)

Eventos

CopyingCellClipboardContent	Ocorre depois que o conteúdo da área de transferência da célula é preparado. (Herdado de DataGridColumn)
PastingCellClipboardContent	Ocorre antes que o conteúdo da área de transferência seja movido para a célula. (Herdado de DataGridColumn)

Aplica-se a

Compartilhar via