DataGridTextColumn Clase

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Representa una columna DataGrid que hospeda contenido textual en sus celdas.

public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridTextColumn = class
    inherit DataGridBoundColumn

Public Class DataGridTextColumn
Inherits DataGridBoundColumn

Herencia

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridTextColumn

Ejemplos

En el ejemplo siguiente se crea un DataGrid que tiene columnas de texto personalizadas y usa datos XML como origen. En la ilustración anterior de este tema se muestra cómo se muestra este código. Para obtener más información sobre el enlace a datos XML, vea Cómo: Enlazar a datos XML mediante consultas XMLDataProvider y XPath.

<Window.Resources>
    <XmlDataProvider x:Key="customerdata" Source="customers.xml" XPath="Data" />
</Window.Resources>
<Grid>
    <DataGrid AutoGenerateColumns="False" ItemsSource="{Binding Source={StaticResource customerdata}, XPath=Customer}">
        <DataGrid.Columns>
            <DataGridTextColumn Header="First Name" Binding="{Binding XPath=@FirstName}" FontFamily="Arial" FontStyle="Italic" />
            <DataGridTextColumn Header="Last Name" Binding="{Binding XPath=@LastName}" FontFamily="Arial" FontWeight="Bold" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Comentarios

Use DataGridTextColumn para mostrar columnas de datos como texto. En la ilustración siguiente se muestra un ejemplo de dos tipos de DataGridTextColumn.

Para crear una columna, agréguela a la colección Columns. Para rellenar la columna, enlace la columna a los datos mediante la propiedad Binding. La propiedad Binding se aplica al elemento TextBlock o TextBox creado en la columna. El DataContext del elemento de cada celda es el elemento de datos de la fila en la que se encuentra la celda. Por lo tanto, para configurar el enlace, solo tiene que establecer el Binding.Path. Opcionalmente, puede especificar un Binding.Converter si desea convertir los datos o el StringFormat. Para obtener más información sobre el enlace de datos, vea Enlace de datos (WPF).

NotaDataGridTextColumn crea un elemento TextBlock en el modo de no edición y un elemento TextBox en el modo de edición.

Puede personalizar el DataGridTextColumn estableciendo propiedades, como Width, Header, FontSizey IsReadOnly.

Si desea mostrar otros tipos de datos, DataGrid proporciona los siguientes tipos de columna:

Tipo de columna	Visualización de datos
DataGridHyperlinkColumn	Use para mostrar datos de URI.
DataGridComboBoxColumn	Use para mostrar los datos de enumeración.
DataGridCheckBoxColumn	Use para mostrar datos booleanos.

Si desea usar otros controles de la DataGrid, puede crear sus propios tipos de columna mediante DataGridTemplateColumn.

Constructores

DataGridTextColumn()

Inicializa una nueva instancia de la clase DataGridTextColumn.

Campos

FontFamilyProperty	Identifica la propiedad de dependencia FontFamily.
FontSizeProperty	Identifica la propiedad de dependencia FontSize.
FontStyleProperty	Identifica la propiedad de dependencia FontStyle.
FontWeightProperty	Identifica la propiedad de dependencia FontWeight.
ForegroundProperty	Identifica la propiedad de dependencia Foreground.

Propiedades

