Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe DataGridTextColumn

.NET Framework (current version)
 

Representa uma coluna DataGrid que hospeda o conteúdo textual nas células.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (em PresentationFramework.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Controls.DataGridColumn
        System.Windows.Controls.DataGridBoundColumn
          System.Windows.Controls.DataGridTextColumn

public class DataGridTextColumn : DataGridBoundColumn

NomeDescrição
System_CAPS_pubmethodDataGridTextColumn()

Inicializa uma nova instância da classe DataGridTextColumn.

NomeDescrição
System_CAPS_pubpropertyActualWidth

Obtém a largura atual da coluna, em unidades independentes de dispositivo (1/96 polegada por unidade).(Herdado de DataGridColumn.)

System_CAPS_pubpropertyBinding

Obtém ou define a associação que associa a coluna com a propriedade na fonte de dados.(Herdado de DataGridBoundColumn.)

System_CAPS_pubpropertyCanUserReorder

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

System_CAPS_pubpropertyCanUserResize

Obtém ou define um valor que indica se o usuário pode ajustar a largura da coluna usando o mouse.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyCanUserSort

Obtém ou define um valor que indica se o usuário pode classificar a coluna clicando no seu cabeçalho.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyCellStyle

Obtém ou define o estilo usado para renderizar as células da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyClipboardContentBinding

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

System_CAPS_protpropertyDataGridOwner

Obtém o DataGrid controle que contém essa coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertySystem_CAPS_staticDefaultEditingElementStyle

O valor padrão de EditingElementStyle propriedade.

System_CAPS_pubpropertySystem_CAPS_staticDefaultElementStyle

O valor padrão de ElementStyle propriedade.

System_CAPS_pubpropertyDependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject.)

System_CAPS_pubpropertyDispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.(Herdado de DispatcherObject.)

System_CAPS_pubpropertyDisplayIndex

Obtém ou define a posição de exibição da coluna em relação às outras colunas do DataGrid.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyDragIndicatorStyle

Obtém ou define o objeto de estilo para aplicar ao cabeçalho da coluna durante uma operação de arrastar.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyEditingElementStyle

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

System_CAPS_pubpropertyElementStyle

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

System_CAPS_pubpropertyFontFamily

Obtém ou define a família de fonte para o conteúdo de células na coluna.

System_CAPS_pubpropertyFontSize

Obtém ou define o tamanho da fonte do conteúdo das células na coluna.

System_CAPS_pubpropertyFontStyle

Obtém ou define o estilo da fonte para o conteúdo de células na coluna.

System_CAPS_pubpropertyFontWeight

Obtém ou define a espessura da fonte para o conteúdo de células na coluna.

System_CAPS_pubpropertyForeground

Obtém ou define o Brush que é usado para pintar o conteúdo de texto das células na coluna.

System_CAPS_pubpropertyHeader

Obtém ou define o conteúdo do cabeçalho da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyHeaderStringFormat

Obtém ou define o formato padrão para aplicar o conteúdo do cabeçalho da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyHeaderStyle

Obtém ou define o estilo usado ao renderizar o cabeçalho de coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyHeaderTemplate

Obtém ou define o modelo que define a representação visual do cabeçalho de coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyHeaderTemplateSelector

Obtém ou define o objeto que seleciona o modelo a ser usado para o cabeçalho de coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyIsAutoGenerated

Obtém um valor que indica se a coluna é gerado automaticamente.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyIsFrozen

Obtém um valor que indica se a coluna está impedida de rolar horizontalmente.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyIsReadOnly

Obtém ou define um valor que indica se as células na coluna podem ser editadas.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyIsSealed

Obtém um valor que indica se essa instância atualmente é selada (somente leitura). (Herdado de DependencyObject.)

System_CAPS_pubpropertyMaxWidth

Obtém ou define a restrição de largura máxima da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyMinWidth

Obtém ou define a restrição de largura mínima da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertySortDirection

Obtém ou define a direção da classificação (crescente ou decrescente) da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertySortMemberPath

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

System_CAPS_pubpropertyVisibility

Obtém ou define a visibilidade da coluna.(Herdado de DataGridColumn.)

System_CAPS_pubpropertyWidth

Obtém ou define a largura da coluna ou o modo de dimensionamento automático.(Herdado de DataGridColumn.)

NomeDescrição
System_CAPS_protmethodCancelCellEdit(FrameworkElement, Object)

Faz com que a célula da coluna que está sendo editada para reverter ao valor especificado.(Substitui o DataGridColumn.CancelCellEdit(FrameworkElement, Object).)

