DataGridTemplateColumn DataGridTemplateColumn DataGridTemplateColumn DataGridTemplateColumn Class

Definición

Representa una columna de DataGrid que hospeda el contenido específico de la plantilla en sus celdas.Represents a DataGrid column that hosts template-specified content in its cells.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn
public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn
type DataGridTemplateColumn = class
    inherit DataGridColumn
Public Class DataGridTemplateColumn
Inherits DataGridColumn
Herencia

Ejemplos

En el siguiente ejemplo se muestra cómo crear una clase DataGridTemplateColumn.The following example shows how to create a DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

La siguiente ilustración muestra la salida desde el XAML anterior.The following illustration shows the output from the previous XAML.

Una columna con DataTemplateA column using a DataTemplate

Comentarios

El DataGridTemplateColumn tipo le permite crear sus propios tipos de columna especificando las plantillas que se usará al mostrar y editar los valores de celda.The DataGridTemplateColumn type enables you to create your own column types by specifying the cell templates to use when displaying and editing values. Para especificar la plantilla que se usa para mostrar el contenido de una celda que no está en modo de edición, establezca el CellTemplate propiedad.To specify the template that is used to display the contents of a cell that is not in editing mode, set the CellTemplate property. Para especificar la plantilla que se usa para mostrar el contenido de una celda que está en modo de edición, establezca el CellEditingTemplate propiedad.To specify the template that is used to display the contents of a cell that is in editing mode, set the CellEditingTemplate property. Para obtener más información acerca de las plantillas, consulte Data Templating Overview y aplicar estilos y plantillas.For more information about templates, see Data Templating Overview and Styling and Templating.

Para mayor comodidad, DataGrid proporciona los siguientes tipos de columna predefinidos:For convenience, DataGrid provides the following pre-defined column types:

Tipo de columnaColumn Type Presentación de datosData Display
DataGridHyperlinkColumn Utilice esta opción para mostrar los datos URI.Use to display URI data.
DataGridComboBoxColumn Utilice esta opción para mostrar los datos de enumeración.Use to display enumeration data.
DataGridTextColumn Utilice esta opción para mostrar el texto.Use to display text.
DataGridCheckBoxColumn Use esta opción para mostrar datos booleanos.Use to display Boolean data.

Constructores

DataGridTemplateColumn() DataGridTemplateColumn() DataGridTemplateColumn() DataGridTemplateColumn()

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

Campos

CellEditingTemplateProperty CellEditingTemplateProperty CellEditingTemplateProperty CellEditingTemplateProperty

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

CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty

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

CellTemplateProperty CellTemplateProperty CellTemplateProperty CellTemplateProperty

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

CellTemplateSelectorProperty CellTemplateSelectorProperty CellTemplateSelectorProperty CellTemplateSelectorProperty

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

Propiedades

ActualWidth ActualWidth ActualWidth ActualWidth

Obtiene el ancho actual de la columna en unidades independientes de dispositivo (1/96 de pulgada por unidad)device-independent units (1/96th inch per unit).Gets the current width of the column, in unidades independientes de dispositivo (1/96 de pulgada por unidad)device-independent units (1/96th inch per unit).

(Inherited from DataGridColumn)
CanUserReorder CanUserReorder CanUserReorder CanUserReorder

Obtiene o establece un valor que indica si el usuario puede cambiar la posición de visualización de una columna arrastrando el encabezado de columna.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Inherited from DataGridColumn)
CanUserResize CanUserResize CanUserResize CanUserResize

Obtiene o establece un valor que indica si el usuario puede ajustar el ancho de columna mediante el mouse.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Inherited from DataGridColumn)
CanUserSort CanUserSort CanUserSort CanUserSort

Obtiene o establece un valor que indica si el usuario puede ordenar la columna haciendo clic en el encabezado de columna.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Inherited from DataGridColumn)
CellEditingTemplate CellEditingTemplate CellEditingTemplate CellEditingTemplate

