Freigeben über


GridView Klasse

Definition

Stellt einen Ansichtsmodus dar, in dem Datenelemente in Spalten für ein ListView Steuerelement angezeigt werden.

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
Attribute
Implementiert

Beispiele

Das folgende Beispiel zeigt, wie sie ein ListView Steuerelement definieren, das ein Steuerelement GridView als zugehörigen Viewimplementiert.

  <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 die 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, von denen Schaltflächen abgeleitet ButtonBasewerden, 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 Datenquelle bieten.

Wenn Sie einen GridView Als Ansichtsmodus für ein ListViewObjekt angeben möchten, legen Sie die View Eigenschaft auf ein GridView Objekt fest.

Die GridView Klasse wird von ViewBase. 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 How to: Create a Custom View Mode for a ListView.

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

ListView mit GridView-Ausgabe

Die Spalten in a GridView werden als GridViewColumn Objekte definiert. In Extensible Application Markup Language (XAML) können GridViewColumn Sie Objekte als untergeordnete Elemente der .GridView Im Code können Sie der ColumnsGridView Eigenschaft und der methode, die Add für die Collection<T> Klasse definiert ist, einen GridViewColumn hinzufügen. Ebenso können Sie andere Collection<T> Methoden wie Remove z. B. und Insert zum Ändern der Spalten in einer .GridView

Das folgende Beispiel zeigt, wie die Spalten einer .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>

Um die Zeilen in einem GridViewFormat zu formatieren, definieren Sie eine Formatvorlage für die ListViewItem Steuerelemente in der ListView.

Wenn Sie einem Steuerelement visuelle Elemente hinzufügen möchten, z. B. ein CheckBoxButtonGridViewSteuerelement, verwenden Sie Vorlagen oder Formatvorlagen. Ein Beispiel finden Sie unter How to: Create ListViewItems with a CheckBox.

Konstruktoren

Name Beschreibung
GridView()

Initialisiert eine neue Instanz der GridView-Klasse.

Felder

Name Beschreibung
AllowsColumnReorderProperty

Identifies the AllowsColumnReorder dependency property.

ColumnCollectionProperty

Identifies the ColumnCollectionProperty attachedproperty.

ColumnHeaderContainerStyleProperty

Identifies the ColumnHeaderContainerStyle dependency property.

ColumnHeaderContextMenuProperty

Identifies the ColumnHeaderContextMenu dependency property.

ColumnHeaderStringFormatProperty

Identifies the ColumnHeaderStringFormat dependency property.

ColumnHeaderTemplateProperty

Identifies the ColumnHeaderTemplate dependency property.

ColumnHeaderTemplateSelectorProperty

Identifies the ColumnHeaderTemplateSelector dependency property.

ColumnHeaderToolTipProperty

Identifies the ColumnHeaderToolTip dependency property.

Eigenschaften

Name Beschreibung
AllowsColumnReorder

Ruft ab oder legt fest, ob Spalten in einer GridView durch einen Drag-and-Drop-Vorgang neu angeordnet werden können.

ColumnHeaderContainerStyle

Ruft die Formatvorlage ab, die auf Spaltenüberschriften angewendet werden soll, oder legt diese fest.

ColumnHeaderContextMenu

Ruft ab oder legt einen ContextMenu für die GridView.

ColumnHeaderStringFormat

Dient zum Abrufen oder Festlegen einer zusammengesetzten Zeichenfolge, die angibt, wie die Spaltenüberschriften der GridView als Zeichenfolgen angezeigt werden.

ColumnHeaderTemplate

Dient zum Abrufen oder Festlegen einer Vorlage, die zum Anzeigen der Spaltenüberschriften verwendet werden soll.

ColumnHeaderTemplateSelector

Dient zum Abrufen oder Festlegen des Selektorobjekts, das Logik zum Auswählen einer Vorlage für jede Spaltenüberschrift bereitstellt.

ColumnHeaderToolTip

Dient zum Abrufen oder Festlegen des Inhalts einer QuickInfo, die angezeigt wird, wenn der Mauszeiger über einer der Spaltenüberschriften angehalten wird.

Columns

Ruft die Auflistung von GridViewColumn Objekten ab, die für dieses GridViewObjekt definiert sind.

DefaultStyleKey

Ruft den Verweis für die Standardformatvorlage für die GridView.

DependencyObjectType

Ruft den DependencyObjectType CLR-Typ dieser Instanz ab.

(Geerbt von DependencyObject)
Dispatcher

Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
GridViewItemContainerStyleKey

Ruft den Schlüssel ab, der auf die Formatvorlage verweist, die für jede ListViewItem in einer GridView.

GridViewScrollViewerStyleKey

Ruft den Schlüssel ab, der auf die Formatvorlage verweist, die für das ScrollViewer Steuerelement definiert ist, das den Inhalt einschließt, der von einem GridViewangezeigt wird.

GridViewStyleKey

Ruft den Schlüssel ab, der auf die Formatvorlage verweist, die für die GridView.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt).

(Geerbt von DependencyObject)
ItemContainerDefaultStyleKey

Ruft den Verweis auf die Standardformatvorlage für den Container der Datenelemente in der GridView.

Angefügte Eigenschaften

Name Beschreibung
ColumnCollection

Dient zum Abrufen oder Festlegen der angefügten Eigenschaft, die die GridViewColumnCollection.

Methoden

Name Beschreibung
AddChild(Object)

Fügt ein GridViewColumn Objekt zu einem GridView.

AddText(String)

Nicht unterstützt.

CheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)
ClearItem(ListViewItem)

Entfernt alle Einstellungen, Bindungen und Formatierungen aus einem ListViewItem.

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht.

(Geerbt von DependencyObject)
GetAutomationPeer(ListView)

Ruft die AutomationPeer Implementierung für dieses GridView Objekt ab.

GetColumnCollection(DependencyObject)

Ruft den Inhalt der ColumnCollection angefügten Eigenschaft ab.

GetHashCode()

Ruft einen Hashcode für diese DependencyObjectab.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben.

(Geerbt von DependencyObject)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject

(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 der aktuellen Object.

(Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet.

(Geerbt von DependencyObject)
PrepareItem(ListViewItem)

Bereitet eine ListViewItem Anzeige gemäß der Definition dieses GridView Objekts vor.

ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden.

(Geerbt von DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)

Legt den Inhalt der ColumnCollection angefügten Eigenschaft fest.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird.

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

(Geerbt von DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)

Bestimmt, ob die ColumnCollection angefügte Eigenschaft serialisiert werden soll.

ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen.

(Geerbt von DependencyObject)
ToString()

Gibt die Zeichenfolgendarstellung des GridView Objekts zurück.

VerifyAccess()

Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IAddChild.AddChild(Object)

Fügt ein untergeordnetes Objekt hinzu.

IAddChild.AddText(String)

Fügt dem Objekt den Textinhalt eines Knotens hinzu.

Gilt für:

Weitere Informationen