GridView Klasse

Definition

Stellt einen Anzeigemodus dar, der Datenelemente in Spalten für ein ListView-Steuerelement anzeigt.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
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein ListView Steuerelement definiert wird GridView , das Vieweinen als den implementiert.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>

Hinweise

Die GridView -Klasse und die unterstützenden Klassen stellen die-Infrastruktur zum Anzeigen von Datenelementen bereit ListView , die für ein-Steuerelement in einer Reihe von Spalten angegeben werden.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. Die Spalten weisen Spaltenheader auf, bei denen es sich um Schalt ButtonBaseFlächen handelt, die von abgeleitet sind, und Sie können die Spalten mithilfe von Drag & Drop-Vorgängen neu anordnen.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. Beachten Sie, dass die Spalten GridView einer Datenanzeige und keinen direkten Zugriff auf die Datenquelle bereitstellen.Note that the columns of a GridView display data and do not provide direct access to the source of the data.

Um einen GridView als Ansichtsmodus für ein ListViewanzugeben, legen Sie View die-Eigenschaft GridView auf ein-Objekt fest.To specify a GridView as the view mode for a ListView, set the View property to a GridView object.

Die GridView -Klasse wird von ViewBaseabgeleitet.The GridView class is derived from ViewBase. Sie können benutzerdefinierte Ansichten definieren, indem Sie von ViewBase der-Klasse erben, die die unterstützenden Elemente für eine Sicht bereitstellt.You can define custom views by inheriting from the ViewBase class that provides the supporting elements for a view. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen Sie einen benutzerdefinierten Ansichtsmodus füreine ListView.For more information, see How to: Create a Custom View Mode for a ListView.

Die folgende Abbildung zeigt ein Beispiel für eine ListView , die einen GridViewverwendet.The following illustration shows an example of a ListView that uses a GridView.

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

Die Spalten in einem GridView werden als GridViewColumn -Objekte definiert.The columns in a GridView are defined as GridViewColumn objects. In Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)können Sie-Objekte GridViewColumn GridViewals untergeordnete Elemente des definieren.In Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), you can define GridViewColumn objects as child elements of the GridView. Im Code können Sie mit der GridViewColumn Columns -Eigenschaft und GridView der Add -Methode, die für die Collection<T> -Klasse definiert ist, ein hinzufügen.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. Ebenso können Sie Collection<T> andere Methoden Remove wie und Insert verwenden, um die Spalten in einer GridViewzu ändern.Similarly, you can use other Collection<T> methods such as Remove and Insert to modify the columns in a GridView.

Im folgenden Beispiel wird gezeigt, wie die Spalten eines GridViewdefiniert werden.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>

Um die Zeilen in einer GridViewzu formatieren, definieren Sie einen Stil für die ListView ListViewItem Steuerelemente in der.To style the rows in a GridView, define a style for the ListViewItem controls in the ListView.

Um visuelle Elemente, wie z. b CheckBox . Button ein-oder- GridViewSteuerelement, zu hinzuzufügen, verwenden Sie Vorlagen oder Stile.To add visual elements, such as a CheckBox or Button control, to a GridView, use templates or styles. Ein Beispiel finden Sie unter Gewusst wie: Erstellen Sie ListViewItems mit einemKontrollkästchen.For an example, see How to: Create ListViewItems with a CheckBox.

Konstruktoren

GridView()

Initialisiert eine neue Instanz der GridView-Klasse.Initializes a new instance of the GridView class.

Felder

AllowsColumnReorderProperty

Bezeichnet die AllowsColumnReorder-Abhängigkeitseigenschaft.Identifies the AllowsColumnReorder dependency property.

ColumnCollectionProperty

Bezeichnet die angefügte ColumnCollectionProperty-Eigenschaft.Identifies the ColumnCollectionProperty attachedproperty.

ColumnHeaderContainerStyleProperty

Bezeichnet die ColumnHeaderContainerStyle-Abhängigkeitseigenschaft.Identifies the ColumnHeaderContainerStyle dependency property.

ColumnHeaderContextMenuProperty

Bezeichnet die ColumnHeaderContextMenu-Abhängigkeitseigenschaft.Identifies the ColumnHeaderContextMenu dependency property.

ColumnHeaderStringFormatProperty

Bezeichnet die ColumnHeaderStringFormat-Abhängigkeitseigenschaft.Identifies the ColumnHeaderStringFormat dependency property.

ColumnHeaderTemplateProperty

