GridView Classe

Definizione

Rappresenta una modalità di visualizzazione che mostra gli elementi di dati in colonne per un controllo ListView.Represents a view mode that displays data items in columns for a ListView control.

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
type GridView = class
    inherit ViewBase
    interface IAddChild
Public Class GridView
Inherits ViewBase
Implements IAddChild
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come definire un ListView controllo che implementa un GridView oggetto come View.The following example shows how to define a ListView control that implements a GridView as its 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>

Commenti

La GridView classe e le relative classi di supporto forniscono l'infrastruttura per visualizzare gli elementi di dati specificati ListView per un controllo in una serie di colonne.The GridView class and its supporting classes provide the infrastructure to display data items that are specified for a ListView control in a series of columns. Le colonne contengono intestazioni di colonna, ovvero pulsanti derivati da ButtonBase, ed è possibile riordinare le colonne tramite operazioni di trascinamento della selezione.The columns have column headers, which are buttons that are derived from ButtonBase, and you can reorder the columns by using drag-and-drop operations. Si noti che le colonne di GridView un dato di visualizzazione e non consentono l'accesso diretto all'origine dei dati.Note that the columns of a GridView display data and do not provide direct access to the source of the data.

Per specificare GridView come modalità di visualizzazione per un ListView, impostare la View proprietà su un GridView oggetto.To specify a GridView as the view mode for a ListView, set the View property to a GridView object.

La GridView classe è derivata da ViewBase.The GridView class is derived from ViewBase. È possibile definire visualizzazioni personalizzate ereditando dalla ViewBase classe che fornisce gli elementi di supporto per una visualizzazione.You can define custom views by inheriting from the ViewBase class that provides the supporting elements for a view. Per altre informazioni, vedere Procedura: Creare una modalità di visualizzazione personalizzata per uncontrollo ListView.For more information, see How to: Create a Custom View Mode for a ListView.

Nella figura seguente viene illustrato un esempio di ListView un oggetto che GridViewutilizza un oggetto.The following illustration shows an example of a ListView that uses a GridView.

![ListView con output GridView] (~/add/media/listviewgridview.JPG "ListView con output GridView")ListView with GridView output

Le colonne in un GridView oggetto sono definite GridViewColumn come oggetti.The columns in a GridView are defined as GridViewColumn objects. In Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)è possibile definire GridViewColumn gli oggetti GridViewcome elementi figlio di.In Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), you can define GridViewColumn objects as child elements of the GridView. Nel codice è possibile aggiungere un oggetto GridViewColumn GridView a utilizzando la Columns proprietà e il Add metodo definito per la Collection<T> classe.In code, you can add a GridViewColumn to the GridView by using the Columns property and the Add method that is defined for the Collection<T> class. Analogamente, è possibile usare Collection<T> altri metodi, Remove ad Insert esempio e, per modificare le GridViewcolonne in un oggetto.Similarly, you can use other Collection<T> methods such as Remove and Insert to modify the columns in a GridView.

Nell'esempio seguente viene illustrato come definire le colonne di un GridViewoggetto.The following example shows how to define the columns of a 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 GridViewdi un oggetto, definire uno ListViewItem stile per i ListViewcontrolli in.To style the rows in a GridView, define a style for the ListViewItem controls in the ListView.

Per aggiungere elementi visivi, ad esempio CheckBox un Button controllo o, a GridViewun oggetto, usare modelli o stili.To add visual elements, such as a CheckBox or Button control, to a GridView, use templates or styles. Per un esempio, vedere Procedura: Creare ListViewItems con una caselladi controllo.For an example, see How to: Create ListViewItems with a CheckBox.

Costruttori

GridView()

Inizializza una nuova istanza della classe GridView.Initializes a new instance of the GridView class.

Campi

AllowsColumnReorderProperty

Identifica la proprietà di dipendenza AllowsColumnReorder.Identifies the AllowsColumnReorder dependency property.

ColumnCollectionProperty

Identifica la proprietà associata ColumnCollectionProperty.Identifies the ColumnCollectionProperty attachedproperty.

ColumnHeaderContainerStyleProperty

Identifica la proprietà di dipendenza ColumnHeaderContainerStyle.Identifies the ColumnHeaderContainerStyle dependency property.

ColumnHeaderContextMenuProperty

Identifica la proprietà di dipendenza ColumnHeaderContextMenu.Identifies the ColumnHeaderContextMenu dependency property.

ColumnHeaderStringFormatProperty

Identifica la proprietà di dipendenza ColumnHeaderStringFormat.Identifies the ColumnHeaderStringFormat dependency property.

ColumnHeaderTemplateProperty

Identifica la proprietà di dipendenza ColumnHeaderTemplate.Identifies the ColumnHeaderTemplate dependency property.

ColumnHeaderTemplateSelectorProperty

Identifica la proprietà di dipendenza ColumnHeaderTemplateSelector.Identifies the ColumnHeaderTemplateSelector dependency property.

ColumnHeaderToolTipProperty

Identifica la proprietà di dipendenza ColumnHeaderToolTip.Identifies the ColumnHeaderToolTip dependency property.

