Compartir a través de

Elementos DataGrid

El DataGrid control se compone de varios tipos de componentes especializados que funcionan juntos para mostrar y administrar datos tabulares. Comprender estos componentes y su relación con le DataGrid ayuda a personalizar la apariencia y el comportamiento de la cuadrícula de datos para satisfacer sus necesidades específicas.

Información general sobre elementos

DataGrid consta de los siguientes elementos principales:

  • DataGridCell : representa una celda individual dentro de la cuadrícula que muestra un único valor de datos.
  • DataGridRow : representa una fila de datos dentro de la cuadrícula, que contiene varias celdas.
  • DataGridRowHeader - Proporciona el área de encabezado de fila en el lado izquierdo de cada fila, que normalmente se usa para los indicadores de selección de filas.
  • DataGridColumnHeader : representa el encabezado de una columna, que suele mostrar el título de la columna y proporcionar funcionalidad de ordenación.
  • DataGridColumnHeadersPresenter - Contiene y presenta todos los encabezados de columna en la fila superior de la cuadrícula.

Estos elementos se organizan jerárquicamente dentro de DataGrid para crear el diseño tabular conocido. DataGridColumnHeadersPresenter Muestra los encabezados de columna en la parte superior, mientras que cada DataGridRow contiene varios elementos DataGridCell junto con un DataGridRowHeader.

Personalización de elementos

Puede personalizar cada elemento aplicando estilos o modificando plantillas. Por ejemplo:

Para obtener más información sobre el estilo y la creación de plantillas, vea Aplicar estilos y plantillas.

DataGridCell

El DataGridCell elemento representa una celda individual dentro de la cuadrícula de datos y responde a las interacciones del usuario, como la selección y la edición.

Partes

El DataGridCell elemento no define ningún elemento de plantilla con nombre.

States

En la tabla siguiente se enumeran los estados visuales del DataGridCell elemento.

Nombre de VisualState Nombre de VisualStateGroup Description
Normal CommonStates Estado predeterminado.
pasar el ratón por encima CommonStates El puntero del mouse se coloca sobre la celda.
Focused FocusStates La celda tiene el foco.
Sin enfoque FocusStates La celda no tiene enfoque.
Current CurrentStates La celda es la misma actual.
Normal CurrentStates La celda no es la celda actual.
Display InteractionStates La celda está en modo de presentación.
Corrección InteractionStates La celda está en modo de edición.
Seleccionado SelectionStates La celda está seleccionada.
No seleccionado SelectionStates La celda no está seleccionada.
EnfoqueInválido Estados de Validación La celda no es válida y está enfocada.
InválidoSinEnfoque Estados de Validación La celda no es válida y no tiene el foco.
Validar Estados de Validación La celda es válida.

DataGridRow

El DataGridRow elemento representa una fila de datos dentro de la cuadrícula. Cada fila contiene varias celdas y un encabezado de fila.

Partes

El DataGridRow elemento no define ningún elemento de plantilla con nombre.

States

En la tabla siguiente se enumeran los estados visuales del DataGridRow elemento.

Nombre de VisualState Nombre de VisualStateGroup Description
Normal CommonStates Estado predeterminado.
pasar el ratón por encima CommonStates El puntero del ratón se coloca sobre la fila.
Edición de MouseOver CommonStates El puntero del mouse se coloca sobre la fila y la fila está en modo de edición.
Resaltado_Seleccionado CommonStates El puntero del mouse se coloca sobre la fila y se selecciona la fila.
Sobre_Ratón_No_Enfocado_Editando CommonStates El cursor está colocado sobre la fila, la fila está en modo de edición y no tiene el foco.
MouseOver_Unfocused_Selected CommonStates El puntero del ratón está posicionado sobre la fila, la fila está seleccionada y no tiene el foco.
Normal_AlternatingRow CommonStates La fila es una fila alterna.
Normal_Editing CommonStates La fila está en modo de edición.
Normal_Seleccionado CommonStates La fila está seleccionada.
Edición_Sin_Enfoque CommonStates La fila está en modo de edición y no tiene el foco.
No enfocado_Seleccionado CommonStates La fila está seleccionada y no tiene el foco.
EnfoqueInválido Estados de Validación El control no es válido y tiene el foco.
InválidoSinEnfoque Estados de Validación El control no es válido y no tiene el enfoque.
Validar Estados de Validación El control es válido.

DataGridRowHeader

El DataGridRowHeader elemento aparece en el lado izquierdo de cada fila y normalmente muestra indicadores de selección de fila o números de fila.

Partes

En la tabla siguiente se enumeran las partes con nombre para el DataGridRowHeader elemento .

