DataGridTextColumn Classe
Definição
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 o conteúdo textual nas células.
public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumnpublic class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumntype DataGridTextColumn = class
inherit DataGridBoundColumnPublic Class DataGridTextColumn
Inherits DataGridBoundColumn- Herança
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 Como associar a dados XML usando consultas XMLDataProvider e XPath.
<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 DataGridTextColumn tipos.
Para criar uma coluna, adicione-a à Columns coleção. Para preencher a coluna, associe a coluna aos dados usando a Binding propriedade . A Binding propriedade é aplicada ao TextBlock elemento ou TextBox criado na coluna . O DataContext para o elemento em cada célula é o item de dados para a 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, consulte Associação de dados (WPF).
NotaDataGridTextColumn cria um TextBlock elemento no modo de não edição e um TextBox elemento 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 com a 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 seu cabeçalho. (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 seu cabeçalho. (Herdado de DataGridColumn) |
| CellStyle |
Obtém ou define o estilo usado para renderizar as células da 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 este DispatcherObject está associado. (Herdado de DispatcherObject) |
| DisplayIndex |
Obtém ou define a posição de exibição da coluna em relação às outras colunas do DataGrid. (Herdado de DataGridColumn) |
| DragIndicatorStyle |
Obtém ou define o objeto de estilo para aplicar ao cabeçalho de 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 do conteúdo das células na coluna. |
| FontSize |
Obtém ou define o tamanho da fonte do conteúdo das células na coluna. |
| FontStyle |
Obtém ou define o estilo da fonte do 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 que é 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 de coluna. (Herdado de DataGridColumn) |
| HeaderStyle |
Obtém ou define o estilo usado ao renderizar o cabeçalho de coluna. (Herdado de DataGridColumn) |
| HeaderTemplate |
Obtém ou define o modelo que define a representação visual do cabeçalho de 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 é somente autogerenciada. (Herdado de DataGridColumn) |
| IsFrozen |
Obtém um valor que indica se a coluna está 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á validada 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 da classificação (crescente ou decrescente) da coluna. (Herdado de DataGridColumn) |
| SortMemberPath |
Obtém ou define um nome de propriedade, ou uma hierarquia de nomes de propriedade baseada na delimitação por ponto, 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 da 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 este DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject) |
| CoerceValue(DependencyProperty) |
Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject) |
| CommitCellEdit(FrameworkElement) |
Realiza a validação necessária antes de sair do modo de edição. |
| CommitCellEdit(FrameworkElement) |
Realiza a validação necessária antes de sair do modo de edição da célula. (Herdado de DataGridColumn) |
| Equals(Object) |
Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (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 novo controle somente leitura TextBlock associado ao valor da propriedade Binding da coluna. |
| GetCellContent(DataGridRow) |
Recupera o valor da propriedade Content da célula na interseção dessa coluna e da linha especificada. (Herdado de DataGridColumn) |
| GetCellContent(Object) |
Obtém o valor da propriedade Content da célula na interseção dessa coluna e da linha que representa o item de dados especificado. (Herdado de DataGridColumn) |
| GetHashCode() |
Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa 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 nessa instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| NotifyPropertyChanged(String) |
Notifica o DataGrid que contém essa coluna de que uma propriedade da 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 essa coluna. (Herdado de DataGridBoundColumn) |
| OnCopyingCellClipboardContent(Object) |
Aciona o evento CopyingCellClipboardContent. (Herdado de DataGridColumn) |
| OnPastingCellClipboardContent(Object, Object) |
Aciona o evento PastingCellClipboardContent. (Herdado de DataGridColumn) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject) |
| PrepareCellForEdit(FrameworkElement, RoutedEventArgs) |
Chamado quando uma célula na coluna entra em modo de edição. |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject) |
| RefreshCellContent(FrameworkElement, String) |
Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor da propriedade de coluna. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor 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 este DispatcherObject. (Herdado de DispatcherObject) |
Eventos
| CopyingCellClipboardContent |
Ocorre depois que o conteúdo da Área de Transferência é preparado. (Herdado de DataGridColumn) |
| PastingCellClipboardContent |
Ocorre antes de o conteúdo da área de transferência ser movido para a célula. (Herdado de DataGridColumn) |
Aplica-se a
Comentários
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte: https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de