Поделиться через


GridView Класс

Определение

Представляет режим представления, в котором отображаются элементы данных в столбцах элемента 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
Наследование
Атрибуты
Реализации

Примеры

В следующем примере показано, как определить ListView элемент управления, реализующий GridView как его 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>

Комментарии

Класс GridView и его вспомогательные классы предоставляют инфраструктуру для отображения элементов данных, указанных для ListView элемента управления в ряде столбцов. Столбцы имеют заголовки столбцов, которые являются кнопками, производными от ButtonBase, и вы можете изменить порядок столбцов с помощью операций перетаскивания. Обратите внимание, что столбцы отображаемых GridView данных и не предоставляют прямой доступ к источнику данных.

Чтобы указать GridView режим представления для объекта ListView, задайте View для GridView свойства значение объекта.

Класс GridView является производным от ViewBase. Пользовательские представления можно определить, наследуя от ViewBase класса, который предоставляет вспомогательные элементы для представления. Дополнительные сведения см. в разделе "Практическое руководство. Создание пользовательского режима представления для ListView".

На следующем рисунке показан пример использования ListView объекта GridView.

ListView с выходными

Столбцы в объекте GridView определяются как GridViewColumn объекты. В языке разметки расширяемых приложений (XAML) можно определить GridViewColumn объекты как дочерние элементы GridView. В коде можно добавить в GridViewColumnGridViewColumns свойство и Add метод, определенный для Collection<T> класса. Аналогичным образом можно использовать другие Collection<T> методы, такие как Remove и Insert изменение столбцов в объекте GridView.

В следующем примере показано, как определить столбцы объекта 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>

Чтобы создать стиль строк в строке GridView, определите стиль элементов ListViewItem управления в элементе ListViewуправления.

Чтобы добавить визуальные элементы, например элемент CheckBox управления или Button элемент управления, в GridViewшаблон или стили. Пример см. в статье "Практическое руководство. Создание ListViewItems с помощью checkBox".

Конструкторы

Имя Описание
GridView()

Инициализирует новый экземпляр класса GridView.

Поля

Имя Описание
AllowsColumnReorderProperty

Определяет AllowsColumnReorder свойство зависимостей.

ColumnCollectionProperty

Определяет присоединенное ColumnCollectionProperty свойство.

ColumnHeaderContainerStyleProperty

Определяет ColumnHeaderContainerStyle свойство зависимостей.

ColumnHeaderContextMenuProperty

Определяет ColumnHeaderContextMenu свойство зависимостей.

ColumnHeaderStringFormatProperty

Определяет ColumnHeaderStringFormat свойство зависимостей.

ColumnHeaderTemplateProperty

Определяет ColumnHeaderTemplate свойство зависимостей.

ColumnHeaderTemplateSelectorProperty

Определяет ColumnHeaderTemplateSelector свойство зависимостей.

ColumnHeaderToolTipProperty

Определяет ColumnHeaderToolTip свойство зависимостей.

Свойства

Имя Описание
AllowsColumnReorder

Возвращает или задает, можно ли переупорядочение столбцов в GridView операции перетаскивания.

ColumnHeaderContainerStyle

Возвращает или задает стиль, применяемый к заголовкам столбцов.

ColumnHeaderContextMenu

Возвращает или задает ContextMenu для GridViewпараметра .

ColumnHeaderStringFormat

Возвращает или задает составную строку, указывающую, как форматировать заголовки столбцов GridView , если они отображаются в виде строк.

ColumnHeaderTemplate

Возвращает или задает шаблон для отображения заголовков столбцов.

ColumnHeaderTemplateSelector

Возвращает или задает объект селектора, предоставляющий логику выбора шаблона для каждого заголовка столбца.

ColumnHeaderToolTip

Возвращает или задает содержимое подсказки, которая отображается при приостановке указателя мыши над одним из заголовков столбцов.

Columns

Возвращает коллекцию объектов, определенных GridViewColumn для этого GridView.

DefaultStyleKey

Возвращает ссылку на стиль по умолчанию для параметра GridView.

DependencyObjectType

Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра.

(Унаследовано от DependencyObject)
Dispatcher

Dispatcher Возвращает это DispatcherObject значение, с которым связано.

(Унаследовано от DispatcherObject)
GridViewItemContainerStyleKey

Получает ключ, ссылающийся на стиль, определенный для каждого ListViewItem из них.GridView

GridViewScrollViewerStyleKey

Получает ключ, ссылающийся на стиль, определенный для ScrollViewer элемента управления, который заключает содержимое, отображаемое в виде элемента GridViewуправления.

GridViewStyleKey

Получает ключ, ссылающийся на стиль, определенный для GridView.

IsSealed

Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения).

(Унаследовано от DependencyObject)
ItemContainerDefaultStyleKey

Возвращает ссылку на стиль по умолчанию для контейнера элементов данных в объекте GridView.

Присоединенные свойства

Имя Описание
ColumnCollection

Возвращает или задает присоединенное свойство, содержащее объект GridViewColumnCollection.

Методы

Имя Описание
AddChild(Object)

GridViewColumn Добавляет объект в объектGridView.

AddText(String)

Не поддерживается.

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.

(Унаследовано от DispatcherObject)
ClearItem(ListViewItem)

Удаляет все параметры, привязки и стили из .ListViewItem

ClearValue(DependencyProperty)

Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty .

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey.

(Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)

Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject.

(Унаследовано от DependencyObject)
Equals(Object)

Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject.

(Унаследовано от DependencyObject)
GetAutomationPeer(ListView)

Возвращает реализацию AutomationPeer для этого GridView объекта.

GetColumnCollection(DependencyObject)

Возвращает содержимое присоединенного ColumnCollection свойства.

GetHashCode()

Получает хэш-код для этого DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject.

(Унаследовано от DependencyObject)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет эффективное значение для указанного свойства зависимостей.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается при каждом обновлении эффективного значения любого свойства DependencyObject зависимостей. Определенное свойство зависимостей, которое изменилось, сообщается в данных события.

(Унаследовано от DependencyObject)
PrepareItem(ListViewItem)

Готовится ListViewItem к отображению в соответствии с определением этого GridView объекта.

ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если оно существует.

(Унаследовано от DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)

Задает содержимое присоединенного ColumnCollection свойства.

SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не изменяя его источник значений.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости.

(Унаследовано от DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)

Определяет, следует ли сериализовать присоединенное ColumnCollection свойство.

ShouldSerializeProperty(DependencyProperty)

Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей.

(Унаследовано от DependencyObject)
ToString()

Возвращает строковое представление GridView объекта.

VerifyAccess()

Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject.

(Унаследовано от DispatcherObject)

Явные реализации интерфейса

Имя Описание
IAddChild.AddChild(Object)

Добавляет дочерний объект.

IAddChild.AddText(String)

Добавляет текстовое содержимое узла в объект.

Применяется к

См. также раздел