Partilhar via


GridView Classe

Definição

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.

ListView com a saída de 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.

Aplica-se a

Confira também