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.
Столбцы в объекте 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) |
Добавляет текстовое содержимое узла в объект. |