Proprietà

AllowsColumnReorder

Ottiene o imposta un valore che indica se le colonne di un oggetto GridView possono essere riordinate mediante un'operazione di trascinamento della selezione.Gets or sets whether columns in a GridView can be reordered by a drag-and-drop operation.

ColumnHeaderContainerStyle

Ottiene o imposta lo stile da applicare alle intestazioni di colonna.Gets or sets the style to apply to column headers.

ColumnHeaderContextMenu

Ottiene o imposta un oggetto ContextMenu per l'oggetto GridView.Gets or sets a ContextMenu for the GridView.

ColumnHeaderStringFormat

Ottiene o imposta una stringa composita che specifica come formattare le intestazioni di colonna di GridView se visualizzate come stringhe.Gets or sets a composite string that specifies how to format the column headers of the GridView if they are displayed as strings.

ColumnHeaderTemplate

Ottiene o imposta un modello da utilizzare per visualizzare le intestazioni di colonna.Gets or sets a template to use to display the column headers.

ColumnHeaderTemplateSelector

Ottiene o imposta l'oggetto selettore che fornisce la logica per la selezione di un modello da utilizzare per ogni intestazione di colonna.Gets or sets the selector object that provides logic for selecting a template to use for each column header.

ColumnHeaderToolTip

Ottiene o imposta il contenuto di una descrizione comandi visualizzata quando si posiziona il puntatore del mouse su un'intestazione di colonna.Gets or sets the content of a tooltip that appears when the mouse pointer pauses over one of the column headers.

Columns

Ottiene l'insieme di oggetti GridViewColumn definito per questo oggetto GridView.Gets the collection of GridViewColumn objects that is defined for this GridView.

DefaultStyleKey

Ottiene il riferimento per lo stile predefinito dell'oggetto GridView.Gets the reference for the default style for the GridView.

DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Ereditato da DependencyObject)
Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Ereditato da DispatcherObject)
GridViewItemContainerStyleKey

Ottiene la chiave che fa riferimento allo stile definito per ogni ListViewItem di un oggetto GridView.Gets the key that references the style that is defined for each ListViewItem in a GridView.

GridViewScrollViewerStyleKey

Ottiene la chiave che fa riferimento allo stile definito per il controllo ScrollViewer che include il contenuto visualizzato da un oggetto GridView.Gets the key that references the style that is defined for the ScrollViewer control that encloses the content that is displayed by a GridView.

GridViewStyleKey

Ottiene la chiave che fa riferimento allo stile definito per l'oggetto GridView.Gets the key that references the style that is defined for the GridView.

IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Ereditato da DependencyObject)
ItemContainerDefaultStyleKey

Ottiene il riferimento allo stile predefinito per il contenitore degli elementi di dati in GridView.Gets the reference to the default style for the container of the data items in the GridView.

Proprietà associate

ColumnCollection

Ottiene o imposta la proprietà associata contenente l'oggetto GridViewColumnCollection.Gets or sets the attached property that contains the GridViewColumnCollection.

Metodi

AddChild(Object)

Aggiunge un oggetto GridViewColumn a un oggetto GridView.Adds a GridViewColumn object to a GridView.

AddText(String)

Non supportato.Not supported.

CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)
ClearItem(ListViewItem)

Rimuove tutte le impostazioni, le associazioni e gli elementi relativi allo stile da un ListViewItem.Removes all settings, bindings, and styling from a ListViewItem.

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Ereditato da DependencyObject)
CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Ereditato da DependencyObject)
Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Ereditato da DependencyObject)
GetAutomationPeer(ListView)

Ottiene l'implementazione AutomationPeer per questo oggetto GridView.Gets the AutomationPeer implementation for this GridView object.

GetColumnCollection(DependencyObject)

Ottiene il contenuto della proprietà associata ColumnCollection.Gets the contents of the ColumnCollection attached property.

GetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.Gets a hash code for this DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento.The specific dependency property that changed is reported in the event data.

(Ereditato da DependencyObject)
PrepareItem(ListViewItem)

Prepara un oggetto ListViewItem per la visualizzazione in base alla definizione di questo oggetto GridView.Prepares a ListViewItem for display according to the definition of this GridView object.

ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.Returns the local value of a dependency property, if it exists.

(Ereditato da DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)

Imposta il contenuto della proprietà associata ColumnCollection.Sets the contents of the ColumnCollection attached property.

SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.Sets the value of a dependency property without changing its value source.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Ereditato da DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)

Determina se serializzare la proprietà associata ColumnCollection.Determines whether to serialize the ColumnCollection attached property.

ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Ereditato da DependencyObject)
ToString()

Restituisce la rappresentazione di stringa dell'oggetto GridView.Returns the string representation of the GridView object.

VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)

Implementazioni dell'interfaccia esplicita

IAddChild.AddChild(Object)

Aggiunge un oggetto figlio.Adds a child object.

IAddChild.AddText(String)

Aggiunge il contenuto di testo di un nodo all'oggetto.Adds the text content of a node to the object.

Si applica a

Vedi anche