GridView Classe

Definição

Representa um modo de visualização que exibe os itens de dados em colunas para um ListView controlo.

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 seguinte mostra como definir um ListView controlo que implementa a GridView como o 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>

Observações

A GridView classe e as suas classes de suporte fornecem a infraestrutura para exibir os itens de dados especificados para um ListView controlo numa série de colunas. As colunas têm cabeçalhos de colunas, que são botões derivados de ButtonBase, e pode reordenar as colunas usando operações de arrastar e largar. Note-se que as colunas de um GridView documento exibem dados e não fornecem acesso direto à fonte dos dados.

Para especificar a GridView como modo de visualização para um ListView, defina a View propriedade para um GridView objeto.

A GridView classe é derivada de ViewBase. Pode definir vistas personalizadas herdando da ViewBase classe que fornece os elementos de suporte para uma vista. Para mais informações, veja Como: Criar um Modo de Visualização Personalizada para uma Vista de Lista.

A ilustração seguinte mostra um exemplo de um ListView que usa um GridView.

ListView com saída GridView

As colunas em a GridView são definidas como GridViewColumn objetos. Na Extensible Application Markup Language (XAML), pode definir GridViewColumn objetos como elementos filhos do GridViewarquivo . No código, pode adicionar a GridViewColumn ao usando a Columns propriedade e o Add método definido para a Collection<T> classeGridView. De forma semelhante, pode usar outros Collection<T> métodos como Remove e Insert para modificar as colunas num GridView.

O exemplo seguinte 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 num GridView, defina um estilo para os ListViewItem controlos no ListView.

Para adicionar elementos visuais, como um CheckBox ou Button controlo, a um GridView, use modelos ou estilos. Para um exemplo, veja Como: Criar ItensVistaLista com uma Caixa de Seleção.

Construtores

Name Description
GridView()

Inicializa uma nova instância da GridView classe.

Campos

Name Description
AllowsColumnReorderProperty

Identifica a AllowsColumnReorder propriedade de dependência.

ColumnCollectionProperty

Identifica a ColumnCollectionProperty propriedade 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

Name Description
AllowsColumnReorder

Obtém ou define se as colunas de um GridView podem ser reordenadas por uma operação de arrastar e largar.

ColumnHeaderContainerStyle

Obtém ou define o estilo a aplicar aos cabeçalhos das colunas.

ColumnHeaderContextMenu

Obtém ou define a ContextMenu para o GridView.

ColumnHeaderStringFormat

Obtém ou define uma cadeia composta que especifica como formatar os cabeçalhos das colunas se GridView forem exibidos como strings.

ColumnHeaderTemplate

Obtém ou define um modelo para mostrar os cabeçalhos das colunas.

ColumnHeaderTemplateSelector

Obtém ou define o objeto seletor que fornece lógica para selecionar um modelo a usar para cada cabeçalho de coluna.

ColumnHeaderToolTip

Obtém ou define o conteúdo de uma dica de ferramenta que aparece quando o ponteiro do rato pausa sobre um dos cabeçalhos das colunas.

Columns

Obtém a coleção de GridViewColumn objetos que está definida para este GridView.

DefaultStyleKey

Obtém a referência para o estilo padrão do GridView.

DependencyObjectType

Obtém o DependencyObjectType que envolve o tipo CLR desta instância.

(Herdado de DependencyObject)
Dispatcher

Percebe o Dispatcher que isto DispatcherObject está associado.

(Herdado de DispatcherObject)
GridViewItemContainerStyleKey

Obtém a chave que faz referência ao estilo definido para cada ListViewItem em um GridView.

GridViewScrollViewerStyleKey

Obtém a chave que faz referência ao estilo definido para o ScrollViewer controlo que envolve o conteúdo exibido por um GridView.

GridViewStyleKey

Obtém a chave que faz referência ao estilo definido para o GridView.

IsSealed

Recebe um valor que indica se esta instância está atualmente selada (apenas leitura).

(Herdado de DependencyObject)
ItemContainerDefaultStyleKey

Obtém a referência ao estilo padrão para o contentor dos itens de dados no GridView.

Propriedades Anexadas

Name Description
ColumnCollection

Obtém ou define a propriedade associada que contém o GridViewColumnCollection.

Métodos

Name Description
AddChild(Object)

Adiciona um GridViewColumn objeto a um GridView.

AddText(String)

Não suportado.

CheckAccess()

Determina se o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)
ClearItem(ListViewItem)

Remove todas as definições, bindings e styling de um ListViewItem.

ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject.

(Herdado de DependencyObject)
Equals(Object)

Determina se um fornecido DependencyObject é equivalente à corrente 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 de hash para isto DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(DependencyProperty)

Devolve 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 atual Object.

(Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada 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)

Devolve o valor local de uma propriedade de dependência, se esta 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 a sua fonte de valor.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência.

(Herdado de DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)

Determina se deve serializar a ColumnCollection propriedade anexada.

ShouldSerializeProperty(DependencyProperty)

Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.

(Herdado de DependencyObject)
ToString()

Devolve a representação da cadeia do GridView objeto.

VerifyAccess()

Faz cumprir que o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)

Implementações de Interface Explícita

Name Description
IAddChild.AddChild(Object)

Adiciona um objeto filho.

IAddChild.AddText(String)

Adiciona o conteúdo textual de um nó ao objeto.

Aplica-se a

Ver também