DataGridCheckBoxColumn Classe

Définition

Représente une colonne DataGrid qui héberge des contrôles CheckBox dans ses cellules.Represents a DataGrid column that hosts CheckBox controls in its cells.

public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumn
public class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumn
type DataGridCheckBoxColumn = class
    inherit DataGridBoundColumn
Public Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn
Héritage

Exemples

L’exemple suivant montre comment ajouter un DataGridCheckBoxColumn .The following example shows how to add a DataGridCheckBoxColumn. Cet exemple utilise une base de données comme source et affiche une colonne de données booléennes.This example uses a database as the source and displays a column of Boolean data.

<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
    <DataGrid.Columns>
        <DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
    </DataGrid.Columns>
</DataGrid>

Remarques

Utilisez DataGridCheckBoxColumn pour afficher des colonnes de données booléennes sous la forme d’un CheckBox .Use DataGridCheckBoxColumn to display columns of Boolean data as a CheckBox. L’illustration suivante montre un exemple de DataGridCheckBoxColumn .The following illustration shows an example of DataGridCheckBoxColumn.

Colonne DataGridCheckBoxA DataGridCheckBox column

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' CheckBox élément créé dans la colonne.The Binding property is applied to the CheckBox 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. Si vous le souhaitez, vous pouvez spécifier un Binding.Converter si votre source de données et votre cible sont des types différents.Optionally, you can specify a Binding.Converter if your data source and target are different types. 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).

Vous pouvez personnaliser le DataGridCheckBoxColumn en définissant des propriétés, telles que Width ,, Header IsThreeState et IsReadOnly .You can customize the DataGridCheckBoxColumn by setting properties, such as Width, Header, IsThreeState, 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.
DataGridTextColumn Utilisez pour afficher le texte.Use to display text.

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

DataGridCheckBoxColumn()

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

Champs

IsThreeStateProperty

Identifie la propriété de dépendance IsThreeState.Identifies the IsThreeState 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

Obtient la valeur par défaut de la propriété EditingElementStyle.Gets the default value of the EditingElementStyle property.

DefaultElementStyle

Obtient la valeur par défaut de la propriété ElementStyle.Gets 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)
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)
IsThreeState

Obtient ou définit une valeur qui indique si les contrôles CheckBox hébergés autorisent deux ou trois états.Gets or sets a value that indicates whether the hosted CheckBox controls enable three states or two.

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)

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 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 CheckBox lié à la valeur de propriété Binding de la colonne.Gets a CheckBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Obtient un contrôle CheckBox en lecture seule lié à la valeur de propriété Binding de la colonne.Gets a read-only CheckBox 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 à

Voir aussi