DataGridTextColumn Classe

Définition

Représente une colonne DataGrid qui héberge du contenu textuel dans ses cellules.Represents a DataGrid column that hosts textual content in its cells.

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 un DataGrid qui a des colonnes de texte personnalisées et utilise des données XML comme source.The following example creates a DataGrid that has customized text columns and uses XML data as the source. L’illustration précédente de cette rubrique montre comment ce code est affiché.The illustration earlier in this topic shows how this code is displayed. Pour plus d’informations sur la liaison à des données XML, consultez Comment : effectuer une liaison à des données XML à l’aide d’un XMLDataProvider et de requêtes XPath.For more information about binding to XML data, see How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.

<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.Use DataGridTextColumn to display columns of data as text. L’illustration suivante montre un exemple de deux DataGridTextColumn types.The following illustration shows an example of two DataGridTextColumn types.

Deux DataGridTextColumnsTwo DataGridTextColumns

Pour créer une colonne, ajoutez-la à la Columns collection.To create a column, add it to the Columns collection. Pour remplir la colonne, liez la colonne aux données à l’aide de la Binding propriété.To populate the column, bind the column to the data by using the Binding property. La Binding propriété est appliquée à l' TextBlock TextBox élément ou créé dans la colonne.The Binding property is applied to the TextBlock or TextBox element created in the column. DataContextPour l’élément de chaque cellule, est l’élément de données de la ligne dans laquelle se trouve la cellule.The DataContext for the element in each cell is the data item for the row the cell is in. Par conséquent, pour configurer la liaison, vous devez uniquement définir Binding.Path .Therefore, to set up the binding you only have to set the Binding.Path. Éventuellement, vous pouvez spécifier un Binding.Converter si vous souhaitez convertir les données ou StringFormat .Optionally, you can specify a Binding.Converter if you want to convert the data or the StringFormat. Pour plus d’informations sur la liaison de données, consultez liaison de données (WPF).For more information about data binding, see Data Binding (WPF).

Remarque DataGridTextColumn crée un TextBlock élément en mode sans modification et un TextBox élément en mode édition.Note DataGridTextColumn creates a TextBlock element in the non-editing mode and a TextBox element in the editing mode.

Vous pouvez personnaliser le DataGridTextColumn en définissant des propriétés, telles que Width ,, Header FontSize et IsReadOnly .You can customize the DataGridTextColumn by setting properties, such as Width, Header, FontSize, and IsReadOnly.

Si vous souhaitez afficher d’autres types de données, DataGrid fournit les types de colonnes suivants :If you want to display other types of data, DataGrid provides the following column types:

Type de colonneColumn Type Affichage des donnéesData Display
DataGridHyperlinkColumn Utilisez pour afficher les données de l’URI.Use to display URI data.
DataGridComboBoxColumn Utilisez pour afficher les données d’énumération.Use to display enumeration data.
DataGridCheckBoxColumn Utilisez pour afficher des données booléennes.Use to display Boolean data.

Si vous souhaitez utiliser d’autres contrôles dans votre DataGrid , vous pouvez créer vos propres types de colonnes à l’aide de DataGridTemplateColumn .If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Constructeurs

DataGridTextColumn()

Initialise une nouvelle instance de la classe DataGridTextColumn.Initializes a new instance of the DataGridTextColumn class.

Champs

FontFamilyProperty

Identifie la propriété de dépendance FontFamily.Identifies the FontFamily dependency property.

FontSizeProperty

Identifie la propriété de dépendance FontSize.Identifies the FontSize dependency property.

FontStyleProperty

Identifie la propriété de dépendance FontStyle.Identifies the FontStyle dependency property.

FontWeightProperty

Identifie la propriété de dépendance FontWeight.Identifies the FontWeight dependency property.

ForegroundProperty

Identifie la propriété de dépendance Foreground.Identifies the Foreground dependency property.

Propriétés

ActualWidth

