GridView Класс

Ссылка

Определение

Пространство имен:: System.Windows.Controls

Сборка:: PresentationFramework.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Наследование: Object

DispatcherObject

DependencyObject

ViewBase
GridView

Атрибуты: ContentPropertyAttribute StyleTypedPropertyAttribute

Реализации: 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

Столбцы в GridView определяются как GridViewColumn объекты . В XAML можно определить GridViewColumn объекты как дочерние GridViewэлементы . В коде можно добавить GridViewColumn GridView в с помощью Columns свойства и 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)	Добавляет к объекту текстовое содержимое узла.

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