Condividi tramite

Elementi DataGrid

Il DataGrid controllo è costituito da diversi tipi di componenti specializzati che interagiscono per visualizzare e gestire i dati tabulari. La comprensione di questi componenti e della relativa relazione con DataGrid consente di personalizzare l'aspetto e il comportamento della griglia dati in base alle esigenze specifiche.

Panoramica degli elementi

È DataGrid costituito dagli elementi principali seguenti:

  • DataGridCell - Rappresenta una singola cella all'interno della griglia che visualizza un singolo valore di dati.
  • DataGridRow - Rappresenta una riga di dati all'interno della griglia contenente più celle.
  • DataGridRowHeader - Fornisce l'area dell'intestazione di riga sul lato sinistro di ogni riga, in genere utilizzata per gli indicatori di selezione delle righe.
  • DataGridColumnHeader - Rappresenta l'intestazione di una colonna, in genere visualizzando il titolo della colonna e fornendo funzionalità di ordinamento.
  • DataGridColumnHeadersPresenter - Contiene e presenta le intestazioni di tutte le colonne in una riga nella parte superiore della griglia.

Questi elementi sono disposti gerarchicamente all'interno di DataGrid per creare il layout tabulare familiare. DataGridColumnHeadersPresenter Visualizza le intestazioni di colonna nella parte superiore, mentre ognuna DataGridRow contiene più DataGridCell elementi insieme a un oggetto DataGridRowHeader.

Personalizzazione degli elementi

È possibile personalizzare ogni elemento applicando stili o modificando i modelli. Per esempio:

Per altre informazioni sull'applicazione di stili e modelli, vedere Applicazione di stili e modelli.

DataGridCell

L'elemento DataGridCell rappresenta una singola cella all'interno della griglia dati e risponde alle interazioni dell'utente, ad esempio la selezione e la modifica.

Parti

L'elemento DataGridCell non definisce parti di modello denominate.

States

Nella tabella seguente sono elencati gli stati di visualizzazione per l'elemento DataGridCell .

Nome VisualState Nome VisualStateGroup Description
Normal CommonStates Stato predefinito.
Mouseover CommonStates Il puntatore del mouse è posizionato sulla cella.
Focused FocusStates La cella ha il focus.
Non focalizzato FocusStates La cella non ha lo stato attivo.
Current CurrentStates La cella è la cella corrente.
Regolare CurrentStates La cella non è la cella corrente.
Display InteractionStates La cella è in modalità di visualizzazione.
Redazione InteractionStates La cella è in modalità di modifica.
Selezionato SelectionStates La cella è selezionata.
Opzione non selezionata SelectionStates La cella non è selezionata.
FuocoNonValido StatiDiValidazione La cella non è valida e ha lo stato attivo.
Non valido se non focalizzato StatiDiValidazione La cella non è valida e non è in focus.
Valido StatiDiValidazione La cella è valida.

DataGridRow

L'elemento DataGridRow rappresenta una riga di dati all'interno della griglia. Ogni riga contiene più celle e un'intestazione di riga.

Parti

L'elemento DataGridRow non definisce parti di modello denominate.

States

Nella tabella seguente sono elencati gli stati di visualizzazione per l'elemento DataGridRow .

Nome VisualState Nome VisualStateGroup Description
Normal CommonStates Stato predefinito.
Mouseover CommonStates Il puntatore del mouse è collocato sulla riga.
Modifica al Passaggio del Mouse CommonStates Il puntatore del mouse è posizionato sulla riga e la riga è in modalità di modifica.
MouseOver_Selected CommonStates Il puntatore del mouse è posizionato sulla riga e la riga è selezionata.
Passaggio_del_Mouse_Senza_Focus_Modifica CommonStates Il puntatore del mouse è posizionato sulla riga, la riga è in modalità di modifica e non ha lo stato attivo.
MouseOver_Inattivo_Selezionato CommonStates Il puntatore del mouse è posizionato sulla riga, la riga è selezionata e non ha lo stato attivo.
Normal_AlternatingRow CommonStates La riga è una riga alternata.
Normal_Editing CommonStates La riga è in modalità di modifica.
Selezionato_Normale CommonStates La riga è selezionata.
Modifica_Senza_Focus CommonStates La riga è in modalità di modifica e non è selezionata.
Non focalizzato_Selezionato CommonStates La riga è selezionata e non ha lo stato attivo.
FuocoNonValido StatiDiValidazione Il controllo non è valido ed ha il focus.
Non valido se non focalizzato StatiDiValidazione Il controllo non è valido e non è attualmente attivo.
Valido StatiDiValidazione Il controllo è valido.

DataGridRowHeader

L'elemento DataGridRowHeader viene visualizzato sul lato sinistro di ogni riga e in genere visualizza gli indicatori di selezione delle righe o i numeri di riga.

Parti

