Classe di CCheckListBox

Articolo
03/05/2013

Fornisce la funzionalità di una casella di elenco di controllo di Windows.

class CCheckListBox : public CListBox

Membri

Costruttori pubblici

Nome	Descrizione
CCheckListBox::CCheckListBox	Costruisce un oggetto CCheckListBox.

Metodi pubblici

Nome	Descrizione
CCheckListBox::Create	Crea la casella di elenco di controllo di Windows e allegarlo all'oggetto CCheckListBox.
CCheckListBox::DrawItem	Chiamato dal framework quando un aspetto visivo di una casella di riepilogo del disegno personalizzato.
CCheckListBox::Enable	Abilita o disabilita un elemento della casella di elenco di controllo.
CCheckListBox::GetCheck	Ottiene lo stato della casella di controllo di un elemento.
CCheckListBox::GetCheckStyle	Ottiene lo stile del controllo.
CCheckListBox::IsEnabled	Determina se un elemento è abilitato.
CCheckListBox::MeasureItem	Chiamato dal framework quando una casella di riepilogo con uno stile del disegno personalizzato viene creata.
CCheckListBox::OnGetCheckPosition	Chiamato dal framework per ottenere la posizione della casella di controllo di un elemento.
CCheckListBox::SetCheck	Imposta lo stato della casella di controllo di un elemento.
CCheckListBox::SetCheckStyle	Consente di impostare lo stile del controllo.

Note

"Una casella di elenco di controllo" visualizzare un elenco di elementi, quali nomi file.Ogni elemento nell'elenco include una casella di controllo accanto che l'utente può controllare o deselezionare.

CCheckListBox è solo per i controlli creati dal proprietario perché l'elenco contiene più stringhe di testo.Nella sua forma più semplice, una casella di elenco di controllo contiene le stringhe di testo e caselle di controllo, ma non è necessario disporre di testo.Ad esempio, un elenco delle bitmap con una casella di controllo accanto a ciascun elemento.

Per creare una casella di elenco di controllo, è necessario derivare la classe da CCheckListBox.Per derivare la classe, creare un costruttore per la classe derivata, quindi chiamare Crea.

Se si desidera gestire i messaggi di notifica di Windows inviati da una casella di riepilogo al controllo padre (in genere una classe derivata da CDialog), aggiungere una voce della mappa messaggi e una funzione membro per la gestione dei messaggi nella classe padre per ogni messaggio.

Ogni voce della mappa messaggi accetta il formato seguente:

Notifica**(id, memberFxn)diON_**

dove specifica id la finestra figlio ID del controllo che invia una notifica e memberFxn è il nome della funzione membro che padre è stato scritto per gestire la notifica.

Il prototipo del padre è la seguente:

afx_msgvoidmemberFxn**( );**

Esiste una sola voce della mappa messaggi che riguarda specificatamente CCheckListBox (ma vedere anche le voci della mappa messaggi per CListBox):

ON_CLBN_CHKCHANGE l'utente ha modificato lo stato della casella di controllo di un elemento.

Se la casella di elenco di controllo è una casella predefinita dell'elenco di controllo (un elenco di stringhe con le caselle di controllo predefinito di ritaglio a sinistra di ogni), è possibile utilizzare l'impostazione CCheckListBox::DrawItem per disegnare la casella di elenco di controllo.In caso contrario, è necessario eseguire l'override della funzione CListBox::CompareItem e le funzioni CCheckListBox::MeasureItem e CCheckListBox::DrawItem.

È possibile creare una casella di elenco di controllo da un modello di finestra di dialogo o direttamente nel codice.