Obtient la largeur actuelle de la colonne en unités indépendantes des appareils (1/96e de pouce par unité)device-independent units (1/96th inch per unit).Gets the current width of the column, in unités indépendantes des appareils (1/96e de pouce par unité)device-independent units (1/96th inch per 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.Gets or sets the binding that associates the column with a property in the data source.

(Hérité de DataGridBoundColumn)
CanUserReorder

Obtient ou définit une valeur qui indique si l'utilisateur peut modifier la position d'affichage des colonnes en faisant glisser leur en-tête.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(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.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Hérité de DataGridColumn)
CanUserSort

Obtient ou définit une valeur qui indique si l'utilisateur peut trier la colonne en cliquant sur son en-tête.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Hérité de DataGridColumn)
CellStyle

Obtient ou définit le style qui est utilisé lors du rendu des cellules de la colonne.Gets or sets the style that is used to render cells in the column.

(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.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Hérité de DataGridBoundColumn)
DataGridOwner

Obtient le contrôle DataGrid qui contient cette colonne.Gets the DataGrid control that contains this column.

(Hérité de DataGridColumn)
DefaultEditingElementStyle

Valeur par défaut de la propriété EditingElementStyle.The default value of the EditingElementStyle property.

DefaultElementStyle

Valeur par défaut de la propriété ElementStyle.The default value of the ElementStyle property.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
DisplayIndex

Obtient ou définit la position d'affichage de la colonne par rapport aux autres colonnes dans le DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Hérité de DataGridColumn)
DragIndicatorStyle

Obtient ou définit l'objet de style à appliquer à l'en-tête de colonne lors d'une opération glisser.Gets or sets the style object to apply to the column header during a drag operation.

(Hérité de DataGridColumn)
EditingElementStyle

Obtient ou définit le style utilisé lors du rendu de l'élément que la colonne affiche pour une cellule en mode édition.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Hérité de DataGridBoundColumn)
ElementStyle

Obtient ou définit le style utilisé lors du rendu de l'élément que la colonne affiche pour une cellule qui n'est pas en mode édition.Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Hérité de DataGridBoundColumn)
FontFamily

Obtient ou définit la famille de polices du contenu des cellules de la colonne.Gets or sets the font family for the content of cells in the column.

FontSize

Obtient ou définit la taille de police du contenu des cellules de la colonne.Gets or sets the font size for the content of cells in the column.

FontStyle

Obtient ou définit le style de police du contenu des cellules de la colonne.Gets or sets the font style for the content of cells in the column.

FontWeight

Obtient ou définit l'épaisseur de police du contenu des cellules de la colonne.Gets or sets the font weight for the content of cells in the column.

Foreground

Obtient ou définit le Brush qui est utilisé pour peindre le texte des cellules de la colonne.Gets or sets the Brush that is used to paint the text contents of cells in the column.

Header

Obtient ou définit le contenu de l'en-tête de la colonne.Gets or sets the content of the column header.

(Hérité de DataGridColumn)
HeaderStringFormat

Obtient ou définit le modèle de format à appliquer au contenu de l'en-tête de colonne.Gets or sets the format pattern to apply to the content of the column header.

(Hérité de DataGridColumn)
HeaderStyle

Obtient ou définit le style utilisé lors du rendu de l'en-tête de colonne.Gets or sets the style that is used when rendering the column header.

(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.Gets or sets the template that defines the visual representation of the column header.

(Hérité de DataGridColumn)
HeaderTemplateSelector

Obtient ou définit l'objet qui sélectionne le modèle utilisé pour l'en-tête de colonne.Gets or sets the object that selects which template to use for the column header.

(Hérité de DataGridColumn)
IsAutoGenerated

Obtient une valeur qui indique si la colonne est générée automatiquement.Gets a value that indicates whether the column is auto-generated.

(Hérité de DataGridColumn)
IsFrozen

Obtient une valeur qui indique si la colonne ne peut pas défiler horizontalement.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Hérité de DataGridColumn)
IsReadOnly