Obtiene o establece la plantilla que se va a usar para mostrar el contenido de una celda que está en modo de edición.Gets or sets the template to use to display the contents of a cell that is in editing mode.

CellEditingTemplateSelector CellEditingTemplateSelector CellEditingTemplateSelector CellEditingTemplateSelector

Obtiene o establece el objeto que determina la plantilla que se va a usar para mostrar el contenido de una celda que está en modo de edición.Gets or sets the object that determines which template to use to display the contents of a cell that is in editing mode.

CellStyle CellStyle CellStyle CellStyle

Obtiene o establece el estilo que se utiliza para representar celdas en la columna.Gets or sets the style that is used to render cells in the column.

(Inherited from DataGridColumn)
CellTemplate CellTemplate CellTemplate CellTemplate

Obtiene o establece la plantilla que se usa para mostrar el contenido de una celda que no está en modo de edición.Gets or sets the template to use to display the contents of a cell that is not in editing mode.

CellTemplateSelector CellTemplateSelector CellTemplateSelector CellTemplateSelector

Obtiene o establece el objeto que determina la plantilla que se va a usar para mostrar el contenido de una celda que no está en modo de edición.Gets or sets the object that determines which template to use to display the contents of a cell that is not in editing mode.

ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding

Obtiene o establece el objeto de enlace que se va a usar al obtener o establecer el contenido de celda del Portapapeles.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Inherited from DataGridColumn)
DataGridOwner DataGridOwner DataGridOwner DataGridOwner

Obtiene el control DataGrid que contiene esta columna.Gets the DataGrid control that contains this column.

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

Obtiene o establece la posición de presentación de la columna con respecto a las demás columnas de DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Inherited from DataGridColumn)
DragIndicatorStyle DragIndicatorStyle DragIndicatorStyle DragIndicatorStyle

Obtiene o establece el objeto de estilo que se va a aplicar al encabezado de columna durante una operación de arrastre.Gets or sets the style object to apply to the column header during a drag operation.

(Inherited from DataGridColumn)
Header Header Header Header

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

(Inherited from DataGridColumn)
HeaderStringFormat HeaderStringFormat HeaderStringFormat HeaderStringFormat

Obtiene o establece el modelo de formato que se aplica al contenido del encabezado de columna.Gets or sets the format pattern to apply to the content of the column header.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Obtiene o establece el estilo que se usa al representar el encabezado de columna.Gets or sets the style that is used when rendering the column header.

(Inherited from DataGridColumn)
HeaderTemplate HeaderTemplate HeaderTemplate HeaderTemplate

Obtiene o establece la plantilla que define la representación visual del encabezado de columna.Gets or sets the template that defines the visual representation of the column header.

(Inherited from DataGridColumn)
HeaderTemplateSelector HeaderTemplateSelector HeaderTemplateSelector HeaderTemplateSelector

Obtiene o establece el objeto que selecciona la plantilla que se va a usar para el encabezado de columna.Gets or sets the object that selects which template to use for the column header.

(Inherited from DataGridColumn)
IsAutoGenerated IsAutoGenerated IsAutoGenerated IsAutoGenerated

Obtiene un valor que indica si la columna se genera automáticamente.Gets a value that indicates whether the column is auto-generated.

(Inherited from DataGridColumn)
IsFrozen IsFrozen IsFrozen IsFrozen

Obtiene un valor que indica si la columna no se puede desplazar horizontalmente.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Inherited from DataGridColumn)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtiene o establece un valor que indica si se pueden editar las celdas de la columna.Gets or sets a value that indicates whether cells in the column can be edited.

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

Obtiene o establece la restricción de ancho máximo de la columna.Gets or sets the maximum width constraint of the column.

(Inherited from DataGridColumn)
MinWidth MinWidth MinWidth MinWidth

Obtiene o establece la restricción de ancho mínimo de la columna.Gets or sets the minimum width constraint of the column.

(Inherited from DataGridColumn)
SortDirection SortDirection SortDirection SortDirection

