DataGridComboBoxColumn Classe

Définition

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

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

Exemples

L’exemple suivant montre comment remplir la liste déroulante pour chaque ComboBox dans la colonne avec les valeurs d’une énumération.The following example shows how to populate the drop-down list for each ComboBox in the column with the values of an enumeration. L’élément sélectionné dans la liste déroulante est lié en affectant SelectedItemBinding à la propriété la propriété de l’objet affiché dans chaque ligne.The selected item in the drop-down list is bound by setting the SelectedItemBinding property to the property of the object displayed in each row.

<NavigationWindow x:Class="DataGrid_CustomColumns.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:core="clr-namespace:System;assembly=mscorlib"
    xmlns:local="clr-namespace:DataGrid_CustomColumns"
    Title="Customers" Height="300" Width="300" ShowsNavigationUI="False"  >
    
<NavigationWindow.Resources>
    <!--Create list of enumeration values-->
    <ObjectDataProvider x:Key="myEnum" MethodName="GetValues" ObjectType="{x:Type core:Enum}">
        <ObjectDataProvider.MethodParameters>
            <x:Type Type="local:OrderStatus"/>
        </ObjectDataProvider.MethodParameters>
    </ObjectDataProvider>
    <!--Create an instance of the converter for Email-->
    <local:EmailConverter x:Key="EmailConverter" />
</NavigationWindow.Resources>
<NavigationWindow.Content>  
    
<Grid>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
                <DataGridComboBoxColumn Header="Order Status"  SelectedItemBinding="{Binding Status}" ItemsSource="{Binding Source={StaticResource myEnum}}" />
            </DataGrid.Columns>
        </DataGrid>
    </Grid>
    </NavigationWindow.Content>
</NavigationWindow>
public partial class Window1 : NavigationWindow
{
Class Window1
public Window1()
{
    InitializeComponent();

    //GetData() creates a collection of Customer data from a database
    ObservableCollection<Customer> custdata = GetData();
    
    //Bind the DataGrid to the customer data
    DG1.DataContext = custdata;
}
Public Sub New()
    ' This call is required by the Windows Form Designer.
    InitializeComponent()
    ' Add any initialization after the InitializeComponent() call.

    'GetData() creates a collection of Customer data from a database
    Dim custdata As ObservableCollection(Of Customer) = GetData()

    'Bind the DataGrid to the customer data
    DG1.DataContext = custdata

End Sub
//Defines the customer object
public class Customer
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public Uri Email { get; set; }
    public bool IsMember { get; set; }
    public OrderStatus Status { get; set; }
}
'Defines the customer object
Public Class Customer
    Public Property FirstName() As String
    Public Property LastName() As String
    Public Property Email() As Uri
    Public Property IsMember() As Boolean
    Public Property Status() As OrderStatus
End Class
public enum OrderStatus { None, New, Processing, Shipped, Received };
Public Enum OrderStatus
    None
    [New]
    Processing
    Shipped
    Received
End Enum

Remarques

Utilisez DataGridComboBoxColumn pour afficher les données à partir desquelles un ensemble d’éléments doit être choisi, par exemple une énumération.Use DataGridComboBoxColumn to display data where there is a set of items to choose from, such as an enumeration. DataGridComboBoxColumn permet aux utilisateurs de sélectionner un élément dans une liste déroulante.DataGridComboBoxColumn allows users to select an item from a drop-down list. L’illustration suivante montre un DataGridComboBoxColumn .The following illustration shows a DataGridComboBoxColumn.

DataGridComboBoxColumnA DataGridComboBoxColumn

Pour remplir la liste déroulante, définissez d’abord la ItemsSource propriété du ComboBox en utilisant l’une des options suivantes :To populate the drop-down list, first set the ItemsSource property for the ComboBox by using one of the following options:

Une fois le ItemsSource défini, liez l’élément sélectionné dans le ComboBox à l’élément de données pour la ligne dans laquelle se trouve la cellule.Once the ItemsSource is set, bind the selected item in the ComboBox to the data item for the row that the cell is in. Vous pouvez définir la liaison à l’aide de l’une des propriétés suivantes :You can set the binding by using one of the following properties:

PropriétéProperty DescriptionDescription
TextBinding Définit le chemin d’accès de liaison du texte pour l’élément actuellement sélectionné.Sets the binding path of the text for the currently selected item.
SelectedItemBinding Définit le chemin de liaison de l’objet actuellement sélectionné.Sets the binding path of the object that is currently selected.
SelectedValueBinding Définit le chemin d’accès de liaison à la valeur de l’élément sélectionné spécifié par la SelectedValuePath propriété.Sets the binding path to the value of the selected item specified by the SelectedValuePath property.

Lorsque la IsReadOnly propriété a la valeur true , les utilisateurs ne peuvent pas modifier la colonne et ils ne peuvent pas voir la liste déroulante.When the IsReadOnly property is set to true, users cannot edit the column and they will not be able to see the drop-down list.

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.
DataGridCheckBoxColumn Utilisez pour afficher des données booléennes.Use to display Boolean 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

DataGridComboBoxColumn()

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

Champs

DisplayMemberPathProperty

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

EditingElementStyleProperty

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

ElementStyleProperty

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

ItemsSourceProperty

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

SelectedValuePathProperty

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

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.

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

Obtient ou définit le chemin d'accès à une valeur sur l'objet source pour fournir la représentation visuelle de l'objet.Gets or sets a path to a value on the source object to provide the visual representation of the object.

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.

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.

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

Obtient ou définit une collection qui est utilisée pour générer le contenu du contrôle zone de liste déroulante.Gets or sets a collection that is used to generate the content of the combo box control.

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

Obtient ou définit la liaison pour l'objet actuellement sélectionné.Gets or sets the binding for the currently selected item.

SelectedValueBinding

Obtient ou définit la valeur de l'élément sélectionné qui a été elle-même obtenue au moyen de la propriété SelectedValuePath.Gets or sets the value of the selected item, obtained by using SelectedValuePath.

SelectedValuePath

Obtient ou définit le chemin d'accès utilisé pour obtenir le SelectedValue à partir du SelectedItem.Gets or sets the path that is used to get the SelectedValue from the SelectedItem.

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

Obtient ou définit la liaison correspondant au texte de la partie zone de texte du contrôle ComboBox.Gets or sets the binding for the text in the text box portion of the ComboBox control.

TextBlockComboBoxStyleKey

Obtient la clé de ressource du style à appliquer à une zone de liste déroulante en lecture seule.Gets the resource key for the style to apply to a read-only combo box.

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 editing 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 zone de liste déroulante qui est lié aux valeurs SelectedItemBinding, SelectedValueBinding et TextBinding de la colonne.Gets a combo box control that is bound to the column's SelectedItemBinding, SelectedValueBinding, and TextBinding values.

GenerateElement(DataGridCell, Object)

Obtient un contrôle zone de liste déroulante en lecture seule qui est lié aux valeurs SelectedItemBinding, SelectedValueBinding et TextBinding de la colonne.Gets a read-only combo box control that is bound to the column's SelectedItemBinding, SelectedValueBinding, and TextBinding values.

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)
OnCoerceIsReadOnly(Boolean)

Détermine la valeur de la propriété IsReadOnly en fonction des règles de propriété du DataGrid que contient cette colonne.Determines the value of the IsReadOnly property based on property rules from the DataGrid that contains this column.

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)
OnSelectedItemBindingChanged(BindingBase, BindingBase)

Informe le DataGrid lorsque la propriété SelectedItemBinding change.Notifies the DataGrid when the SelectedItemBinding property changes.

OnSelectedValueBindingChanged(BindingBase, BindingBase)

Informe le DataGrid lorsque la propriété SelectedValueBinding change.Notifies the DataGrid when the SelectedValueBinding property changes.

OnTextBindingChanged(BindingBase, BindingBase)

Informe le DataGrid lorsque la propriété TextBinding change.Notifies the DataGrid when the TextBinding property changes.

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 à une modification de liaison.Refreshes the contents of a cell in the column in response to a binding 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 à