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 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
- 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 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.
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. |