GridView Class

Definition

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
Inheritance
Attributes
Implements

Examples

En el ejemplo siguiente se muestra cómo definir un control de ListView 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>

Remarks

La clase GridView y sus clases auxiliares proporcionan la infraestructura para mostrar los elementos de datos que se especifican para un control ListView 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 botones que se derivan de ButtonBasey puede 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 un GridView muestran datos y no proporcionan acceso directo al origen de los 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 modo de vista para un ListView, establezca la propiedad View en un objeto de GridView.To specify a GridView as the view mode for a ListView, set the View property to a GridView object.

La clase GridView se deriva de ViewBase.The GridView class is derived from ViewBase. Puede definir vistas personalizadas heredando de la clase ViewBase 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: crear un modo de vista personalizado para un control ListView.For more information, see How to: Create a Custom View Mode for a ListView.

En la ilustración siguiente se 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 salida de GridViewListView with GridView output

Las columnas de un GridView se definen como objetos GridViewColumn.The columns in a GridView are defined as GridViewColumn objects. En Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML), puede definir objetos GridViewColumn 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 al GridView mediante la propiedad Columns y el método Add que se define para la clase Collection<T>.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. Del mismo modo, puede usar otros métodos Collection<T> como Remove y Insert para modificar las columnas de un GridView.Similarly, you can use other Collection<T> methods such as Remove and Insert to modify the columns in a GridView.

En el ejemplo siguiente se muestra cómo definir las columnas de un 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 aplicar estilo a las filas de un GridView, defina un estilo para los controles de ListViewItem en la ListView.To style the rows in a GridView, define a style for the ListViewItem controls in the ListView.

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

Constructors

GridView()

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

Fields

AllowsColumnReorderProperty

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

ColumnCollectionProperty

Identifica la propiedad adjunta ColumnCollectionProperty.Identifies the ColumnCollectionProperty attachedproperty.

ColumnHeaderContainerStyleProperty

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

ColumnHeaderContextMenuProperty

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

ColumnHeaderStringFormatProperty

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

ColumnHeaderTemplateProperty

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

ColumnHeaderTemplateSelectorProperty

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

ColumnHeaderToolTipProperty

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

Properties

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

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

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

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

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

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

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

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

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

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

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
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

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

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

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

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.

Attached Properties

ColumnCollection

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

Methods

AddChild(Object)

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

AddText(String)

No compatible.Not supported.

CheckAccess()

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

(Inherited from DispatcherObject)
ClearItem(ListViewItem)

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

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)

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)

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)

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)

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

GetColumnCollection(DependencyObject)

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

GetHashCode()

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

(Inherited from DependencyObject)
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()

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

(Inherited from Object)
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)

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()

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

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se ha actualizado 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. La propiedad de dependencia específica que cambió se notifica en los datos de evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
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)

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)

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

SetCurrentValue(DependencyProperty, Object)

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

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

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

(Inherited from DependencyObject)
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)

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

ShouldSerializeProperty(DependencyProperty)

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

(Inherited from DependencyObject)
ToString()

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

VerifyAccess()

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

(Inherited from DispatcherObject)

Explicit Interface Implementations

IAddChild.AddChild(Object)

Agrega un objeto secundario.Adds a child object.

IAddChild.AddText(String)

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

Applies to

See also