Bezeichnet die ColumnHeaderTemplate-Abhängigkeitseigenschaft.Identifies the ColumnHeaderTemplate dependency property.

ColumnHeaderTemplateSelectorProperty

Bezeichnet die ColumnHeaderTemplateSelector-Abhängigkeitseigenschaft.Identifies the ColumnHeaderTemplateSelector dependency property.

ColumnHeaderToolTipProperty

Bezeichnet die ColumnHeaderToolTip-Abhängigkeitseigenschaft.Identifies the ColumnHeaderToolTip dependency property.

Eigenschaften

AllowsColumnReorder

Dient zum Abrufen oder Festlegen, ob Spalten in einem GridView durch einen Drag & Drop-Vorgang neu angeordnet werden können.Gets or sets whether columns in a GridView can be reordered by a drag-and-drop operation.

ColumnHeaderContainerStyle

Ruft die Formatvorlage ab, die auf Spaltenköpfe angewendet werden soll, oder legt diese fest.Gets or sets the style to apply to column headers.

ColumnHeaderContextMenu

Ruft ein ContextMenu für die GridView ab oder legt dieses fest.Gets or sets a ContextMenu for the GridView.

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.Gets or sets a composite string that specifies how to format the column headers of the GridView if they are displayed as strings.

ColumnHeaderTemplate

Ruft eine Vorlage für die Anzeige der Spaltenköpfe ab oder legt diese fest.Gets or sets a template to use to display the column headers.

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.Gets or sets the selector object that provides logic for selecting a template to use for each column header.

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.Gets or sets the content of a tooltip that appears when the mouse pointer pauses over one of the column headers.

Columns

Ruft die Auflistung von GridViewColumn-Objekten ab, die für diese GridView definiert sind.Gets the collection of GridViewColumn objects that is defined for this GridView.

DefaultStyleKey

Ruft den Verweis auf den Standardstil der GridView ab.Gets the reference for the default style for the GridView.

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
GridViewItemContainerStyleKey

Ruft den Schlüssel ab, der auf den Stil verweist, der für jedes ListViewItem in einer GridView definiert ist.Gets the key that references the style that is defined for each ListViewItem in a GridView.

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

Ruft den Schlüssel ab, der auf den Stil verweist, der für das GridView definiert ist.Gets the key that references the style that is defined for the GridView.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
ItemContainerDefaultStyleKey

Ruft einen Verweis auf den Standardstil des Containers der Datenelemente in der GridView ab.Gets the reference to the default style for the container of the data items in the GridView.

Angefügte Eigenschaften

ColumnCollection

Ruft die angefügte Eigenschaft ab, die die GridViewColumnCollection enthält, oder legt diese fest.Gets or sets the attached property that contains the GridViewColumnCollection.

Methoden

AddChild(Object)

Fügt ein GridViewColumn-Objekt zu einer GridView hinzu.Adds a GridViewColumn object to a GridView.

AddText(String)

Wird nicht unterstützt.Not supported.

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearItem(ListViewItem)

Entfernt alle Einstellungen, Bindungen und Formatierungen von einem ListViewItem.Removes all settings, bindings, and styling from a ListViewItem.

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
GetAutomationPeer(ListView)

Ruft die AutomationPeer-Implementierung für dieses GridView-Objekt ab.Gets the AutomationPeer implementation for this GridView object.

GetColumnCollection(DependencyObject)

Ruft den Inhalt der angefügten ColumnCollection-Eigenschaft ab.Gets the contents of the ColumnCollection attached property.

GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
PrepareItem(ListViewItem)

Bereitet ein ListViewItem-Steuerelement für die Anzeige gemäß der Definition des angegebenen GridView-Objekts vor.Prepares a ListViewItem for display according to the definition of this GridView object.

ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)

Legt den Inhalt der angefügten ColumnCollection-Eigenschaft fest.Sets the contents of the ColumnCollection attached property.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

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

(Geerbt von DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)

Bestimmt, ob die angefügte ColumnCollection-Eigenschaft serialisiert werden soll.Determines whether to serialize the ColumnCollection attached property.

ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt die Zeichenfolgendarstellung des GridView-Objekts zurück.Returns the string representation of the GridView object.

VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)

Fügt ein untergeordnetes Objekt hinzu.Adds a child object.

IAddChild.AddText(String)

Fügt dem Objekt den Textinhalt eines Knotens hinzu.Adds the text content of a node to the object.

Gilt für:

Siehe auch