GridView Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una modalità di visualizzazione che visualizza gli elementi di dati nelle colonne per un ListView controllo .
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
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio seguente viene illustrato come definire un ListView controllo che implementa come GridViewView.
<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>
Commenti
La GridView classe e le relative classi di supporto forniscono l'infrastruttura per visualizzare gli elementi di dati specificati per un ListView controllo in una serie di colonne. Le colonne hanno intestazioni di colonna, ovvero pulsanti derivati da ButtonBaseed è possibile riordinare le colonne usando operazioni di trascinamento della selezione. Si noti che le colonne di dati GridView di visualizzazione e non forniscono l'accesso diretto all'origine dei dati.
Per specificare un oggetto GridView come modalità di visualizzazione per un ListViewoggetto , impostare la View proprietà su un GridView oggetto .
La GridView classe è derivata da ViewBase. È possibile definire visualizzazioni personalizzate ereditando dalla ViewBase classe che fornisce gli elementi di supporto per una visualizzazione. Per altre informazioni, vedere Procedura: Creare una modalità di visualizzazione personalizzata per un controllo ListView.
Nella figura seguente viene illustrato un esempio di oggetto ListView che usa un oggetto GridView.
Le colonne di un GridView oggetto sono definite come GridViewColumn oggetti . In Extensible Application Markup Language (XAML) puoi definire GridViewColumn oggetti come elementi figlio di GridView. Nel codice è possibile aggiungere un oggetto GridViewColumn a GridView usando la Columns proprietà e il Add metodo definito per la Collection<T> classe . Analogamente, è possibile usare altri Collection<T> metodi, Remove ad esempio e Insert per modificare le colonne in un oggetto GridView.
Nell'esempio seguente viene illustrato come definire le colonne di un oggetto 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>
Per applicare uno stile alle righe di un GridViewoggetto , definire uno stile per i ListViewItem controlli in ListView.
Per aggiungere elementi visivi, ad esempio un CheckBox controllo o Button , a un GridViewoggetto , usare modelli o stili. Per un esempio, vedere Procedura: Creare ListViewItems con un controllo CheckBox.
Costruttori
| Nome | Descrizione |
|---|---|
| GridView() |
Inizializza una nuova istanza della classe GridView. |
Campi
| Nome | Descrizione |
|---|---|
| AllowsColumnReorderProperty |
Identifica la AllowsColumnReorder proprietà di dipendenza. |
| ColumnCollectionProperty |
Identifica la ColumnCollectionProperty proprietà associata. |
| ColumnHeaderContainerStyleProperty |
Identifica la ColumnHeaderContainerStyle proprietà di dipendenza. |
| ColumnHeaderContextMenuProperty |
Identifica la ColumnHeaderContextMenu proprietà di dipendenza. |
| ColumnHeaderStringFormatProperty |
Identifica la ColumnHeaderStringFormat proprietà di dipendenza. |
| ColumnHeaderTemplateProperty |
Identifica la ColumnHeaderTemplate proprietà di dipendenza. |
| ColumnHeaderTemplateSelectorProperty |
Identifica la ColumnHeaderTemplateSelector proprietà di dipendenza. |
| ColumnHeaderToolTipProperty |
Identifica la ColumnHeaderToolTip proprietà di dipendenza. |
Proprietà
| Nome | Descrizione |
|---|---|
| AllowsColumnReorder |
Ottiene o imposta un valore che indica se le colonne in un GridView oggetto possono essere riordinate da un'operazione di trascinamento della selezione. |
| ColumnHeaderContainerStyle |
Ottiene o imposta lo stile da applicare alle intestazioni di colonna. |
| ColumnHeaderContextMenu |
Ottiene o imposta un oggetto ContextMenu per l'oggetto GridView. |
| ColumnHeaderStringFormat |
Ottiene o imposta una stringa composita che specifica come formattare le intestazioni di colonna di GridView se vengono visualizzate come stringhe. |
| ColumnHeaderTemplate |
Ottiene o imposta un modello da utilizzare per visualizzare le intestazioni di colonna. |
| ColumnHeaderTemplateSelector |
Ottiene o imposta l'oggetto selettore che fornisce la logica per la selezione di un modello da utilizzare per ogni intestazione di colonna. |
| ColumnHeaderToolTip |
Ottiene o imposta il contenuto di una descrizione comando visualizzata quando il puntatore del mouse viene sospeso su una delle intestazioni di colonna. |
| Columns |
Ottiene la raccolta di GridViewColumn oggetti definiti per l'oggetto GridView. |
| DefaultStyleKey |
Ottiene il riferimento per lo stile predefinito per l'oggetto GridView. |
| DependencyObjectType |
Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject) |
| Dispatcher |
Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject) |
| GridViewItemContainerStyleKey |
Ottiene la chiave che fa riferimento allo stile definito per ognuno ListViewItem in un oggetto GridView. |
| GridViewScrollViewerStyleKey |
Ottiene la chiave che fa riferimento allo stile definito per il ScrollViewer controllo che racchiude il contenuto visualizzato da un oggetto GridView. |
| GridViewStyleKey |
Ottiene la chiave che fa riferimento allo stile definito per l'oggetto GridView. |
| IsSealed |
Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject) |
| ItemContainerDefaultStyleKey |
Ottiene il riferimento allo stile predefinito per il contenitore degli elementi di dati in GridView. |
Proprietà associate
| Nome | Descrizione |
|---|---|
| ColumnCollection |
Ottiene o imposta la proprietà associata che contiene l'oggetto GridViewColumnCollection. |
Metodi
| Nome | Descrizione |
|---|---|
| AddChild(Object) |
Aggiunge un GridViewColumn oggetto a un oggetto GridView. |
| AddText(String) |
Non supportato. |
| CheckAccess() |
Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
| ClearItem(ListViewItem) |
Rimuove tutte le impostazioni, le associazioni e lo stile da un oggetto ListViewItem. |
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject) |
| CoerceValue(DependencyProperty) |
Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject) |
| Equals(Object) |
Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject) |
| GetAutomationPeer(ListView) |
Ottiene l'implementazione AutomationPeer per questo GridView oggetto. |
| GetColumnCollection(DependencyObject) |
Ottiene il contenuto della ColumnCollection proprietà associata. |
| GetHashCode() |
Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject) |
| GetLocalValueEnumerator() |
Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject oggetto è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento. (Ereditato da DependencyObject) |
| PrepareItem(ListViewItem) |
Prepara un oggetto ListViewItem per la visualizzazione in base alla definizione di questo GridView oggetto. |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject) |
| SetColumnCollection(DependencyObject, GridViewColumnCollection) |
Imposta il contenuto della ColumnCollection proprietà associata. |
| SetCurrentValue(DependencyProperty, Object) |
Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject) |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject) |
| ShouldSerializeColumnCollection(DependencyObject) |
Determina se serializzare la ColumnCollection proprietà associata. |
| ShouldSerializeProperty(DependencyProperty) |
Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| ToString() |
Restituisce la rappresentazione di stringa dell'oggetto GridView . |
| VerifyAccess() |
Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IAddChild.AddChild(Object) |
Aggiunge un oggetto figlio. |
| IAddChild.AddText(String) |
Aggiunge il contenuto di testo di un nodo all'oggetto . |