Procedura: visualizzare le intestazioni degli elementi in un controllo DataRepeater (Visual Studio)

Aggiornamento: Luglio 2008

L'intestazione elemento in un controllo DataRepeater fornisce un indicatore visivo della selezione di DataRepeaterItem. Se la proprietà LayoutStyle è impostata su Vertical (impostazione predefinita), l'intestazione elemento viene visualizzata a sinistra di ciascun elemento. Se la proprietà LayoutStyle è impostata su Horizontal, l'intestazione elemento viene visualizzata nella parte superiore di ciascun elemento.

Quando viene selezionata per la prima volta, l'intestazione elemento viene visualizzata nel colore specificato dalla proprietà SelectionColor e viene visualizzata un'icona costituita da una freccia bianca.

Nota:
Se la proprietà SelectionColor è impostata su White, il simbolo di selezione non sarà visibile quando l'elemento viene selezionato per la prima volta.

Quando un campo in DataRepeaterItem ha lo stato attivo, il colore dell'intestazione elemento passa al colore di sfondo di ItemTemplate e l'icona a forma di freccia diventa nera. Se i dati vengono modificati, nell'intestazione elemento viene visualizzato il simbolo di una matita.

La larghezza (oppure l'altezza, se la proprietà LayoutStyle è impostata su Horizontal) predefinita dell'intestazione elemento è di 15 pixel. Per modificare la larghezza, impostare la proprietà ItemHeaderSize.

Nota:
Se la proprietà ItemHeaderSize è impostata su un valore minore di 11, i simboli degli indicatori non verranno visualizzati nell'intestazione degli elementi.

Per nascondere le intestazioni degli elementi, impostare la proprietà ItemHeaderVisible su False. Quando la proprietà ItemHeaderVisible è impostata su False, la selezione di un elemento è indicata unicamente da una linea punteggiata attorno al perimetro di DataRepeaterItem.

Nota:
È inoltre possibile fornire un indicatore di selezione personalizzato monitorando la proprietà IsCurrent di DataRepeaterItem nell'evento DrawItem del controllo DataRepeater. Per ulteriori informazioni, vedere la classe IsCurrent.

Per modificare l'aspetto delle intestazioni degli elementi

1. In Progettazione Windows Form, selezionare l'area inferiore del controllo DataRepeater.

   Nota:
   Selezionare l'area inferiore del controllo. Selezionando l'area del modello di elemento, nella finestra Proprietà verrà visualizzato un diverso insieme di proprietà.

2. Nella finestra Proprietà, utilizzare la proprietà SelectionColor per modificare il colore delle intestazioni degli elementi.

   Nota:
   Se la proprietà SelectionColor è impostata su White, il simbolo di selezione non sarà visibile quando l'elemento viene selezionato per la prima volta.

3. Utilizzare la proprietà ItemHeaderSize per modificare la larghezza (o l'altezza) delle intestazioni degli elementi.

   Nota:
   Se la proprietà ItemHeaderSize è impostata su un valore minore di 11, i simboli degli indicatori non verranno visualizzati nell'intestazione degli elementi.

Per nascondere le intestazioni degli elementi

1. In Progettazione Windows Form, selezionare l'area inferiore del controllo DataRepeater.

   Nota:
   Selezionare l'area inferiore del controllo. Selezionando l'area del modello di elemento, nella finestra Proprietà verrà visualizzato un diverso insieme di proprietà.

2. Nella finestra Proprietà, impostare la proprietà ItemHeaderVisible su False.

   Quando viene selezionato un elemento in DataRepeater, tale selezione è indicata unicamente da una linea punteggiata attorno al perimetro di DataRepeaterItem.

Vedere anche

Attività

Procedura: modificare l'aspetto di un controllo DataRepeater (Visual Studio)

Procedura: modificare il layout di un controllo DataRepeater (Visual Studio)

Risoluzione dei problemi relativi al controllo DataRepeater (Visual Studio)

Concetti

Introduzione al controllo DataRepeater (Visual Studio)

Riferimenti

DataRepeater

Cronologia delle modifiche