Obtient ou définit une valeur qui indique si les cellules de la colonne peuvent être modifiées.Gets or sets a value that indicates whether cells in the column can be edited.

(Hérité de DataGridColumn)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Hérité de DependencyObject)
MaxWidth

Obtient ou définit la contrainte de largeur maximale applicable à la colonne.Gets or sets the maximum width constraint of the column.

(Hérité de DataGridColumn)
MinWidth

Obtient ou définit la contrainte de largeur minimale applicable à la colonne.Gets or sets the minimum width constraint of the column.

(Hérité de DataGridColumn)
SortDirection

Obtient ou définit le sens de tri (ascendant ou descendant) de la colonne.Gets or sets the sort direction (ascending or descending) of the column.

(Hérité de DataGridColumn)
SortMemberPath

Obtient ou définit un nom de propriété, ou une hiérarchie des noms de propriétés délimitée par des points, qui indique le membre utilisé pour le tri.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Hérité de DataGridColumn)
Visibility

Obtient ou définit la visibilité de la colonne.Gets or sets the visibility of the column.

(Hérité de DataGridColumn)
Width

Obtient ou définit la largeur de la colonne ou le mode de dimensionnement automatique.Gets or sets the column width or automatic sizing mode.

(Hérité de DataGridColumn)

Méthodes

CancelCellEdit(FrameworkElement, Object)

Fait en sorte que la cellule de colonne en cours de modification soit rétablie à la valeur spécifiée.Causes the column cell being edited to revert to the specified value.

CancelCellEdit(FrameworkElement, Object)

Permet de rétablir la cellule en cours de modification à sa valeur initiale non modifiée.Causes the cell being edited to revert to the original, unedited value.

(Hérité de DataGridColumn)
CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

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

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Hérité de DependencyObject)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute 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 DependencyObject appelant.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

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

Exécute toute opération de validation requise avant de quitter le mode édition.Performs any required validation before exiting the edit mode.

CommitCellEdit(FrameworkElement)

Exécute toute opération de validation requise avant de quitter le mode édition de la cellule.Performs any required validation before exiting cell editing mode.

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

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

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

Obtient un contrôle TextBox lié à la valeur de propriété Binding de la colonne.Gets a TextBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Obtient un contrôle TextBlock en lecture seule lié à la valeur de propriété Binding de la colonne.Gets a read-only TextBlock control that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Récupère la valeur de propriété Content pour la cellule située à l'intersection de cette colonne et de la ligne spécifiée.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

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

Obtient la valeur de la 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é.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Hérité de DataGridColumn)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this 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.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.Re-evaluates the effective value for the specified dependency property.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Informe le DataGrid contenant cette colonne qu'une propriété de colonne a été modifiée.Notifies the DataGrid that contains this column that a column property has changed.

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

Avertit DataGrid lorsque la valeur de la propriété Binding change.Notifies the DataGrid when the value of the Binding property changes.

(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.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Hérité de DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)

Déclenche l’événement CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Hérité de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Déclenche l’événement PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Hérité de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.The specific dependency property that changed is reported in the event data.

(Hérité de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Appelée lorsqu'une cellule de la colonne passe en mode édition.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Hérité de DependencyObject)
RefreshCellContent(FrameworkElement, String)

Actualise le contenu d'une cellule de la colonne en réponse à un changement de valeur de propriété de la colonne.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value source.

(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.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(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.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)

Événements

CopyingCellClipboardContent

Se produit après la préparation du contenu du Presse-papiers de la cellule.Occurs after the cell clipboard content is prepared.

(Hérité de DataGridColumn)
PastingCellClipboardContent

Se produit avant le transfert du contenu du Presse-papiers dans la cellule.Occurs before the clipboard content is moved to the cell.

(Hérité de DataGridColumn)

S’applique à