ActualWidth	Obtiene el ancho actual de la columna, en unidades independientes del dispositivo (1/96 pulgadas por unidad). (Heredado de DataGridColumn)
Binding	Obtiene o establece el enlace que asocia la columna a una propiedad del origen de datos. (Heredado de DataGridBoundColumn)
CanUserReorder	Obtiene o establece un valor que indica si el usuario puede cambiar la posición de visualización de columna arrastrando el encabezado de columna. (Heredado de DataGridColumn)
CanUserResize	Obtiene o establece un valor que indica si el usuario puede ajustar el ancho de columna mediante el mouse. (Heredado de DataGridColumn)
CanUserSort	Obtiene o establece un valor que indica si el usuario puede ordenar la columna haciendo clic en el encabezado de columna. (Heredado de DataGridColumn)
CellStyle	Obtiene o establece el estilo que se usa para representar celdas en la columna. (Heredado de DataGridColumn)
ClipboardContentBinding	Obtiene o establece el objeto de enlace que se va a usar al obtener o establecer contenido de celda para el Portapapeles. (Heredado de DataGridBoundColumn)
DataGridOwner	Obtiene el control DataGrid que contiene esta columna. (Heredado de DataGridColumn)
DefaultEditingElementStyle	Valor predeterminado de la propiedad EditingElementStyle.
DefaultElementStyle	Valor predeterminado de la propiedad ElementStyle.
DependencyObjectType	Obtiene el DependencyObjectType que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el Dispatcher al que está asociado este DispatcherObject. (Heredado de DispatcherObject)
DisplayIndex	Obtiene o establece la posición de visualización de la columna en relación con las otras columnas de la DataGrid. (Heredado de DataGridColumn)
DragIndicatorStyle	Obtiene o establece el objeto de estilo que se va a aplicar al encabezado de columna durante una operación de arrastre. (Heredado de DataGridColumn)
EditingElementStyle	Obtiene o establece el estilo que se usa al representar el elemento que la columna muestra para una celda en modo de edición. (Heredado de DataGridBoundColumn)
ElementStyle	Obtiene o establece el estilo que se usa al representar el elemento que la columna muestra para una celda que no está en modo de edición. (Heredado de DataGridBoundColumn)
FontFamily	Obtiene o establece la familia de fuentes para el contenido de las celdas de la columna.
FontSize	Obtiene o establece el tamaño de fuente para el contenido de las celdas de la columna.
FontStyle	Obtiene o establece el estilo de fuente para el contenido de las celdas de la columna.
FontWeight	Obtiene o establece el peso de fuente para el contenido de las celdas de la columna.
Foreground	Obtiene o establece el Brush que se usa para pintar el contenido del texto de las celdas de la columna.
Header	Obtiene o establece el contenido del encabezado de columna. (Heredado de DataGridColumn)
HeaderStringFormat	Obtiene o establece el patrón de formato que se va a aplicar al contenido del encabezado de columna. (Heredado de DataGridColumn)
HeaderStyle	Obtiene o establece el estilo que se usa al representar el encabezado de columna. (Heredado de DataGridColumn)
HeaderTemplate	Obtiene o establece la plantilla que define la representación visual del encabezado de columna. (Heredado de DataGridColumn)
HeaderTemplateSelector	Obtiene o establece el objeto que selecciona la plantilla que se va a usar para el encabezado de columna. (Heredado de DataGridColumn)
IsAutoGenerated	Obtiene un valor que indica si la columna se genera automáticamente. (Heredado de DataGridColumn)
IsFrozen	Obtiene un valor que indica si se impide que la columna se desplace horizontalmente. (Heredado de DataGridColumn)
IsReadOnly	Obtiene o establece un valor que indica si se pueden editar las celdas de la columna. (Heredado de DataGridColumn)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
MaxWidth	Obtiene o establece la restricción de ancho máxima de la columna. (Heredado de DataGridColumn)
MinWidth	Obtiene o establece la restricción de ancho mínima de la columna. (Heredado de DataGridColumn)
SortDirection	Obtiene o establece la dirección de ordenación (ascendente o descendente) de la columna. (Heredado de DataGridColumn)
SortMemberPath	Obtiene o establece un nombre de propiedad, o una jerarquía delimitada por puntos de nombres de propiedad, que indica el miembro por el que se va a ordenar. (Heredado de DataGridColumn)
Visibility	Obtiene o establece la visibilidad de la columna. (Heredado de DataGridColumn)
Width	Obtiene o establece el ancho de columna o el modo de ajuste de tamaño automático. (Heredado de DataGridColumn)

Métodos

CancelCellEdit(FrameworkElement, Object)	Hace que la celda de columna que se edite revierta al valor especificado.
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. El identificador de DependencyProperty especifica la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. Un DependencyPropertyKeyespecifica la propiedad que se va a borrar. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada a DependencyObject. (Heredado de DependencyObject)
CommitCellEdit(FrameworkElement)	Realiza cualquier validación necesaria antes de salir del modo de edición.
Equals(Object)	Determina si un DependencyObject proporcionado es equivalente al DependencyObjectactual. (Heredado de DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Obtiene un control TextBox enlazado al valor de la propiedad Binding de la columna.
GenerateElement(DataGridCell, Object)	Obtiene un control de TextBlock de solo lectura enlazado al valor de propiedad Binding de la columna.
GetCellContent(DataGridRow)	Recupera el valor de la propiedad Content para la celda en la intersección de esta columna y la fila especificada. (Heredado de DataGridColumn)
GetCellContent(Object)	Obtiene el valor de propiedad Content para la celda en la intersección de esta columna y la fila que representa el elemento de datos especificado. (Heredado de DataGridColumn)
GetHashCode()	Obtiene un código hash para este DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
NotifyPropertyChanged(String)	Notifica al DataGrid que contiene esta columna que ha cambiado una propiedad de columna. (Heredado de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Notifica al DataGrid cuando cambia el valor de la propiedad Binding. (Heredado de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Determina el valor de la propiedad IsReadOnly en función de las reglas de propiedad de la cuadrícula de datos que contiene esta columna. (Heredado de DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Genera el evento CopyingCellClipboardContent. (Heredado de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Genera el evento PastingCellClipboardContent. (Heredado de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cada vez que se ha actualizado el valor efectivo de cualquier propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos del evento. (Heredado de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Se llama cuando una celda de la columna entra en modo de edición.
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
RefreshCellContent(FrameworkElement, String)	Actualiza el contenido de una celda de la columna en respuesta a un cambio de valor de propiedad de columna.
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)

Eventos

CopyingCellClipboardContent	Se produce después de preparar el contenido del Portapapeles de celda. (Heredado de DataGridColumn)
PastingCellClipboardContent	Se produce antes de que el contenido del Portapapeles se mueva a la celda. (Heredado de DataGridColumn)