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 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 IAddChildPublic 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 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.
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
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de