Nella tabella seguente sono elencate le parti denominate per l'elemento DataGridRowHeader .

Parte TIPO Description
PART_TopHeaderGripper Thumb Elemento utilizzato per ridimensionare l'intestazione di riga dalla parte superiore.
PART_BottomHeaderGripper Thumb Elemento utilizzato per ridimensionare l'intestazione di riga dalla parte inferiore.

States

Nella tabella seguente sono elencati gli stati di visualizzazione per l'elemento DataGridRowHeader .

Nome VisualState Nome VisualStateGroup Description
Normal CommonStates Stato predefinito.
Mouseover CommonStates Il puntatore del mouse è posizionato sulla riga.
PassaggioDelMouse_RigaCorrente CommonStates Il puntatore del mouse viene posizionato sulla riga e la riga è la riga corrente.
MouseOver_RigaCorrente_Selezionata CommonStates Il puntatore del mouse viene posizionato sulla riga, e la riga è attiva e selezionata.
MouseOver_EditingRow CommonStates Il puntatore del mouse è posizionato sulla riga e la riga è in modalità di modifica.
MouseOver_Selected CommonStates Il puntatore del mouse è posizionato sulla riga e la riga è selezionata.
MouseOver_Unfocused_CurrentRow_Selected CommonStates Il puntatore del mouse è posizionato sulla riga; la riga è attuale, selezionata e non ha lo stato attivo.
PassaggioDelMouse_SuRigaDiModificaNonFocalizzata CommonStates Il puntatore del mouse è posizionato sulla riga, la riga è in modalità di modifica e non ha il focus.
SopraColMouse_NonFocalizzato_Selezionato CommonStates Il puntatore del mouse è posizionato sulla riga, la riga è selezionata e non è attiva.
Normal_CurrentRow CommonStates La riga è la riga corrente.
Normal_CurrentRow_Selected CommonStates La riga è la riga corrente ed è selezionata.
Normal_EditingRow CommonStates La riga è in modalità di modifica.
Normale_Selezionato CommonStates La riga è selezionata.
Unfocused_CurrentRow_Selected CommonStates La riga è la riga corrente, è selezionata e non ha lo stato attivo.
Unfocused_EditingRow CommonStates La riga è in modalità di modifica e non è selezionata.
Non focalizzato_Selezionato CommonStates La riga è selezionata e non ha lo stato attivo.
FuocoNonValido StatiDiValidazione Il controllo non è valido ed ha il focus.
Non valido se non focalizzato StatiDiValidazione Il controllo non è valido e non è attualmente attivo.
Valido StatiDiValidazione Il controllo è valido.

DataGridColumnHeadersPresenter

L'elemento DataGridColumnHeadersPresenter contiene tutte le intestazioni di colonna e le visualizza in una riga nella parte superiore della griglia dati.

Parti

Nella tabella seguente sono elencate le parti denominate per l'elemento DataGridColumnHeadersPresenter .

Parte TIPO Description
PART_FillerColumnHeader DataGridColumnHeader Segnaposto per le intestazioni di colonna.

States

Nella tabella seguente sono elencati gli stati di visualizzazione per l'elemento DataGridColumnHeadersPresenter .

Nome VisualState Nome VisualStateGroup Description
FuocoNonValido StatiDiValidazione La cella non è valida e ha lo stato attivo.
Non valido se non focalizzato StatiDiValidazione La cella non è valida e non è in focus.
Valido StatiDiValidazione La cella è valida.

DataGridColumnHeader

L'elemento DataGridColumnHeader rappresenta l'intestazione di una colonna. Le intestazioni di colonna in genere visualizzano il titolo della colonna e forniscono funzionalità di ordinamento quando si fa clic.

Parti

Nella tabella seguente sono elencate le parti denominate per l'elemento DataGridColumnHeader .

Parte TIPO Description
PART_LeftHeaderGripper Thumb Elemento utilizzato per ridimensionare l'intestazione di colonna a sinistra.
PART_RightHeaderGripper Thumb Elemento utilizzato per ridimensionare l'intestazione di colonna dal lato destro.

States

Nella tabella seguente sono elencati gli stati di visualizzazione per l'elemento DataGridColumnHeader .

Nome VisualState Nome VisualStateGroup Description
Normal CommonStates Stato predefinito.
Mouseover CommonStates Il puntatore del mouse è posizionato sul controllo.
Premuto CommonStates Viene premuto il controllo .
Ordinamento crescente SortStates La colonna viene ordinata in ordine crescente.
Ordina in ordine decrescente SortStates La colonna è ordinata in ordine decrescente.
Non ordinato SortStates La colonna non è ordinata.
FuocoNonValido StatiDiValidazione Il controllo non è valido ed ha il focus.
Non valido se non focalizzato StatiDiValidazione Il controllo non è valido e non è attualmente attivo.
Valido StatiDiValidazione Il controllo è valido.

Vedere anche

  • Last updated on