GridView Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um modo de exibição que exibe itens de dados em colunas para um ListView controle.
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
- Herança
- Atributos
- Implementações
Exemplos
O exemplo a seguir mostra como definir um ListView controle que implementa um GridView como seu 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>
Comentários
A GridView classe e suas classes de suporte fornecem a infraestrutura para exibir itens de dados especificados para um ListView controle em uma série de colunas. As colunas têm cabeçalhos de coluna, que são botões derivados ButtonBasee você pode reordenar as colunas usando operações de arrastar e soltar. Observe que as colunas de um GridView dado de exibição e não fornecem acesso direto à fonte dos dados.
Para especificar um GridView como o modo de exibição para um ListView, defina a View propriedade como um GridView objeto.
A GridView classe é derivada de ViewBase. Você pode definir exibições personalizadas herdando da ViewBase classe que fornece os elementos de suporte para uma exibição. Para obter mais informações, consulte Como criar um modo de exibição personalizado para um ListView.
A ilustração a seguir mostra um exemplo de um ListView que usa um GridView.
As colunas em um GridView são definidas como GridViewColumn objetos. Em XAML (Extensible Application Markup Language), você pode definir GridViewColumn objetos como elementos filho do GridView. No código, você pode adicionar um GridViewColumn ao usando a GridViewColumns propriedade e o Add método definido para a Collection<T> classe. Da mesma forma, você pode usar outros Collection<T> métodos, como Remove e Insert modificar as colunas em um GridView.
O exemplo a seguir mostra como definir as colunas de um 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>
Para estilizar as linhas em um GridView, defina um estilo para os ListViewItem controles no ListView.
Para adicionar elementos visuais, como um CheckBox ou Button controle, a um GridView, use modelos ou estilos. Para obter um exemplo, consulte Como criar ListViewItems com uma Caixa de Seleção.
Construtores
| Nome | Description |
|---|---|
| GridView() |
Inicializa uma nova instância da classe GridView. |
Campos
| Nome | Description |
|---|---|
| AllowsColumnReorderProperty |
Identifica a AllowsColumnReorder propriedade de dependência. |
| ColumnCollectionProperty |
Identifica a ColumnCollectionProperty reprodução anexada. |
| ColumnHeaderContainerStyleProperty |
Identifica a ColumnHeaderContainerStyle propriedade de dependência. |
| ColumnHeaderContextMenuProperty |
Identifica a ColumnHeaderContextMenu propriedade de dependência. |
| ColumnHeaderStringFormatProperty |
Identifica a ColumnHeaderStringFormat propriedade de dependência. |
| ColumnHeaderTemplateProperty |
Identifica a ColumnHeaderTemplate propriedade de dependência. |
| ColumnHeaderTemplateSelectorProperty |
Identifica a ColumnHeaderTemplateSelector propriedade de dependência. |
| ColumnHeaderToolTipProperty |
Identifica a ColumnHeaderToolTip propriedade de dependência. |
Propriedades
| Nome | Description |
|---|---|
| AllowsColumnReorder |
Obtém ou define se as colunas em uma GridView podem ser reordenadas por uma operação de arrastar e soltar. |
| ColumnHeaderContainerStyle |
Obtém ou define o estilo a ser aplicado a cabeçalhos de coluna. |
| ColumnHeaderContextMenu |
Obtém ou define um ContextMenu para o GridView. |
| ColumnHeaderStringFormat |
Obtém ou define uma cadeia de caracteres composta que especifica como formatar os cabeçalhos de coluna do GridView se eles forem exibidos como cadeias de caracteres. |
| ColumnHeaderTemplate |
Obtém ou define um modelo a ser usado para exibir os cabeçalhos de coluna. |
| ColumnHeaderTemplateSelector |
Obtém ou define o objeto seletor que fornece lógica para selecionar um modelo a ser usado para cada cabeçalho de coluna. |
| ColumnHeaderToolTip |
Obtém ou define o conteúdo de uma dica de ferramenta exibida quando o ponteiro do mouse pausa sobre um dos cabeçalhos de coluna. |
| Columns |
Obtém a coleção de GridViewColumn objetos que é definida para isso GridView. |
| DefaultStyleKey |
Obtém a referência para o estilo padrão para o GridView. |
| DependencyObjectType |
Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject) |
| Dispatcher |
Obtém o Dispatcher que DispatcherObject está associado. (Herdado de DispatcherObject) |
| GridViewItemContainerStyleKey |
Obtém a chave que faz referência ao estilo definido para cada ListViewItem um em um GridView. |
| GridViewScrollViewerStyleKey |
Obtém a chave que faz referência ao estilo definido para o ScrollViewer controle que inclui o conteúdo exibido por um GridView. |
| GridViewStyleKey |
Obtém a chave que faz referência ao estilo definido para o GridView. |
| IsSealed |
Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject) |
| ItemContainerDefaultStyleKey |
Obtém a referência ao estilo padrão para o contêiner dos itens de dados no GridView. |
Propriedades Anexadas
| Nome | Description |
|---|---|
| ColumnCollection |
Obtém ou define a propriedade anexada que contém o GridViewColumnCollection. |
Métodos
| Nome | Description |
|---|---|
| AddChild(Object) |
Adiciona um GridViewColumn objeto a um GridView. |
| AddText(String) |
Sem suporte. |
| CheckAccess() |
Determina se o thread de chamada tem acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| ClearItem(ListViewItem) |
Remove todas as configurações, associações e estilo de um ListViewItem. |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject) |
| CoerceValue(DependencyProperty) |
Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer CoerceValueCallback função especificada nos metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject) |
| GetAutomationPeer(ListView) |
Obtém a AutomationPeer implementação deste GridView objeto. |
| GetColumnCollection(DependencyObject) |
Obtém o conteúdo da ColumnCollection propriedade anexada. |
| GetHashCode() |
Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.DependencyObject (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Invocado sempre que o valor efetivo de qualquer propriedade de dependência tiver DependencyObject sido atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject) |
| PrepareItem(ListViewItem) |
Prepara um ListViewItem para exibição de acordo com a definição deste GridView objeto. |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject) |
| SetColumnCollection(DependencyObject, GridViewColumnCollection) |
Define o conteúdo da ColumnCollection propriedade anexada. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente leitura, especificada pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeColumnCollection(DependencyObject) |
Determina se a propriedade anexada deve ser serializada ColumnCollection . |
| ShouldSerializeProperty(DependencyProperty) |
Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Retorna a representação de cadeia de caracteres do GridView objeto. |
| VerifyAccess() |
Impõe que o thread de chamada tenha acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IAddChild.AddChild(Object) |
Adiciona um objeto filho. |
| IAddChild.AddText(String) |
Adiciona o conteúdo de texto de um nó ao objeto. |