GridView Klasse

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Anzeigemodus dar, der Datenelemente in Spalten für ein ListView-Steuerelement anzeigt.

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

Vererbung: Object

DispatcherObject

DependencyObject

ViewBase
GridView

Attribute: ContentPropertyAttribute StyleTypedPropertyAttribute

Implementiert: IAddChild

Beispiele

Das folgende Beispiel zeigt, wie sie ein ListView -Steuerelement definieren, das eine GridView als implementiert 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>

Hinweise

Die GridView -Klasse und ihre unterstützenden Klassen stellen die Infrastruktur zum Anzeigen von Datenelementen bereit, die für ein ListView Steuerelement in einer Reihe von Spalten angegeben sind. Die Spalten verfügen über Spaltenüberschriften, bei denen es sich um Schaltflächen handelt, die von ButtonBaseabgeleitet werden, und Sie können die Spalten mithilfe von Drag-and-Drop-Vorgängen neu anordnen. Beachten Sie, dass die Spalten einer GridView Anzeigedaten keinen direkten Zugriff auf die Quelle der Daten bieten.

Um einen GridView als Ansichtsmodus für anzugeben ListView, legen Sie die View -Eigenschaft auf ein -Objekt fest GridView .

Die GridView -Klasse wird von ViewBaseabgeleitet. Sie können benutzerdefinierte Ansichten definieren, indem Sie von der ViewBase -Klasse erben, die die unterstützenden Elemente für eine Ansicht bereitstellt. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen eines benutzerdefinierten Ansichtsmodus für eine ListView.

Die folgende Abbildung zeigt ein Beispiel für ein ListView , das eine GridViewverwendet.

ListView mit GridView-Ausgabe

Die Spalten in einem GridView werden als GridViewColumn -Objekte definiert. In Extensible Application Markup Language (XAML) können Sie Objekte als untergeordnete Elemente von GridViewdefinierenGridViewColumn. Im Code können Sie mithilfe der -Eigenschaft und der Add Columns -Methode, die GridView für die Collection<T> -Klasse definiert ist, eine GridViewColumn hinzufügen. Ebenso können Sie andere Collection<T> Methoden wie Remove und Insert verwenden, um die Spalten in einem GridViewzu ändern.

Im folgenden Beispiel wird gezeigt, wie die Spalten eines GridViewdefiniert werden.


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>

Um die Zeilen in einem GridViewzu formatieren, definieren Sie einen Stil für die ListViewItem -Steuerelemente im ListView.

Verwenden Sie Vorlagen oder Stile, um visuelle Elemente, z. B. ein CheckBox - oder Button -Steuerelement, zu einem GridViewhinzuzufügen. Ein Beispiel finden Sie unter How to: Create ListViewItems with a CheckBox.

Konstruktoren

GridView()

Initialisiert eine neue Instanz der GridView-Klasse.

Felder

AllowsColumnReorderProperty	Bezeichnet die AllowsColumnReorder-Abhängigkeitseigenschaft.
ColumnCollectionProperty	Bezeichnet die angefügte ColumnCollectionProperty-Eigenschaft.
ColumnHeaderContainerStyleProperty	Bezeichnet die ColumnHeaderContainerStyle-Abhängigkeitseigenschaft.
ColumnHeaderContextMenuProperty	Bezeichnet die ColumnHeaderContextMenu-Abhängigkeitseigenschaft.
ColumnHeaderStringFormatProperty	Bezeichnet die ColumnHeaderStringFormat-Abhängigkeitseigenschaft.
ColumnHeaderTemplateProperty	Bezeichnet die ColumnHeaderTemplate-Abhängigkeitseigenschaft.
ColumnHeaderTemplateSelectorProperty	Bezeichnet die ColumnHeaderTemplateSelector-Abhängigkeitseigenschaft.
ColumnHeaderToolTipProperty	Bezeichnet die ColumnHeaderToolTip-Abhängigkeitseigenschaft.

Eigenschaften

AllowsColumnReorder	Dient zum Abrufen oder Festlegen, ob Spalten in einem GridView durch einen Drag & Drop-Vorgang neu angeordnet werden können.
ColumnHeaderContainerStyle	Ruft die Formatvorlage ab, die auf Spaltenköpfe angewendet werden soll, oder legt diese fest.
ColumnHeaderContextMenu	Ruft ein ContextMenu für die GridView ab oder legt dieses fest.
ColumnHeaderStringFormat	Ruft eine kombinierte Zeichenfolge ab, die angibt, wie die Spaltenköpfe der GridView formatiert werden sollen, wenn diese als Zeichenfolgen angezeigt werden, oder legt diese Zeichenfolge fest.
ColumnHeaderTemplate	Ruft eine Vorlage für die Anzeige der Spaltenköpfe ab oder legt diese fest.
ColumnHeaderTemplateSelector	Ruft das Auswahlobjekt ab, das die Logik für die Auswahl der Vorlage bereitstellt, die für jede Spaltenüberschrift verwendet wird, oder legt dieses Objekt fest.
ColumnHeaderToolTip	Ruft den Inhalt einer QuickInfo ab, die angezeigt wird, wenn der Mauszeiger über einer der Spaltenüberschriften positioniert wird, oder legt den Inhalt fest.
Columns	Ruft die Auflistung von GridViewColumn-Objekten ab, die für diese GridView definiert sind.
DefaultStyleKey	Ruft den Verweis auf den Standardstil der GridView ab.
DependencyObjectType	Ruft den ab, der DependencyObjectType den CLR-Typ dieses instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
GridViewItemContainerStyleKey	Ruft den Schlüssel ab, der auf den Stil verweist, der für jedes ListViewItem in einer GridView definiert ist.
GridViewScrollViewerStyleKey	Ruft den Schlüssel ab, der auf den Stil verweist, der für das ScrollViewer-Steuerelement definiert ist, das den in einer GridView angezeigten Inhalt einschließt.
GridViewStyleKey	Ruft den Schlüssel ab, der auf den Stil verweist, der für das GridView definiert ist.
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
ItemContainerDefaultStyleKey	Ruft einen Verweis auf den Standardstil des Containers der Datenelemente in der GridView ab.

Angefügte Eigenschaften

ColumnCollection

Ruft die angefügte Eigenschaft ab, die die GridViewColumnCollection enthält, oder legt diese fest.

Methoden

AddChild(Object)	Fügt ein GridViewColumn-Objekt zu einer GridView hinzu.
AddText(String)	Wird nicht unterstützt.
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearItem(ListViewItem)	Entfernt alle Einstellungen, Bindungen und Formatierungen von einem ListViewItem.
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
GetAutomationPeer(ListView)	Ruft die AutomationPeer-Implementierung für dieses GridView-Objekt ab.
GetColumnCollection(DependencyObject)	Ruft den Inhalt der angefügten ColumnCollection-Eigenschaft ab.
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
PrepareItem(ListViewItem)	Bereitet ein ListViewItem-Steuerelement für die Anzeige gemäß der Definition des angegebenen GridView-Objekts vor.
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)	Legt den Inhalt der angefügten ColumnCollection-Eigenschaft fest.
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)	Bestimmt, ob die angefügte ColumnCollection-Eigenschaft serialisiert werden soll.
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt die Zeichenfolgendarstellung des GridView-Objekts zurück.
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)	Fügt ein untergeordnetes Objekt hinzu.
IAddChild.AddText(String)	Fügt dem Objekt den Textinhalt eines Knotens hinzu.

Gilt für: