GridView Clase

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
[<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
Herencia
Atributos
Implementaciones

Ejemplos

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

La 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 botones que se derivan de ButtonBase , y 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 dato de pantalla 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 GridView como modo de vista para ListView , establezca la View propiedad en un GridView objeto.To specify a GridView as the view mode for a ListView, set the View property to a GridView object.

La GridView clase se deriva de 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: 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 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 un 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 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 GridViewColumn a GridView mediante la Columns propiedad y el Add método que se define para la 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. Del mismo modo, puede usar otros Collection<T> métodos 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 una GridView , defina un estilo para los ListViewItem controles de 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 control o Button , a una GridView , utilice 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.

Constructores

GridView()

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

Campos

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.

Propiedades

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.

(Heredado de DependencyObject)
Dispatcher

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

(Heredado de 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).

(Heredado de 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.

Propiedades adjuntas

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)

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.

(Heredado de 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.

(Heredado de 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.

(Heredado de 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.

(Heredado de 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.

(Heredado de 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 un código hash de este objeto DependencyObject.Gets a hash code for this DependencyObject.

(Heredado de 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.

(Heredado de DependencyObject)
GetType()

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

(Heredado de 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.

(Heredado de 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.

(Heredado de DependencyObject)
MemberwiseClone()

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

(Heredado de Object)
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. 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.

(Heredado de 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.

(Heredado de 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 del valor.Sets the value of a dependency property without changing its value source.

(Heredado de DependencyObject)
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.

(Heredado de 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.

(Heredado de 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 especificada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Heredado de 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.

(Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

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.

Se aplica a

Consulte también