GridView Classe

Referência

Definição

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

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 os itens de dados em colunas para um controle 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

Herança: Object

DispatcherObject

DependencyObject

ViewBase
GridView

Atributos: ContentPropertyAttribute StyleTypedPropertyAttribute

Implementações: IAddChild

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 de ButtonBasee você pode reordenar as colunas usando operações de arrastar e soltar. Observe que as colunas de um GridView exibem dados e não fornecem acesso direto à fonte dos dados.

Para especificar um GridView como o modo de exibição de 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 GridView usando a Columns 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 para 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 controle ou Button , use GridViewmodelos ou estilos. Para obter um exemplo, consulte Como criar ListViewItems com uma CheckBox.

Construtores

GridView()

Inicializa uma nova instância da classe GridView.

Campos

AllowsColumnReorderProperty	Identifica a propriedade de dependência AllowsColumnReorder.
ColumnCollectionProperty	Identifica a propriedade ColumnCollectionProperty anexada.
ColumnHeaderContainerStyleProperty	Identifica a propriedade de dependência ColumnHeaderContainerStyle.
ColumnHeaderContextMenuProperty	Identifica a propriedade de dependência ColumnHeaderContextMenu.
ColumnHeaderStringFormatProperty	Identifica a propriedade de dependência ColumnHeaderStringFormat.
ColumnHeaderTemplateProperty	Identifica a propriedade de dependência ColumnHeaderTemplate.
ColumnHeaderTemplateSelectorProperty	Identifica a propriedade de dependência ColumnHeaderTemplateSelector.
ColumnHeaderToolTipProperty	Identifica a propriedade de dependência ColumnHeaderToolTip.

Propriedades

AllowsColumnReorder	Obtém ou define se as colunas em um GridView podem ser reordenadas por uma operação do tipo "arrastar e soltar".
ColumnHeaderContainerStyle	Obtém ou define o estilo a ser aplicado aos cabeçalhos de coluna.
ColumnHeaderContextMenu	Obtém ou define um ContextMenu para o GridView.
ColumnHeaderStringFormat	Obtém ou define uma cadeia de caracteres de composição 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 de seletor que fornece a 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 em um dos cabeçalhos de coluna.
Columns	Obtém a coleção de objetos GridViewColumn definida para esse GridView.
DefaultStyleKey	Obtém a referência para o estilo padrão do GridView.
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
GridViewItemContainerStyleKey	Obtém a chave que referencia o estilo definido para cada ListViewItem em um GridView.
GridViewScrollViewerStyleKey	Obtém a chave que referencia o estilo definido para o controle ScrollViewer que inclui o conteúdo exibido por um GridView.
GridViewStyleKey	Obtém a chave que referencia o estilo definido para o GridView.
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)
ItemContainerDefaultStyleKey	Obtém a referência para o estilo padrão para o contêiner dos itens de dados no GridView.

Propriedades Anexadas

ColumnCollection

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

Métodos

AddChild(Object)	Adiciona um objeto GridViewColumn a uma GridView.
AddText(String)	Não há suporte.
CheckAccess()	Determina se o thread de chamada tem acesso a este 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 limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
GetAutomationPeer(ListView)	Obtém a implementação de AutomationPeer para esse objeto GridView.
GetColumnCollection(DependencyObject)	Obtém o conteúdo da propriedade anexada ColumnCollection.
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa 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 nessa instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
PrepareItem(ListViewItem)	Prepara um ListViewItem para exibição de acordo com a definição deste objeto GridView.
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection)	Define o conteúdo da propriedade anexada ColumnCollection.
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeColumnCollection(DependencyObject)	Determina se a propriedade anexada ColumnCollection deve ou não ser serializada.
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 objeto GridView.
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Implantações explícitas de interface

IAddChild.AddChild(Object)	Adiciona um objeto filho.
IAddChild.AddText(String)	Adiciona o conteúdo do texto de um nó ao objeto.

Aplica-se a

Compartilhar via