GridView Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.
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. |