GridView GridView GridView GridView Class

Definición

Representa un modo de vista que muestra elementos de datos en columnas de un control ListView.Represents a view mode that displays data items in columns for a ListView control.

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
type GridView = class
    inherit ViewBase
    interface IAddChild
Public Class GridView
Inherits ViewBase
Implements IAddChild
Herencia
Atributos
Implementaciones

Ejemplos

El ejemplo siguiente muestra cómo definir un ListView control que implementa un GridView como su View.The following example shows how to define a ListView control that implements a GridView as its 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>

Comentarios

El GridView clase y sus clases auxiliares proporcionan la infraestructura para mostrar los elementos de datos que se especifican para un ListView control en una serie de columnas.The GridView class and its supporting classes provide the infrastructure to display data items that are specified for a ListView control in a series of columns. Las columnas tienen encabezados de columna, que son los botones que se derivan de ButtonBase, y se pueden reordenar las columnas mediante operaciones de arrastrar y colocar.The columns have column headers, which are buttons that are derived from ButtonBase, and you can reorder the columns by using drag-and-drop operations. Tenga en cuenta que las columnas de una GridView mostrar los datos y no proporcionan acceso directo al origen de datos.Note that the columns of a GridView display data and do not provide direct access to the source of the data.

Para especificar un GridView como el modo de vista para un ListView, establezca el View propiedad a un GridView objeto.To specify a GridView as the view mode for a ListView, set the View property to a GridView object.

El GridView se deriva la clase ViewBase.The GridView class is derived from ViewBase. Puede definir vistas personalizadas heredando de la ViewBase clase que proporciona los elementos auxiliares para una vista.You can define custom views by inheriting from the ViewBase class that provides the supporting elements for a view. Para obtener más información, vea Cómo: Creación de un modo de vista personalizado para un ListView.For more information, see How to: Create a Custom View Mode for a ListView.

La siguiente ilustración muestra un ejemplo de un ListView que usa un GridView.The following illustration shows an example of a ListView that uses a GridView.

ListView con resultado GridViewListView with GridView output

Las columnas de una GridView se definen como GridViewColumn objetos.The columns in a GridView are defined as GridViewColumn objects. En Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML), puede definir GridViewColumn objetos como elementos secundarios de la GridView.In Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML), you can define GridViewColumn objects as child elements of the GridView. En el código, puede agregar un GridViewColumn a la GridView mediante el uso de la Columns propiedad y el Add método que se define para el Collection<T> clase.In code, you can add a GridViewColumn to the GridView by using the Columns property and the Add method that is defined for the Collection<T> class. De forma similar, puede utilizar otros Collection<T> métodos como Remove y Insert para modificar las columnas de una GridView.Similarly, you can use other Collection<T> methods such as Remove and Insert to modify the columns in a GridView.

El ejemplo siguiente muestra cómo se definen las columnas de una GridView.The following example shows how to define the columns of a 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 definir el estilo de las filas de una GridView, definir un estilo para el ListViewItem controla en el ListView.To style the rows in a GridView, define a style for the ListViewItem controls in the ListView.

Para agregar elementos visuales, como un CheckBox o Button controlar, un GridView, use plantillas o estilos.To add visual elements, such as a CheckBox or Button control, to a GridView, use templates or styles. Como ejemplo, vea Cómo: Crear controles ListViewItems con un control CheckBox.For an example, see How to: Create ListViewItems with a CheckBox.

Constructores

GridView() GridView() GridView() GridView()

Inicializa una nueva instancia de la clase GridView.Initializes a new instance of the GridView class.

Campos

AllowsColumnReorderProperty AllowsColumnReorderProperty AllowsColumnReorderProperty AllowsColumnReorderProperty

Identifica la propiedad de dependencia AllowsColumnReorder.Identifies the AllowsColumnReorder dependency property.

ColumnCollectionProperty ColumnCollectionProperty ColumnCollectionProperty ColumnCollectionProperty

Identifica la propiedad adjunta ColumnCollectionProperty.Identifies the ColumnCollectionProperty attachedproperty.

ColumnHeaderContainerStyleProperty ColumnHeaderContainerStyleProperty ColumnHeaderContainerStyleProperty ColumnHeaderContainerStyleProperty

