GridViewColumn Class

Definition

Representa una columna que muestra datos.Represents a column that displays data.

public ref class GridViewColumn : System::Windows::DependencyObject, System::ComponentModel::INotifyPropertyChanged
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.ContentProperty("Header")]
[System.Windows.StyleTypedProperty(Property="HeaderContainerStyle", StyleTargetType=typeof(System.Windows.Controls.GridViewColumnHeader))]
public class GridViewColumn : System.Windows.DependencyObject, System.ComponentModel.INotifyPropertyChanged
type GridViewColumn = class
    inherit DependencyObject
    interface INotifyPropertyChanged
Public Class GridViewColumn
Inherits DependencyObject
Implements INotifyPropertyChanged
Inheritance
Attributes
Implements

Examples

En el ejemplo siguiente se muestra cómo definir objetos GridViewColumn para un GridView.The following example shows how to define GridViewColumn objects for a GridView.


<ListView ItemsSource="{Binding Source={StaticResource EmployeeData}, 
                                        XPath=Employee}">
  <ListView.View>       
    <GridView>
      <GridViewColumn Header="First Name"
               DisplayMemberBinding="{Binding XPath=FirstName}" />
      <GridViewColumn Header="Last Name"  
               CellTemplate="{StaticResource LastNameCellTemplate}"/>
      <GridViewColumn Header="Favorite City" 
               CellTemplateSelector="{DynamicResource 
                                      FavoriteCityTemplateSelector}"/>
    </GridView>
  </ListView.View>    
</ListView>

Remarks

El modo de vista de GridView utiliza un GridViewColumn para mostrar una columna de datos.A GridViewColumn is used by the GridView view mode to display a column of data. El ListView que implementa el modo de vista de GridView proporciona los datos para la columna.The ListView that implements the GridView view mode provides the data for the column. El enlace de datos se usa para especificar los datos de la GridViewColumn.You use data binding to specify the data for the GridViewColumn.

Puede utilizar la DisplayMemberBinding para definir los datos que se van a mostrar en una columna.You can use the DisplayMemberBinding to define the data to display in a column. También puede definir los datos como parte de una DataTemplate especificada por la propiedad CellTemplate.You can also define the data as part of a DataTemplate that is specified by the CellTemplate property. Si diferentes celdas tienen objetos DataTemplate diferentes, la propiedad CellTemplateSelector puede especificar una DataTemplateSelector.If different cells have different DataTemplate objects, the CellTemplateSelector property can specify a DataTemplateSelector. En la siguiente lista se muestran las propiedades que se mencionan aquí, en orden de prioridad, de mayor a menor:The following list shows the properties mentioned here, in their order of precedence from highest to lowest:

La clase GridViewColumn también contiene propiedades que puede utilizar para definir y personalizar el encabezado de columna para la columna.The GridViewColumn class also contains properties that you can use to define and customize the column header for the column. La propiedad Header puede definir el contenido del encabezado de columna.The Header property can define the content of the column header. Otras propiedades, como HeaderTemplate y HeaderContainerStyle también pueden especificar el contenido y el estilo del encabezado de columna.Other properties such as HeaderTemplate and HeaderContainerStyle can also specify content and style for the column header. Algunas de estas propiedades también se encuentran en otras clases como la clase GridViewColumnHeader.Some of these properties are also found on other classes such as the GridViewColumnHeader class. Para obtener más información sobre las propiedades que se usan para definir estilos y plantillas para los encabezados de columna, y para obtener información sobre el orden de prioridad de estas propiedades, vea información general sobre estilos y plantillas de encabezado de columna de GridView.For more information about the properties that are used to define styles and templates for column headers, and for information about the order of precedence for these properties, see GridView Column Header Styles and Templates Overview.

La clase GridViewColumn implementa la interfaz INotifyPropertyChanged.The GridViewColumn class implements the INotifyPropertyChanged interface. Esta interfaz proporciona la capacidad de suscribirse a los eventos que se producen cuando se produce un cambio en un valor de propiedad, como el valor de la propiedad ActualWidth.This interface provides the ability to subscribe to the events that occur when a change occurs to a property value, such as the ActualWidth property value.

Constructors

GridViewColumn()

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

Fields

CellTemplateProperty

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

CellTemplateSelectorProperty

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

HeaderContainerStyleProperty

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

HeaderProperty

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

HeaderStringFormatProperty

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

HeaderTemplateProperty

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

HeaderTemplateSelectorProperty

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

WidthProperty

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

Properties

ActualWidth

Obtiene el ancho real de una GridViewColumn.Gets the actual width of a GridViewColumn.

CellTemplate

Obtiene o establece la plantilla que debe utilizarse para mostrar el contenido de una celda de columna.Gets or sets the template to use to display the contents of a column cell.

CellTemplateSelector

Obtiene o establece DataTemplateSelector, que determina la plantilla que debe utilizarse para mostrar las celdas en una columna.Gets or sets a DataTemplateSelector that determines the template to use to display cells in a column.

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

Obtiene o establece el elemento de datos de enlace para esta columna.Gets or sets the data item to bind to for this column.

Header

Obtiene o establece el contenido del encabezado de GridViewColumn.Gets or sets the content of the header of a GridViewColumn.

HeaderContainerStyle

Obtiene o establece el estilo que se va a usar para el encabezado de la GridViewColumn.Gets or sets the style to use for the header of the GridViewColumn.

HeaderStringFormat

Obtiene o establece una cadena compuesta que especifica cómo se aplica formato a la propiedad Header si se muestra como una cadena.Gets or sets a composite string that specifies how to format the Header property if it is displayed as a string.

HeaderTemplate

Obtiene o establece la plantilla que se usará para mostrar el contenido del encabezado de columna.Gets or sets the template to use to display the content of the column header.

HeaderTemplateSelector

Obtiene o establece DataTemplateSelector, que proporciona la lógica necesaria para seleccionar la plantilla que debe utilizarse para mostrar el encabezado de columna.Gets or sets the DataTemplateSelector that provides logic to select the template to use to display the column header.

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

Obtiene o establece el ancho de la columna.Gets or sets the width of the column.

Methods

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)
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)
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)
OnHeaderStringFormatChanged(String, String)

Se produce cuando cambia la propiedad HeaderStringFormat.Occurs when the HeaderStringFormat property changes.

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

Inicia el evento INotifyPropertyChanged.PropertyChanged.Raises the INotifyPropertyChanged.PropertyChanged event.

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

Crea una representación de cadena del control GridViewColumn.Creates a string representation of the GridViewColumn.

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

INotifyPropertyChanged.PropertyChanged

Se produce cuando cambia el valor de cualquier propiedad de GridViewColumn.Occurs when the value of any GridViewColumn property changes.

Applies to

See also