DataGridTextColumn Classe

Définition

Représente une colonne DataGrid qui héberge du contenu textuel dans ses cellules.

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
Héritage

Exemples

L’exemple suivant crée une DataGrid qui a des colonnes de texte personnalisées et utilise des données XML comme source. L’illustration précédente de cette rubrique montre comment ce code est affiché. Pour plus d’informations sur la liaison à des données XML, consultez Guide pratique pour lier des données XML à l’aide d’un xmlDataProvider et de requêtes 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>

Remarques

Utilisez DataGridTextColumn pour afficher des colonnes de données sous forme de texte. L’illustration suivante montre un exemple de deux types DataGridTextColumn.

Two DataGridTextColumns

Pour créer une colonne, ajoutez-la à la collection Columns. Pour remplir la colonne, liez la colonne aux données à l’aide de la propriété Binding. La propriété Binding est appliquée à l’élément TextBlock ou TextBox créé dans la colonne. La DataContext de l’élément de chaque cellule est l’élément de données de la ligne dans laquelle se trouve la cellule. Par conséquent, pour configurer la liaison, vous devez uniquement définir la Binding.Path. Si vous le souhaitez, vous pouvez spécifier une Binding.Converter si vous souhaitez convertir les données ou le StringFormat. Pour plus d’informations sur la liaison de données, consultez wpF (Data Binding).

RemarqueDataGridTextColumn crée un élément TextBlock en mode non édition et un élément TextBox en mode édition.

Vous pouvez personnaliser l'DataGridTextColumn en définissant des propriétés, telles que Width, Header, FontSizeet IsReadOnly.

Si vous souhaitez afficher d’autres types de données, DataGrid fournit les types de colonnes 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.
DataGridCheckBoxColumn Permet d’afficher les données booléennes.

Si vous souhaitez utiliser d’autres contrôles dans votre DataGrid, vous pouvez créer vos propres types de colonnes à l’aide de DataGridTemplateColumn.

Constructeurs

DataGridTextColumn()

Initialise une nouvelle instance de la classe DataGridTextColumn.

Champs

FontFamilyProperty

Identifie la propriété de dépendance FontFamily.

FontSizeProperty

Identifie la propriété de dépendance FontSize.

FontStyleProperty

Identifie la propriété de dépendance FontStyle.

FontWeightProperty

Identifie la propriété de dépendance FontWeight.

ForegroundProperty

Identifie la propriété de dépendance Foreground.

Propriétés

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

Obtient ou définit la liaison qui associe la colonne à une propriété dans la source de données.

(Hérité de DataGridBoundColumn)
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)
CellStyle

Obtient ou définit le style utilisé pour afficher les cellules de la colonne.

(Hérité de DataGridColumn)
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 DataGridBoundColumn)
DataGridOwner

Obtient le contrôle DataGrid qui contient cette colonne.

(Hérité de DataGridColumn)
DefaultEditingElementStyle

Valeur par défaut de la propriété EditingElementStyle.

DefaultElementStyle

Valeur par défaut de la propriété ElementStyle.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.

(Hérité de DependencyObject)
Dispatcher

Obtient la Dispatcher cette DispatcherObject est associée.

(Hérité de DispatcherObject)
DisplayIndex

Obtient ou définit la position d’affichage de la colonne par rapport aux autres colonnes de la 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)
EditingElementStyle

Obtient ou définit le style utilisé lors du rendu de l’élément affiché par la colonne pour une cellule en mode édition.

(Hérité de DataGridBoundColumn)
ElementStyle

Obtient ou définit le style utilisé lors du rendu de l’élément affiché par la colonne pour une cellule qui n’est pas en mode édition.

(Hérité de DataGridBoundColumn)
FontFamily

Obtient ou définit la famille de polices pour le contenu des cellules de la colonne.

FontSize

Obtient ou définit la taille de police pour le contenu des cellules de la colonne.

FontStyle

Obtient ou définit le style de police pour le contenu des cellules de la colonne.

FontWeight

Obtient ou définit l’épaisseur de police pour le contenu des cellules de la colonne.

Foreground

Obtient ou définit la Brush utilisée pour peindre le contenu du texte des cellules de la colonne.

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

CancelCellEdit(FrameworkElement, Object)

Provoque la modification de la cellule de colonne à la valeur spécifiée.

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

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.

(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 fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObjectappelant.

(Hérité de DependencyObject)
CommitCellEdit(FrameworkElement)

Effectue toute validation requise avant de quitter le mode d’édition.

CommitCellEdit(FrameworkElement)

Effectue toute validation requise avant de quitter le mode d’édition de cellule.

(Hérité de DataGridColumn)
Equals(Object)

Détermine si une DependencyObject fournie équivaut à la DependencyObjectactuelle.

(Hérité de DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Obtient un contrôle TextBox lié à la valeur de propriété Binding de la colonne.

GenerateElement(DataGridCell, Object)

Obtient un contrôle TextBlock en lecture seule lié à la valeur de propriété Binding de la colonne.

GetCellContent(DataGridRow)

Récupère la valeur de la propriété Content pour la cellule à l’intersection de cette colonne et de la ligne spécifiée.

(Hérité de DataGridColumn)
GetCellContent(Object)

Obtient la valeur de propriété Content pour 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 cette 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 cette DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
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)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
NotifyPropertyChanged(String)

Avertit le DataGrid qui contient cette colonne qu’une propriété de colonne a changé.

(Hérité de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Avertit le DataGrid lorsque la valeur de la propriété Binding change.

(Hérité de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Détermine la valeur de la propriété IsReadOnly en fonction des règles de propriété de la grille de données qui contient cette colonne.

(Hérité de DataGridBoundColumn)
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ée chaque fois que la valeur effective d’une propriété de dépendance sur cette 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)

Appelé lorsqu’une cellule de la colonne entre en mode édition.

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é de colonne.

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)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
VerifyAccess()

Applique que le thread appelant a accès à ce DispatcherObject.

(Hérité de DispatcherObject)

Événements

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)

S’applique à