Parte Tipo Description
PART_TopHeaderGripper Thumb Elemento que se usa para cambiar el tamaño del encabezado de fila de la parte superior.
PART_BottomHeaderGripper Thumb Elemento que se usa para cambiar el tamaño del encabezado de fila desde la parte inferior.

States

En la tabla siguiente se enumeran los estados visuales del DataGridRowHeader elemento.

Nombre de VisualState Nombre de VisualStateGroup Description
Normal CommonStates Estado predeterminado.
pasar el ratón por encima CommonStates El puntero del ratón se coloca sobre la fila.
MouseOver_CurrentRow CommonStates El puntero del mouse se coloca sobre la fila y la fila es la fila actual.
MouseOver_CurrentRow_Selected CommonStates El puntero del ratón se coloca sobre la fila, y la fila está actual y seleccionada.
Sin mejoras necesarias, ya que la traducción de términos de código o nombres de variables como "MouseOver_EditingRow" generalmente se mantiene en su idioma original por motivos de consistencia y funcionalidad en contextos técnicos. CommonStates El puntero del mouse se coloca sobre la fila y la fila está en modo de edición.
ResaltadoMouseOver_Selected CommonStates El puntero del mouse se coloca sobre la fila y se selecciona la fila.
PasarRatón_SinFoco_FilaActual_Seleccionada CommonStates El puntero del ratón está colocado sobre la fila, la fila es actual y está seleccionada, pero no tiene el foco.
RatónSobre_FilaEdición_NoEnfocada CommonStates El puntero del ratón se posiciona sobre la fila, la fila está en modo edición y no tiene el enfoque.
Al pasar el ratón_desEnfocado_Seleccionado CommonStates El puntero del ratón se encuentra sobre la fila, la fila está seleccionada, y no tiene el foco.
Normal_CurrentRow CommonStates La fila es la fila actual.
Normal_FilaActual_Seleccionada CommonStates La fila es la fila actual y está seleccionada.
Normal_EditingRow CommonStates La fila está en modo edición.
Normal_Seleccionado CommonStates La fila está seleccionada.
SinFoco_FilaActual_Seleccionada CommonStates La fila es la fila actual, está seleccionada y no tiene el foco.
FilaDeEdición_SinFoco CommonStates La fila está en modo de edición y no tiene el foco.
No enfocado_Seleccionado CommonStates La fila está seleccionada y no tiene el foco.
EnfoqueInválido Estados de Validación El control no es válido y tiene el foco.
InválidoSinEnfoque Estados de Validación El control no es válido y no tiene el enfoque.
Validar Estados de Validación El control es válido.

DataGridColumnHeadersPresenter

El DataGridColumnHeadersPresenter elemento contiene todos los encabezados de columna y los muestra en una fila en la parte superior de la cuadrícula de datos.

Partes

En la tabla siguiente se enumeran las partes con nombre para el DataGridColumnHeadersPresenter elemento .

Parte Tipo Description
PART_FillerColumnHeader DataGridColumnHeader Marcador de posición para los encabezados de columna.

States

En la tabla siguiente se enumeran los estados visuales del DataGridColumnHeadersPresenter elemento.

Nombre de VisualState Nombre de VisualStateGroup Description
EnfoqueInválido Estados de Validación La celda no es válida y está enfocada.
InválidoSinEnfoque Estados de Validación La celda no es válida y no tiene el foco.
Validar Estados de Validación La celda es válida.

EncabezadoDeColumnaDeCuadrículaDeDatos

El DataGridColumnHeader elemento representa el encabezado de una columna. Los encabezados de columna suelen mostrar el título de columna y proporcionar funcionalidad de ordenación al hacer clic en .

Partes

En la tabla siguiente se enumeran las partes con nombre para el DataGridColumnHeader elemento .

Parte Tipo Description
PART_LeftHeaderGripper Thumb Elemento que se usa para cambiar el tamaño del encabezado de columna de la izquierda.
PART_RightHeaderGripper Thumb Elemento que se usa para cambiar el tamaño del encabezado de columna de la derecha.

States

En la tabla siguiente se enumeran los estados visuales del DataGridColumnHeader elemento.

Nombre de VisualState Nombre de VisualStateGroup Description
Normal CommonStates Estado predeterminado.
pasar el ratón por encima CommonStates El puntero del mouse se coloca sobre el control.
Presionado CommonStates Se presiona el botón de control.
SortAscending SortStates La columna se ordena en orden ascendente.
SortDescending SortStates La columna se ordena en orden descendente.
Sin ordenación SortStates La columna no está ordenada.
EnfoqueInválido Estados de Validación El control no es válido y tiene el foco.
InválidoSinEnfoque Estados de Validación El control no es válido y no tiene el enfoque.
Validar Estados de Validación El control es válido.

Consulte también

  • Last updated on