Identifica la propiedad de dependencia ColumnHeaderContainerStyle.Identifies the ColumnHeaderContainerStyle dependency property.

ColumnHeaderContextMenuProperty ColumnHeaderContextMenuProperty ColumnHeaderContextMenuProperty ColumnHeaderContextMenuProperty

Identifica la propiedad de dependencia ColumnHeaderContextMenu.Identifies the ColumnHeaderContextMenu dependency property.

ColumnHeaderStringFormatProperty ColumnHeaderStringFormatProperty ColumnHeaderStringFormatProperty ColumnHeaderStringFormatProperty

Identifica la propiedad de dependencia ColumnHeaderStringFormat.Identifies the ColumnHeaderStringFormat dependency property.

ColumnHeaderTemplateProperty ColumnHeaderTemplateProperty ColumnHeaderTemplateProperty ColumnHeaderTemplateProperty

Identifica la propiedad de dependencia ColumnHeaderTemplate.Identifies the ColumnHeaderTemplate dependency property.

ColumnHeaderTemplateSelectorProperty ColumnHeaderTemplateSelectorProperty ColumnHeaderTemplateSelectorProperty ColumnHeaderTemplateSelectorProperty

Identifica la propiedad de dependencia ColumnHeaderTemplateSelector.Identifies the ColumnHeaderTemplateSelector dependency property.

ColumnHeaderToolTipProperty ColumnHeaderToolTipProperty ColumnHeaderToolTipProperty ColumnHeaderToolTipProperty

Identifica la propiedad de dependencia ColumnHeaderToolTip.Identifies the ColumnHeaderToolTip dependency property.

Propiedades

AllowsColumnReorder AllowsColumnReorder AllowsColumnReorder AllowsColumnReorder

Obtiene o establece un valor que indica si las columnas de un objeto GridView pueden reordenarse mediante una operación de arrastrar y colocar.Gets or sets whether columns in a GridView can be reordered by a drag-and-drop operation.

ColumnHeaderContainerStyle ColumnHeaderContainerStyle ColumnHeaderContainerStyle ColumnHeaderContainerStyle

Obtiene o establece el estilo que se va a aplicar a los encabezados de columna.Gets or sets the style to apply to column headers.

ColumnHeaderContextMenu ColumnHeaderContextMenu ColumnHeaderContextMenu ColumnHeaderContextMenu

Obtiene o establece un control ContextMenu para el objeto GridView.Gets or sets a ContextMenu for the GridView.

ColumnHeaderStringFormat ColumnHeaderStringFormat ColumnHeaderStringFormat ColumnHeaderStringFormat

Obtiene o establece una cadena compuesta que especifica cómo se aplica formato a los encabezados de columna de GridView si se muestran como cadenas.Gets or sets a composite string that specifies how to format the column headers of the GridView if they are displayed as strings.

ColumnHeaderTemplate ColumnHeaderTemplate ColumnHeaderTemplate ColumnHeaderTemplate

Obtiene o establece la plantilla que se va a utilizar para mostrar los encabezados de columna.Gets or sets a template to use to display the column headers.

ColumnHeaderTemplateSelector ColumnHeaderTemplateSelector ColumnHeaderTemplateSelector ColumnHeaderTemplateSelector

Obtiene o establece el objeto de selector que proporciona la lógica para seleccionar la plantilla que se va a usar para cada encabezado de columna.Gets or sets the selector object that provides logic for selecting a template to use for each column header.

ColumnHeaderToolTip ColumnHeaderToolTip ColumnHeaderToolTip ColumnHeaderToolTip

Obtiene o establece el contenido de una información sobre herramientas que aparece cuando el puntero del mouse se sitúa sobre uno de los encabezados de columna.Gets or sets the content of a tooltip that appears when the mouse pointer pauses over one of the column headers.

Columns Columns Columns Columns

Obtiene la colección de objetos GridViewColumn definidos para este objeto GridView.Gets the collection of GridViewColumn objects that is defined for this GridView.

DefaultStyleKey DefaultStyleKey DefaultStyleKey DefaultStyleKey

