Cómo: Mostrar los encabezados de los elementos en un control DataRepeater (Visual Studio)

Actualización: Julio de 2008

El encabezado de elemento en un control DataRepeater proporciona un indicador visual cuando DataRepeaterItem está seleccionado. Si la propiedad LayoutStyle está establecida en Vertical (valor predeterminado), el encabezado de elemento se muestra a la izquierda de cada elemento. Si la propiedad LayoutStyle está establecida en Horizontal, el encabezado de elemento se muestra encima de cada elemento.

Al seleccionarlo por primera vez, el encabezado de elemento se muestra en el color especificado por la propiedad SelectionColor y aparece un icono de flecha blanca.

Nota:
Si establece SelectionColor en White, el símbolo de selección no estará visible al seleccionar por primera vez el elemento.

Cuando un campo de DataRepeaterItem tiene el foco, el color del encabezado de elemento cambia al color de fondo de ItemTemplate y el icono de flecha pasa a ser negro. Si se modifican datos, se muestra un símbolo de lápiz en el encabezado del elemento.

El ancho predeterminado (o el alto cuando la propiedad LayoutStyle está establecida en Horizontal) del encabezado de elemento es de 15 píxeles. Puede cambiar el ancho estableciendo la propiedad ItemHeaderSize.

Nota:
Si la propiedad ItemHeaderSize está establecida en un valor menor que 11, no se mostrarán los símbolos de indicador en el encabezado del elemento.

Puede ocultar los encabezados de elemento estableciendo la propiedad ItemHeaderVisible en False. Cuando ItemHeaderVisible está establecido en False, la única indicación de que un elemento está seleccionado es una línea de puntos alrededor del perímetro de DataRepeaterItem.

Nota:
También puede proporcionar su propio indicador de selección supervisando la propiedad IsCurrent de DataRepeaterItem en el evento DrawItem del control DataRepeater. Para obtener más información, vea IsCurrent.

Para cambiar la apariencia de los encabezados de elemento

1. En el Diseñador de Windows Forms, seleccione la región inferior del control DataRepeater.

   Nota:
   Debe seleccionar la región inferior del control. Si selecciona la sección de plantilla de elemento, aparecerá un conjunto de propiedades distinto en la ventana Propiedades.

2. En la ventana Propiedades, utilice la propiedad SelectionColor para cambiar el color de los encabezados de elemento.

   Nota:
   Si establece SelectionColor en White, el símbolo de selección no estará visible al seleccionar por primera vez el elemento.

3. Utilice la propiedad ItemHeaderSize para cambiar el ancho (o el alto) de los encabezados de elemento.

   Nota:
   Si la propiedad ItemHeaderSize está establecida en un valor menor que 11, no se mostrarán los símbolos de indicador en el encabezado del elemento.

Para ocultar los encabezados de elemento

1. En el Diseñador de Windows Forms, seleccione la región inferior del control DataRepeater.

   Nota:
   Debe seleccionar la región inferior del control. Si selecciona la sección de plantilla de elemento, aparecerá un conjunto de propiedades distinto en la ventana Propiedades.

2. En la ventana Propiedades, establezca la propiedad ItemHeaderVisible en False.

   Cuando un elemento de DataRepeater está seleccionado, la única indicación será una línea de puntos alrededor del perímetro de DataRepeaterItem.

Vea también

Tareas

Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio)

Cómo: Cambiar el diseño de un control DataRepeater (Visual Studio)

Solución de problemas del control DataRepeater (Visual Studio)

Conceptos

Introducción al control DataRepeater (Visual Studio)

Referencia

DataRepeater

Historial de cambios