GridView Classe

Référence

Définition

Espace de noms:: System.Windows.Controls

Assembly:: PresentationFramework.dll

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 des colonnes pour un contrôle ListView.

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 IAddChild

Public Class GridView
Inherits ViewBase
Implements IAddChild

Héritage: Object

DispatcherObject

DependencyObject

ViewBase
GridView

Attributs: ContentPropertyAttribute StyleTypedPropertyAttribute

Implémente: IAddChild

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 permettant d’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’un GridView affichage des données et ne fournissent pas d’accès direct à la source des données.

Pour spécifier un GridView comme 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 Guide pratique pour créer un mode d’affichage personnalisé pour un contrôle ListView.

L’illustration suivante montre un exemple de ListView qui utilise un GridView.

ListView avec sortie GridView

Les colonnes d’un 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 .GridView Dans le code, vous pouvez ajouter un GridViewColumn à à l’aide de GridView la Columns propriété et de la Add méthode qui est 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 dans 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 appliquer un style aux lignes d’un GridView, définissez un style pour les ListViewItem contrôles dans .ListView

Pour ajouter des éléments visuels, tels qu’un CheckBox contrôle ou Button , utilisez des GridViewmodèles ou des styles. Pour obtenir un exemple, consultez How to: Create ListViewItems with a CheckBox.

Constructeurs

GridView()

Initialise une nouvelle instance de la classe GridView.

Champs

AllowsColumnReorderProperty	Identifie la propriété de dépendance AllowsColumnReorder.
ColumnCollectionProperty	Identifie la propriété jointe ColumnCollectionProperty.
ColumnHeaderContainerStyleProperty	Identifie la propriété de dépendance ColumnHeaderContainerStyle.
ColumnHeaderContextMenuProperty	Identifie la propriété de dépendance ColumnHeaderContextMenu.
ColumnHeaderStringFormatProperty	Identifie la propriété de dépendance ColumnHeaderStringFormat.
ColumnHeaderTemplateProperty	Identifie la propriété de dépendance ColumnHeaderTemplate.
ColumnHeaderTemplateSelectorProperty	Identifie la propriété de dépendance ColumnHeaderTemplateSelector.
ColumnHeaderToolTipProperty	Identifie la propriété de dépendance ColumnHeaderToolTip.

Propriétés

AllowsColumnReorder	Obtient ou définit si les colonnes d'un 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 la manière de mettre en forme les en-têtes de colonnes de GridView s'ils sont affichés en tant que chaînes.
ColumnHeaderTemplate	Obtient ou définit un modèle à utiliser pour afficher les en-têtes de colonnes.
ColumnHeaderTemplateSelector	Obtient ou définit l'objet de sélecteur qui fournit la logique pour 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 apparaît lorsque le pointeur de la souris s'arrête sur l'un des en-têtes de colonnes.
Columns	Obtient la collection d'objets GridViewColumn définie pour ce GridView.
DefaultStyleKey	Obtient la référence pour le style par défaut du GridView.
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
GridViewItemContainerStyleKey	Obtient la clé qui référence le style défini pour chaque ListViewItem dans un GridView.
GridViewScrollViewerStyleKey	Obtient la clé qui référence le style défini pour le contrôle ScrollViewer qui comprend le contenu affiché par un GridView.
GridViewStyleKey	Obtient la clé qui référence le style défini pour le GridView.
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
ItemContainerDefaultStyleKey	Obtient la référence au style par défaut du conteneur des éléments de données dans le GridView.

Propriétés attachées

ColumnCollection

Obtient ou définit la propriété jointe qui contient le GridViewColumnCollection.

Méthodes

AddChild(Object)	Ajoute un objet GridViewColumn à un objet GridView
AddText(String)	Non pris en charge.
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearItem(ListViewItem)	Supprime tous les paramètres, toutes les liaisons et tous les styles d'un ListViewItem.
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 DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. 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. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
GetAutomationPeer(ListView)	Obtient l'implémentation AutomationPeer pour cet objet GridView.
GetColumnCollection(DependencyObject)	Obtient le contenu de la propriété jointe ColumnCollection.
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 le 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)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
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. 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 à l'affichage d'après la définition de cet objet GridView.
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)	Définit le contenu de la propriété jointe ColumnCollection.
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur 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. (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 propriété jointe ColumnCollection.
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 représentation sous forme de chaîne de l'objet GridView.
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)	Ajoute un objet enfant.
IAddChild.AddText(String)	Ajoute le contenu textuel d’un nœud à l’objet.

S’applique à