Obtiene o establece la dirección de ordenación (ascendente o descendente) de la columna.Gets or sets the sort direction (ascending or descending) of the column.

(Inherited from DataGridColumn)
SortMemberPath SortMemberPath SortMemberPath SortMemberPath

Obtiene o establece un nombre de propiedad (o una jerarquía de nombres de propiedad delimitada por puntos) que indica el miembro por el que se debe ordenar.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Inherited from DataGridColumn)
Visibility Visibility Visibility Visibility

Obtiene o establece la visibilidad de la columna.Gets or sets the visibility of the column.

(Inherited from DataGridColumn)
Width Width Width Width

Obtiene o establece el ancho de columna o el modo de cambio de tamaño automático.Gets or sets the column width or automatic sizing mode.

(Inherited from DataGridColumn)

Métodos

CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object)

Hace que la celda de columna que se está editando se revierta al valor original, sin editar.Causes the cell being edited to revert to the original, unedited value.

(Inherited from DataGridColumn)
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)
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)
CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement)

Realiza todas las operaciones de validación necesarias antes de salir del modo de edición de celda.Performs any required validation before exiting cell editing mode.

(Inherited from DataGridColumn)
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)
GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object)

Obtiene un elemento definido por CellEditingTemplate que se enlaza al valor de la propiedad Binding de la columna.Gets an element defined by the CellEditingTemplate that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object)

Obtiene un elemento definido por CellTemplate que se enlaza al valor de la propiedad Binding de la columna.Gets an element defined by the CellTemplate that is bound to the column's Binding property value.

GetCellContent(DataGridRow) GetCellContent(DataGridRow) GetCellContent(DataGridRow) GetCellContent(DataGridRow)

Recupera el valor de la propiedad Content para la celda situada en la intersección de esta columna y la fila especificada.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Inherited from DataGridColumn)
GetCellContent(Object) GetCellContent(Object) GetCellContent(Object) GetCellContent(Object)

Obtiene el valor de la propiedad Content para la celda situada en la intersección de esta columna y la fila que representa el elemento de datos especificado.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Inherited from DataGridColumn)
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)
NotifyPropertyChanged(String) NotifyPropertyChanged(String) NotifyPropertyChanged(String) NotifyPropertyChanged(String)

Notifica al DataGrid que contiene esta columna que una propiedad de columna ha cambiado.Notifies the DataGrid that contains this column that a column property has changed.

(Inherited from DataGridColumn)
OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean)

Determina el valor de la propiedad IsReadOnly basándose en las reglas de propiedad del control DataGrid que contiene esta columna.Determines the value of the IsReadOnly property based on the property rules of the DataGrid that contains this column.

(Inherited from DataGridColumn)
OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object)

Genera el evento CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Inherited from DataGridColumn)
OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object)

Genera el evento PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Inherited from DataGridColumn)
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)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Cuando se reemplaza en una clase derivada, establece el contenido de la celda necesario para la edición.When overridden in a derived class, sets cell content as needed for editing.

(Inherited from DataGridColumn)
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)
RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String)

Actualiza el contenido de una celda de la columna como respuesta a un cambio en un valor de propiedad de la plantilla.Refreshes the contents of a cell in the column in response to a template property value change.

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)
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 cadena que representa el objeto actual.Returns a string that represents the current object.

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

Eventos

CopyingCellClipboardContent CopyingCellClipboardContent CopyingCellClipboardContent CopyingCellClipboardContent

Se produce después de prepararse el contenido del Portapapeles de la celda.Occurs after the cell clipboard content is prepared.

(Inherited from DataGridColumn)
PastingCellClipboardContent PastingCellClipboardContent PastingCellClipboardContent PastingCellClipboardContent

Se produce antes de que el contenido del Portapapeles se transfiera a la celda.Occurs before the clipboard content is moved to the cell.

(Inherited from DataGridColumn)

Se aplica a

Consulte también: