GridView Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un mode d’affichage qui affiche les éléments de données dans les colonnes d’un ListView contrôle.
public ref class GridView : System::Windows::Controls::ViewBase, System::Windows::Markup::IAddChild[System.Windows.Markup.ContentProperty("Columns")]
[System.Windows.StyleTypedProperty(Property="ColumnHeaderContainerStyle", StyleTargetType=typeof(System.Windows.Controls.GridViewColumnHeader))]
public class GridView : System.Windows.Controls.ViewBase, System.Windows.Markup.IAddChild[<System.Windows.Markup.ContentProperty("Columns")>]
[<System.Windows.StyleTypedProperty(Property="ColumnHeaderContainerStyle", StyleTargetType=typeof(System.Windows.Controls.GridViewColumnHeader))>]
type GridView = class
inherit ViewBase
interface IAddChildPublic Class GridView
Inherits ViewBase
Implements IAddChild- Héritage
- Attributs
- Implémente
Exemples
L’exemple suivant montre comment définir un ListView contrôle qui implémente un GridView comme son View.
<ListView ItemsSource="{Binding Source={StaticResource EmployeeData},
XPath=Employee}">
<ListView.View>
<GridView>
<GridViewColumn Header="First Name"
DisplayMemberBinding="{Binding XPath=FirstName}" />
<GridViewColumn Header="Last Name"
DisplayMemberBinding="{Binding XPath=LastName}" />
<GridViewColumn Header="Favorite City"
DisplayMemberBinding="{Binding XPath=FavoriteCity}"/>
</GridView>
</ListView.View>
</ListView>
Remarques
La GridView classe et ses classes de prise en charge fournissent l’infrastructure pour afficher les éléments de données spécifiés pour un ListView contrôle dans une série de colonnes. Les colonnes ont des en-têtes de colonne, qui sont des boutons dérivés de ButtonBase, et vous pouvez réorganiser les colonnes à l’aide d’opérations de glisser-déplacer. Notez que les colonnes d’une GridView donnée d’affichage et ne fournissent pas d’accès direct à la source des données.
Pour spécifier un GridView mode d’affichage pour un ListView, définissez la View propriété sur un GridView objet.
La GridView classe est dérivée de ViewBase. Vous pouvez définir des vues personnalisées en hériter de la ViewBase classe qui fournit les éléments de prise en charge d’une vue. Pour plus d’informations, consultez How to : Create a Custom View Mode for a ListView.
L’illustration suivante montre un exemple d’un ListView qui utilise un GridView.
Les colonnes d’un objet GridView sont définies en tant qu’objets GridViewColumn . Dans XAML (Extensible Application Markup Language), vous pouvez définir des GridViewColumn objets en tant qu’éléments enfants de l’objet GridView. Dans le code, vous pouvez ajouter un GridViewColumn à l’aide GridView de la propriété et de la AddColumns méthode définie pour la Collection<T> classe. De même, vous pouvez utiliser d’autres Collection<T> méthodes telles que Remove et Insert pour modifier les colonnes d’un GridView.
L’exemple suivant montre comment définir les colonnes d’un GridView.
GridView myGridView = new GridView();
myGridView.AllowsColumnReorder = true;
myGridView.ColumnHeaderToolTip = "Employee Information";
GridViewColumn gvc1 = new GridViewColumn();
gvc1.DisplayMemberBinding = new Binding("FirstName");
gvc1.Header = "FirstName";
gvc1.Width = 100;
myGridView.Columns.Add(gvc1);
GridViewColumn gvc2 = new GridViewColumn();
gvc2.DisplayMemberBinding = new Binding("LastName");
gvc2.Header = "Last Name";
gvc2.Width = 100;
myGridView.Columns.Add(gvc2);
GridViewColumn gvc3 = new GridViewColumn();
gvc3.DisplayMemberBinding = new Binding("EmployeeNumber");
gvc3.Header = "Employee No.";
gvc3.Width = 100;
myGridView.Columns.Add(gvc3);
Dim myGridView As New GridView()
myGridView.AllowsColumnReorder = True
myGridView.ColumnHeaderToolTip = "Employee Information"
Dim gvc1 As New GridViewColumn()
gvc1.DisplayMemberBinding = New Binding("FirstName")
gvc1.Header = "FirstName"
gvc1.Width = 100
myGridView.Columns.Add(gvc1)
Dim gvc2 As New GridViewColumn()
gvc2.DisplayMemberBinding = New Binding("LastName")
gvc2.Header = "Last Name"
gvc2.Width = 100
myGridView.Columns.Add(gvc2)
Dim gvc3 As New GridViewColumn()
gvc3.DisplayMemberBinding = New Binding("EmployeeNumber")
gvc3.Header = "Employee No."
gvc3.Width = 100
myGridView.Columns.Add(gvc3)
<GridView AllowsColumnReorder="true"
ColumnHeaderToolTip="Employee Information">
<GridViewColumn DisplayMemberBinding=
"{Binding Path=FirstName}"
Header="First Name" Width="100"/>
<GridViewColumn DisplayMemberBinding=
"{Binding Path=LastName}"
Width="100">
<GridViewColumnHeader>Last Name
<GridViewColumnHeader.ContextMenu>
<ContextMenu MenuItem.Click="LastNameCM_Click"
Name="LastNameCM">
<MenuItem Header="Ascending" />
<MenuItem Header="Descending" />
</ContextMenu>
</GridViewColumnHeader.ContextMenu>
</GridViewColumnHeader>
</GridViewColumn>
<GridViewColumn DisplayMemberBinding=
"{Binding Path=EmployeeNumber}"
Header="Employee No." Width="100"/>
</GridView>
Pour styler les lignes d’un GridView, définissez un style pour les ListViewItem contrôles dans le ListView.
Pour ajouter des éléments visuels, tels qu’un ou Button un CheckBox contrôle, à un GridView, utilisez des modèles ou des styles. Pour obtenir un exemple, consultez How to : Create ListViewItems with a CheckBox.
Constructeurs
| Nom | Description |
|---|---|
| GridView() |
Initialise une nouvelle instance de la classe GridView. |
Champs
| Nom | Description |
|---|---|
| AllowsColumnReorderProperty |
Identifie la AllowsColumnReorder propriété de dépendance. |
| ColumnCollectionProperty |
Identifie la ColumnCollectionProperty propriété jointe. |
| ColumnHeaderContainerStyleProperty |
Identifie la ColumnHeaderContainerStyle propriété de dépendance. |
| ColumnHeaderContextMenuProperty |
Identifie la ColumnHeaderContextMenu propriété de dépendance. |
| ColumnHeaderStringFormatProperty |
Identifie la ColumnHeaderStringFormat propriété de dépendance. |
| ColumnHeaderTemplateProperty |
Identifie la ColumnHeaderTemplate propriété de dépendance. |
| ColumnHeaderTemplateSelectorProperty |
Identifie la ColumnHeaderTemplateSelector propriété de dépendance. |
| ColumnHeaderToolTipProperty |
Identifie la ColumnHeaderToolTip propriété de dépendance. |
Propriétés
| Nom | Description |
|---|---|
| AllowsColumnReorder |
Obtient ou définit si les colonnes d’un objet GridView peuvent être réorganisées par une opération de glisser-déplacer. |
| ColumnHeaderContainerStyle |
Obtient ou définit le style à appliquer aux en-têtes de colonne. |
| ColumnHeaderContextMenu |
Obtient ou définit un ContextMenu pour le GridView. |
| ColumnHeaderStringFormat |
Obtient ou définit une chaîne composite qui spécifie comment mettre en forme les en-têtes de colonne du GridView si elles sont affichées sous forme de chaînes. |
| ColumnHeaderTemplate |
Obtient ou définit un modèle à utiliser pour afficher les en-têtes de colonne. |
| ColumnHeaderTemplateSelector |
Obtient ou définit l’objet sélecteur qui fournit une logique permettant de sélectionner un modèle à utiliser pour chaque en-tête de colonne. |
| ColumnHeaderToolTip |
Obtient ou définit le contenu d’une info-bulle qui s’affiche lorsque le pointeur de la souris s’interrompt sur l’un des en-têtes de colonne. |
| Columns |
Obtient la collection d’objets GridViewColumn qui est définie pour ce GridView. |
| DefaultStyleKey |
Obtient la référence pour le style par défaut pour le GridView. |
| 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) |
| GridViewItemContainerStyleKey |
Obtient la clé qui fait référence au style défini pour chacun d’eux ListViewItem dans un GridView. |
| GridViewScrollViewerStyleKey |
Obtient la clé qui fait référence au style défini pour le ScrollViewer contrôle qui entoure le contenu affiché par un GridView. |
| GridViewStyleKey |
Obtient la clé qui fait référence au style défini pour le GridView. |
| IsSealed |
Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject) |
| ItemContainerDefaultStyleKey |
Obtient la référence au style par défaut pour le conteneur des éléments de données dans le GridView. |
Propriétés attachées
| Nom | Description |
|---|---|
| ColumnCollection |
Obtient ou définit la propriété jointe qui contient le GridViewColumnCollection. |
Méthodes
| Nom | Description |
|---|---|
| AddChild(Object) |
Ajoute un GridViewColumn objet à un GridView. |
| AddText(String) |
Non pris en charge. |
| CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
| ClearItem(ListViewItem) |
Supprime tous les paramètres, liaisons et styles d’un ListViewItem. |
| 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) |
| Equals(Object) |
Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject) |
| GetAutomationPeer(ListView) |
Obtient l’implémentation AutomationPeer de cet GridView objet. |
| GetColumnCollection(DependencyObject) |
Obtient le contenu de la ColumnCollection propriété jointe. |
| 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) |
| 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) |
| 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) |
| PrepareItem(ListViewItem) |
Prépare un ListViewItem affichage en fonction de la définition de cet GridView objet. |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject) |
| SetColumnCollection(DependencyObject, GridViewColumnCollection) |
Définit le contenu de la ColumnCollection propriété jointe. |
| 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) |
| ShouldSerializeColumnCollection(DependencyObject) |
Détermine s’il faut sérialiser la ColumnCollection propriété jointe. |
| 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 la représentation sous forme de chaîne de l’objet GridView . |
| VerifyAccess() |
Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAddChild.AddChild(Object) |
Ajoute un objet enfant. |
| IAddChild.AddText(String) |
Ajoute le contenu texte d’un nœud à l’objet. |