System_CAPS_pubmethodCheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.(Herdado de DispatcherObject.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty.(Herdado de DependencyObject.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey.(Herdado de DependencyObject.)

System_CAPS_pubmethodCoerceValue(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.)

System_CAPS_protmethodCommitCellEdit(FrameworkElement)

Executa alguma validação necessária antes de sair do modo de edição.(Substitui o DataGridColumn.CommitCellEdit(FrameworkElement).)

System_CAPS_pubmethodEquals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.(Herdado de DependencyObject.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_protmethodGenerateEditingElement(DataGridCell, Object)

Obtém um TextBox controle que esteja vinculado à coluna de Binding valor da propriedade.(Substitui o DataGridColumn.GenerateEditingElement(DataGridCell, Object).)

System_CAPS_protmethodGenerateElement(DataGridCell, Object)

Obtém somente leitura TextBlock controle que esteja vinculado à coluna de Binding valor da propriedade.(Substitui o DataGridColumn.GenerateElement(DataGridCell, Object).)

System_CAPS_pubmethodGetCellContent(DataGridRow)

Recupera o valor da propriedade Content da célula na interseção dessa coluna e da linha especificada.(Herdado de DataGridColumn.)

System_CAPS_pubmethodGetCellContent(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.)

System_CAPS_pubmethodGetHashCode()

Obtém o código hash para esse DependencyObject.(Herdado de DependencyObject.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.(Herdado de DependencyObject.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.(Herdado de DependencyObject.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada(Herdado de DependencyObject.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodNotifyPropertyChanged(String)

Notifica o DataGrid que contém essa coluna de que uma propriedade da coluna foi alterada.(Herdado de DataGridColumn.)

System_CAPS_protmethodOnBindingChanged(BindingBase, BindingBase)

Notifica o DataGrid quando o valor de Binding alterações de propriedade.(Herdado de DataGridBoundColumn.)

System_CAPS_protmethodOnCoerceIsReadOnly(Boolean)

Determina o valor de IsReadOnly propriedade com base nas regras de propriedade da grade de dados que contém essa coluna.(Herdado de DataGridBoundColumn.)

System_CAPS_pubmethodOnCopyingCellClipboardContent(Object)

Gera o CopyingCellClipboardContent evento.(Herdado de DataGridColumn.)

System_CAPS_pubmethodOnPastingCellClipboardContent(Object, Object)

Gera o PastingCellClipboardContent evento.(Herdado de DataGridColumn.)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada. A propriedade de dependência específica que mudou é relatada os dados do evento.(Herdado de DependencyObject.)

System_CAPS_protmethodPrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Chamado quando uma célula na coluna entra em modo de edição.(Substitui o DataGridColumn.PrepareCellForEdit(FrameworkElement, RoutedEventArgs).)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.(Herdado de DependencyObject.)

System_CAPS_protmethodRefreshCellContent(FrameworkElement, String)

Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor de propriedade de coluna.(Substitui o DataGridBoundColumn.RefreshCellContent(FrameworkElement, String).)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.(Herdado de DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.(Herdado de DependencyObject.)

System_CAPS_pubmethodSetValue(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.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecido.(Herdado de DependencyObject.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_pubmethodVerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.(Herdado de DispatcherObject.)

NomeDescrição
System_CAPS_pubfieldSystem_CAPS_staticFontFamilyProperty

Identifica a propriedade de dependência FontFamily.

System_CAPS_pubfieldSystem_CAPS_staticFontSizeProperty

Identifica a propriedade de dependência FontSize.

System_CAPS_pubfieldSystem_CAPS_staticFontStyleProperty

Identifica a propriedade de dependência FontStyle.

System_CAPS_pubfieldSystem_CAPS_staticFontWeightProperty

Identifica a propriedade de dependência FontWeight.

System_CAPS_pubfieldSystem_CAPS_staticForegroundProperty

Identifica a propriedade de dependência Foreground.

NomeDescrição
System_CAPS_pubeventCopyingCellClipboardContent

Ocorre depois que o conteúdo da célula da área de transferência está preparado.(Herdado de DataGridColumn.)

System_CAPS_pubeventPastingCellClipboardContent

Ocorre antes do conteúdo da área de transferência é movido para a célula.(Herdado de DataGridColumn.)

Use T:System.Windows.Controls.DataGridTextColumn to display columns of data as text. The following illustration shows an example of two T:System.Windows.Controls.DataGridTextColumn types.

Duas DataGridTextColumns

To create a column, add it to the P:System.Windows.Controls.DataGrid.Columns collection. To populate the column, bind the column to the data by using the P:System.Windows.Controls.DataGridBoundColumn.Binding property. The P:System.Windows.Controls.DataGridBoundColumn.Binding property is applied to the T:System.Windows.Controls.TextBlock or T:System.Windows.Controls.TextBox element created in the column. The P:System.Windows.FrameworkElement.DataContext for the element in each cell is the data item for the row the cell is in. Therefore, to set up the binding you only have to set the P:System.Windows.Data.Binding.Path. Optionally, you can specify a P:System.Windows.Data.Binding.Converter if you want to convert the data or the P:System.Windows.Data.BindingBase.StringFormat. For more information about data binding, see Data Binding (WPF).

Note   DataGridTextColumn creates a TextBlock element in the non-editing mode and a TextBox element in the editing mode.

You can customize the T:System.Windows.Controls.DataGridTextColumn by setting properties, such as P:System.Windows.Controls.DataGridColumn.Width, P:System.Windows.Controls.DataGridColumn.Header, P:System.Windows.Controls.DataGridTextColumn.FontSize, and P:System.Windows.Controls.DataGridColumn.IsReadOnly.

If you want to display other types of data, T:System.Windows.Controls.DataGrid provides the following column types:

Column Type

Data Display

DataGridHyperlinkColumn

Use to display URI data.

DataGridComboBoxColumn

Use to display enumeration data.

DataGridCheckBoxColumn

Use to display Boolean data.

If you want to use other controls in your T:System.Windows.Controls.DataGrid, you can create your own column types by using T:System.Windows.Controls.DataGridTemplateColumn.

The following example creates a T:System.Windows.Controls.DataGrid that has customized text columns and uses XML data as the source. The illustration earlier in this topic shows how this code is displayed. For more information about binding to XML data, see How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.

.NET Framework
Disponível desde 4.0
Silverlight
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: