DataGridTemplateColumn Classe

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Représente une colonne qui héberge le DataGrid contenu spécifié par un modèle dans ses cellules.

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

Héritage

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridTemplateColumn

Exemples

L’exemple suivant montre comment créer un 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>

L’illustration suivante montre la sortie du code XAML précédent.

Remarques

Le DataGridTemplateColumn type vous permet de créer vos propres types de colonnes en spécifiant les modèles de cellule à utiliser lors de l’affichage et de la modification des valeurs. Pour spécifier le modèle utilisé pour afficher le contenu d’une cellule qui n’est pas en mode édition, définissez la CellTemplate propriété. Pour spécifier le modèle utilisé pour afficher le contenu d’une cellule en mode édition, définissez la CellEditingTemplate propriété. Pour plus d’informations sur les modèles, consultez Vue d’ensemble de la création de modèles et styles de données et création de modèles.

Pour plus de commodité, DataGrid fournit les types de colonnes prédéfinis suivants :

Type de colonne	Affichage des données
DataGridHyperlinkColumn	Permet d’afficher les données d’URI.
DataGridComboBoxColumn	Permet d’afficher les données d’énumération.
DataGridTextColumn	Permet d’afficher du texte.
DataGridCheckBoxColumn	Permet d’afficher les données booléennes.

Constructeurs

Nom	Description
DataGridTemplateColumn()	Initialise une nouvelle instance de la classe DataGridTemplateColumn.

Champs

Nom	Description
CellEditingTemplateProperty	Identifie la CellEditingTemplate propriété de dépendance.
CellEditingTemplateSelectorProperty	Identifie la CellEditingTemplateSelector propriété de dépendance.
CellTemplateProperty	Identifie la CellTemplate propriété de dépendance.
CellTemplateSelectorProperty	Identifie la CellEditingTemplateSelector propriété de dépendance.

Propriétés

Nom	Description
ActualWidth	Obtient la largeur actuelle de la colonne, en unités indépendantes de l’appareil (1/96e pouce par unité). (Hérité de DataGridColumn)
CanUserReorder	Obtient ou définit une valeur qui indique si l’utilisateur peut modifier la position d’affichage de la colonne en faisant glisser l’en-tête de colonne. (Hérité de DataGridColumn)
CanUserResize	Obtient ou définit une valeur qui indique si l’utilisateur peut ajuster la largeur de colonne à l’aide de la souris. (Hérité de DataGridColumn)
CanUserSort	Obtient ou définit une valeur qui indique si l’utilisateur peut trier la colonne en cliquant sur l’en-tête de colonne. (Hérité de DataGridColumn)
CellEditingTemplate	Obtient ou définit le modèle à utiliser pour afficher le contenu d’une cellule en mode édition.
CellEditingTemplateSelector	Obtient ou définit l’objet qui détermine le modèle à utiliser pour afficher le contenu d’une cellule en mode édition.
CellStyle	Obtient ou définit le style utilisé pour afficher les cellules de la colonne. (Hérité de DataGridColumn)
CellTemplate	Obtient ou définit le modèle à utiliser pour afficher le contenu d’une cellule qui n’est pas en mode édition.
CellTemplateSelector	Obtient ou définit l’objet qui détermine le modèle à utiliser pour afficher le contenu d’une cellule qui n’est pas en mode édition.
ClipboardContentBinding	Obtient ou définit l’objet de liaison à utiliser lors de l’obtention ou de la définition du contenu de cellule pour le Presse-papiers. (Hérité de DataGridColumn)
DataGridOwner	Obtient le DataGrid contrôle qui contient cette colonne. (Hérité de DataGridColumn)
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
DisplayIndex	Obtient ou définit la position d’affichage de la colonne par rapport aux autres colonnes du DataGrid. (Hérité de DataGridColumn)
DragIndicatorStyle	Obtient ou définit l’objet de style à appliquer à l’en-tête de colonne pendant une opération de glissement. (Hérité de DataGridColumn)
Header	Obtient ou définit le contenu de l’en-tête de colonne. (Hérité de DataGridColumn)
HeaderStringFormat	Obtient ou définit le modèle de format à appliquer au contenu de l’en-tête de colonne. (Hérité de DataGridColumn)
HeaderStyle	Obtient ou définit le style utilisé lors du rendu de l’en-tête de colonne. (Hérité de DataGridColumn)
HeaderTemplate	Obtient ou définit le modèle qui définit la représentation visuelle de l’en-tête de colonne. (Hérité de DataGridColumn)
HeaderTemplateSelector	Obtient ou définit l’objet qui sélectionne le modèle à utiliser pour l’en-tête de colonne. (Hérité de DataGridColumn)
IsAutoGenerated	Obtient une valeur qui indique si la colonne est générée automatiquement. (Hérité de DataGridColumn)
IsFrozen	Obtient une valeur qui indique si la colonne est empêchée de faire défiler horizontalement. (Hérité de DataGridColumn)
IsReadOnly	Obtient ou définit une valeur qui indique si les cellules de la colonne peuvent être modifiées. (Hérité de DataGridColumn)
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
MaxWidth	Obtient ou définit la contrainte de largeur maximale de la colonne. (Hérité de DataGridColumn)
MinWidth	Obtient ou définit la contrainte de largeur minimale de la colonne. (Hérité de DataGridColumn)
SortDirection	Obtient ou définit la direction de tri (croissant ou décroissant) de la colonne. (Hérité de DataGridColumn)
SortMemberPath	Obtient ou définit un nom de propriété ou une hiérarchie délimitée par un point des noms de propriétés, qui indique le membre à trier par. (Hérité de DataGridColumn)
Visibility	Obtient ou définit la visibilité de la colonne. (Hérité de DataGridColumn)
Width	Obtient ou définit la largeur de colonne ou le mode de dimensionnement automatique. (Hérité de DataGridColumn)

