DataGridTemplateColumn Classe

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Representa uma DataGrid coluna que hospeda o conteúdo especificado pelo modelo em suas células.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn

public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn

type DataGridTemplateColumn = class
    inherit DataGridColumn

Public Class DataGridTemplateColumn
Inherits DataGridColumn

Herança

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridTemplateColumn

Exemplos

O exemplo a seguir mostra como criar um DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

A ilustração a seguir mostra a saída do XAML anterior.

Comentários

O DataGridTemplateColumn tipo permite que você crie seus próprios tipos de coluna especificando os modelos de célula a serem usados ao exibir e editar valores. Para especificar o modelo usado para exibir o conteúdo de uma célula que não está no modo de edição, defina a CellTemplate propriedade. Para especificar o modelo usado para exibir o conteúdo de uma célula que está no modo de edição, defina a CellEditingTemplate propriedade. Para obter mais informações sobre modelos, consulte Visão geral de modelagem de dados , estilo e modelagem.

Para conveniência, DataGrid fornece os seguintes tipos de coluna predefinidos:

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

Construtores

Nome	Description
DataGridTemplateColumn()	Inicializa uma nova instância da classe DataGridTemplateColumn.

Campos

Nome	Description
CellEditingTemplateProperty	Identifica a CellEditingTemplate propriedade de dependência.
CellEditingTemplateSelectorProperty	Identifica a CellEditingTemplateSelector propriedade de dependência.
CellTemplateProperty	Identifica a CellTemplate propriedade de dependência.
CellTemplateSelectorProperty	Identifica a CellEditingTemplateSelector propriedade de dependência.

Propriedades

Nome	Description
ActualWidth	Obtém a largura atual da coluna, em unidades independentes do dispositivo (1/96 polegada por unidade). (Herdado de DataGridColumn)
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)
CellEditingTemplate	Obtém ou define o modelo a ser usado para exibir o conteúdo de uma célula que está no modo de edição.
CellEditingTemplateSelector	Obtém ou define o objeto que determina qual modelo usar para exibir o conteúdo de uma célula que está no modo de edição.
CellStyle	Obtém ou define o estilo usado para renderizar células na coluna. (Herdado de DataGridColumn)
CellTemplate	Obtém ou define o modelo a ser usado para exibir o conteúdo de uma célula que não está no modo de edição.
CellTemplateSelector	Obtém ou define o objeto que determina qual modelo usar para exibir o conteúdo de uma célula que não está no modo de edição.
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 DataGridColumn)
DataGridOwner	Obtém o DataGrid controle que contém esta coluna. (Herdado de DataGridColumn)
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher que 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)
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

Nome	Description
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 isso DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (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 CoerceValueCallback função especificada nos 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 de célula. (Herdado de DataGridColumn)
Equals(Object)	Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Obtém um elemento definido pelo CellEditingTemplate que está associado ao valor da propriedade da Binding coluna.
GenerateElement(DataGridCell, Object)	Obtém um elemento definido pelo CellTemplate que está associado ao valor da propriedade da Binding coluna.
GetCellContent(DataGridRow)	Recupera o valor da Content propriedade da célula na interseção desta coluna e da linha especificada. (Herdado de DataGridColumn)
GetCellContent(Object)	Obtém o Content valor da propriedade da célula na interseção desta coluna e da linha que representa o item de dados especificado. (Herdado de DataGridColumn)
GetHashCode()	Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.DependencyObject (Herdado de DependencyObject)
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)
NotifyPropertyChanged(String)	Notifica o DataGrid que contém esta coluna de que uma propriedade de coluna foi alterada. (Herdado de DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Determina o valor da IsReadOnly propriedade com base nas regras de propriedade do DataGrid que contém esta coluna. (Herdado de DataGridColumn)
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 tiver DependencyObject sido atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Quando substituído em uma classe derivada, define o conteúdo da célula conforme necessário para edição. (Herdado de DataGridColumn)
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 modelo.
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 DependencyPropertyKey identificador 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)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a isso DispatcherObject. (Herdado de DispatcherObject)

Eventos

Nome	Description
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)

Confira também

• DataGrid