GridView Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Controls

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje tryb wyświetlania elementów danych w kolumnach dla kontrolki ListView .

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

Dziedziczenie: Object

DispatcherObject

DependencyObject

ViewBase
GridView

Atrybuty: ContentPropertyAttribute StyleTypedPropertyAttribute

Implementuje: IAddChild

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować kontrolkęListView, która implementuje GridView element jako .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>

Uwagi

Klasa GridView i jej klasy pomocnicze zapewniają infrastrukturę do wyświetlania elementów danych określonych dla ListView kontrolki w serii kolumn. Kolumny mają nagłówki kolumn, które są przyciskami pochodzącymi z ButtonBaseelementu , i można zmienić kolejność kolumn przy użyciu operacji przeciągania i upuszczania. Należy pamiętać, że kolumny danych wyświetlanych GridView i nie zapewniają bezpośredniego dostępu do źródła danych.

Aby określić GridView jako tryb widoku dla obiektu ListView, ustaw View właściwość na GridView obiekt .

Klasa GridView pochodzi z ViewBaseklasy . Widoki niestandardowe można zdefiniować, dziedziczą po ViewBase klasie, która udostępnia elementy pomocnicze widoku. Aby uzyskać więcej informacji, zobacz How to: Create a Custom View Mode for a ListView (Jak utworzyć tryb widoku niestandardowego dla elementu ListView).

Na poniższej ilustracji przedstawiono przykład obiektu ListView , który używa obiektu GridView.

Obiekt ListView z wyjściowymi kontrolkami GridView

Kolumny w obiekcie GridView są definiowane jako GridViewColumn obiekty. W rozszerzalnym języku znaczników aplikacji (XAML) można zdefiniować GridViewColumn obiekty jako elementy podrzędne elementu GridView. W kodzie można dodać element GridViewColumn do GridView klasy przy użyciu Columns właściwości i Add metody zdefiniowanej Collection<T> dla klasy . Podobnie można użyć innych Collection<T> metod, takich jak Remove i Insert , aby zmodyfikować kolumny w obiekcie GridView.

W poniższym przykładzie pokazano, jak zdefiniować kolumny obiektu 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>

Aby stylować wiersze w obiekcie GridView, zdefiniuj styl dla ListViewItem kontrolek w obiekcie ListView.

Aby dodać elementy wizualne, takie jak kontrolka CheckBox lub Button , do GridViewelementu , użyj szablonów lub stylów. Aby zapoznać się z przykładem, zobacz How to: Create ListViewItems with a CheckBox (Jak utworzyć element ListViewItems za pomocą kontrolki CheckBox).

Konstruktory

GridView()

Inicjuje nowe wystąpienie klasy GridView.

Pola

AllowsColumnReorderProperty	AllowsColumnReorder Identyfikuje właściwość zależności.
ColumnCollectionProperty	Identyfikuje dołączoną ColumnCollectionProperty właściwość.
ColumnHeaderContainerStyleProperty	ColumnHeaderContainerStyle Identyfikuje właściwość zależności.
ColumnHeaderContextMenuProperty	ColumnHeaderContextMenu Identyfikuje właściwość zależności.
ColumnHeaderStringFormatProperty	ColumnHeaderStringFormat Identyfikuje właściwość zależności.
ColumnHeaderTemplateProperty	ColumnHeaderTemplate Identyfikuje właściwość zależności.
ColumnHeaderTemplateSelectorProperty	ColumnHeaderTemplateSelector Identyfikuje właściwość zależności.
ColumnHeaderToolTipProperty	ColumnHeaderToolTip Identyfikuje właściwość zależności.

Właściwości

AllowsColumnReorder	Pobiera lub ustawia, czy kolumny w obiekcie GridView mogą być zmieniane przez operację przeciągania i upuszczania.
ColumnHeaderContainerStyle	Pobiera lub ustawia styl, który ma być stosowany do nagłówków kolumn.
ColumnHeaderContextMenu	Pobiera lub ustawia wartość ContextMenu dla .GridView
ColumnHeaderStringFormat	Pobiera lub ustawia ciąg złożony, który określa sposób formatowania nagłówków GridView kolumn, jeśli są one wyświetlane jako ciągi.
ColumnHeaderTemplate	Pobiera lub ustawia szablon do użycia do wyświetlania nagłówków kolumn.
ColumnHeaderTemplateSelector	Pobiera lub ustawia obiekt selektora, który zapewnia logikę wybierania szablonu do użycia dla każdego nagłówka kolumny.
ColumnHeaderToolTip	Pobiera lub ustawia zawartość etykietki narzędzia, która jest wyświetlana, gdy wskaźnik myszy wstrzymuje się nad jednym z nagłówków kolumn.
Columns	Pobiera kolekcję obiektów zdefiniowanych GridViewColumn dla tego obiektu GridView.
DefaultStyleKey	Pobiera odwołanie do domyślnego stylu dla elementu GridView.
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
GridViewItemContainerStyleKey	Pobiera klucz odwołujący się do stylu zdefiniowanego dla każdego ListViewItem elementu w obiekcie GridView.
GridViewScrollViewerStyleKey	Pobiera klucz odwołujący się do stylu zdefiniowanego ScrollViewer dla kontrolki zawierającej zawartość wyświetlaną przez element GridView.
GridViewStyleKey	Pobiera klucz odwołujący się do stylu zdefiniowanego dla elementu GridView.
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
ItemContainerDefaultStyleKey	Pobiera odwołanie do domyślnego stylu kontenera elementów danych w obiekcie GridView.

Właściwości dołączone

ColumnCollection

Pobiera lub ustawia dołączoną właściwość zawierającą GridViewColumnCollectionelement .

Metody

AddChild(Object)	GridViewColumn Dodaje obiekt do obiektu GridView.
AddText(String)	Nieobsługiwane.
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearItem(ListViewItem)	Usuwa wszystkie ustawienia, powiązania i style z elementu ListViewItem.
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetAutomationPeer(ListView)	Pobiera implementację AutomationPeer dla tego GridView obiektu.
GetColumnCollection(DependencyObject)	Pobiera zawartość dołączonej ColumnCollection właściwości.
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która została zmieniona, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
PrepareItem(ListViewItem)	Przygotowuje obiekt ListViewItem do wyświetlania zgodnie z definicją tego GridView obiektu.
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)	Ustawia zawartość dołączonej ColumnCollection właściwości.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)	Określa, czy należy serializować dołączoną ColumnCollection właściwość.
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca reprezentację GridView ciągu obiektu.
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)	Dodaje obiekt podrzędny.
IAddChild.AddText(String)	Dodaje do obiektu zawartość tekstową węzła.

Dotyczy