Méthodes

Nom	Description
CancelCellEdit(FrameworkElement, Object)	Provoque la modification de la cellule pour rétablir la valeur d’origine non modifiée. (Hérité de DataGridColumn)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
CommitCellEdit(FrameworkElement)	Effectue toute validation requise avant de quitter le mode d’édition de cellule. (Hérité de DataGridColumn)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Obtient un élément défini par la CellEditingTemplate valeur de propriété de Binding la colonne.
GenerateElement(DataGridCell, Object)	Obtient un élément défini par la CellTemplate valeur de propriété de Binding la colonne.
GetCellContent(DataGridRow)	Récupère la Content valeur de propriété de la cellule à l’intersection de cette colonne et de la ligne spécifiée. (Hérité de DataGridColumn)
GetCellContent(Object)	Obtient la Content valeur de propriété de la cellule à l’intersection de cette colonne et de la ligne qui représente l’élément de données spécifié. (Hérité de DataGridColumn)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
NotifyPropertyChanged(String)	Avertit que DataGrid cette colonne contient qu’une propriété de colonne a changé. (Hérité de DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Détermine la valeur de la IsReadOnly propriété en fonction des règles de propriété de la DataGrid colonne qui contient cette colonne. (Hérité de DataGridColumn)
OnCopyingCellClipboardContent(Object)	Déclenche l’événement CopyingCellClipboardContent. (Hérité de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Déclenche l’événement PastingCellClipboardContent. (Hérité de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Appelé chaque fois que la valeur effective d’une propriété de dépendance sur celle-ci DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	En cas de substitution dans une classe dérivée, définit le contenu des cellules en fonction des besoins en matière de modification. (Hérité de DataGridColumn)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
RefreshCellContent(FrameworkElement, String)	Actualise le contenu d’une cellule dans la colonne en réponse à une modification de valeur de propriété du modèle.
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)

Événements

Nom	Description
CopyingCellClipboardContent	Se produit une fois le contenu du Presse-papiers de cellule préparé. (Hérité de DataGridColumn)
PastingCellClipboardContent	Se produit avant le déplacement du contenu du Presse-papiers vers la cellule. (Hérité de DataGridColumn)

Voir aussi

• DataGrid