Obtiene la referencia al estilo predeterminado del objeto GridView.Gets the reference for the default style for the GridView.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtiene el Dispatcher esto DispatcherObject está asociado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
GridViewItemContainerStyleKey GridViewItemContainerStyleKey GridViewItemContainerStyleKey GridViewItemContainerStyleKey

Obtiene la clave que hace referencia al estilo definido para cada ListViewItem de un objeto GridView.Gets the key that references the style that is defined for each ListViewItem in a GridView.

GridViewScrollViewerStyleKey GridViewScrollViewerStyleKey GridViewScrollViewerStyleKey GridViewScrollViewerStyleKey

Obtiene la clave que hace referencia al estilo definido para el control ScrollViewer que incluye el contenido mostrado por un objeto GridView.Gets the key that references the style that is defined for the ScrollViewer control that encloses the content that is displayed by a GridView.

GridViewStyleKey GridViewStyleKey GridViewStyleKey GridViewStyleKey

Obtiene la clave que hace referencia al estilo definido para el objeto GridView.Gets the key that references the style that is defined for the GridView.

IsSealed IsSealed IsSealed IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
ItemContainerDefaultStyleKey ItemContainerDefaultStyleKey ItemContainerDefaultStyleKey ItemContainerDefaultStyleKey

Obtiene la referencia al estilo predeterminado del contenedor de los elementos de datos en el objeto GridView.Gets the reference to the default style for the container of the data items in the GridView.

Propiedades adjuntas

ColumnCollection ColumnCollection ColumnCollection ColumnCollection

Obtiene o establece la propiedad adjunta que contiene el elemento GridViewColumnCollection.Gets or sets the attached property that contains the GridViewColumnCollection.

Métodos

AddChild(Object) AddChild(Object) AddChild(Object) AddChild(Object)

Agrega un objeto GridViewColumn a un objeto GridView.Adds a GridViewColumn object to a GridView.

AddText(String) AddText(String) AddText(String) AddText(String)

No se admite.Not supported.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearItem(ListViewItem) ClearItem(ListViewItem) ClearItem(ListViewItem) ClearItem(ListViewItem)

Quita todos los valores, enlaces y estilos de un control ListViewItem.Removes all settings, bindings, and styling from a ListViewItem.

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetAutomationPeer(ListView) GetAutomationPeer(ListView) GetAutomationPeer(ListView) GetAutomationPeer(ListView)

Obtiene la implementación de AutomationPeer para este objeto GridView.Gets the AutomationPeer implementation for this GridView object.

GetColumnCollection(DependencyObject) GetColumnCollection(DependencyObject) GetColumnCollection(DependencyObject) GetColumnCollection(DependencyObject)

Obtiene el contenido de la propiedad adjunta ColumnCollection.Gets the contents of the ColumnCollection attached property.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
PrepareItem(ListViewItem) PrepareItem(ListViewItem) PrepareItem(ListViewItem) PrepareItem(ListViewItem)

Prepara la presentación de un control ListViewItem de acuerdo con la definición de este objeto GridView.Prepares a ListViewItem for display according to the definition of this GridView object.

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetColumnCollection(DependencyObject, GridViewColumnCollection) SetColumnCollection(DependencyObject, GridViewColumnCollection) SetColumnCollection(DependencyObject, GridViewColumnCollection) SetColumnCollection(DependencyObject, GridViewColumnCollection)

Establece el contenido de la propiedad adjunta ColumnCollection.Sets the contents of the ColumnCollection attached property.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen del valor.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeColumnCollection(DependencyObject) ShouldSerializeColumnCollection(DependencyObject) ShouldSerializeColumnCollection(DependencyObject) ShouldSerializeColumnCollection(DependencyObject)

Determina si se debe serializar la propiedad adjunta ColumnCollection.Determines whether to serialize the ColumnCollection attached property.

ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Devuelve una representación de cadena del objeto GridView.Returns the string representation of the GridView object.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Exige que el subproceso que realiza la llamada tenga acceso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Agrega un objeto secundario.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Agrega el contenido de texto de un nodo al objeto.Adds the text content of a node to the object.

Se aplica a

Consulte también: