Classe CListBox

Articolo
06/10/2015

Fornisce la funzionalità di una casella di riepilogo di Windows.

class CListBox : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CListBox::CListBox	Costruisce un oggetto CListBox.

Metodi pubblici

Nome	Descrizione
CListBox::AddString	Aggiunge una stringa a una casella di riepilogo.
CListBox::CharToItem	Override per fornire WM_CHAR personalizzato che gestisce per le caselle di riepilogo del disegno personalizzato che non dispongono di stringhe.
CListBox::CompareItem	Chiamato dal framework per determinare la posizione di un nuovo elemento in una casella di riepilogo ordinata del disegno personalizzato.
CListBox::Create	Crea la casella di riepilogo di Windows e allegarlo all'oggetto CListBox.
CListBox::DeleteItem	Chiamato dal framework quando l'utente rimuove un elemento da una casella di riepilogo Owner Draw.
CListBox::DeleteString	Elimina una stringa di una casella di riepilogo.
CListBox::Dir	Aggiunge i nomi file, unità, entrambi nella directory corrente a una casella di riepilogo.
CListBox::DrawItem	Chiamato dal framework quando un aspetto visivo di una casella di riepilogo del disegno personalizzato.
CListBox::FindString	Cerca una stringa in una casella di riepilogo.
CListBox::FindStringExact	Cercare la prima stringa della casella di riepilogo che corrisponde a una stringa specificata.
CListBox::GetAnchorIndex	Recupera l'indice in base zero dell'elemento corrente di ancoraggio in una casella di riepilogo.
CListBox::GetCaretIndex	Determina il valore dell'elemento che presenta il rettangolo di attivazione in una casella di riepilogo a selezione multipla.
CListBox::GetCount	Restituisce il numero di stringhe in una casella di riepilogo.
CListBox::GetCurSel	Restituisce l'indice in base zero della stringa selezionata in una casella di riepilogo.
CListBox::GetHorizontalExtent	Restituisce la larghezza in pixel di una casella di riepilogo può essere scorre orizzontalmente.
CListBox::GetItemData	Restituisce il valore a 32 bit associato all'elemento della casella di riepilogo.
CListBox::GetItemDataPtr	Restituisce un puntatore a un elemento della casella di riepilogo.
CListBox::GetItemHeight	Determina l'altezza degli elementi in una casella di riepilogo.
CListBox::GetItemRect	Restituisce il rettangolo di delimitazione dell'elemento della casella di riepilogo mentre attualmente visualizzate.
CListBox::GetListBoxInfo	Recupera il numero di elementi di colonna.
CListBox::GetLocale	Recupera l'identificatore impostazioni locali per una casella di riepilogo.
CListBox::GetSel	Restituisce lo stato di selezione di un elemento della casella di riepilogo.
CListBox::GetSelCount	Restituisce il numero di stringhe attualmente selezionate in una casella di riepilogo a selezione multipla.
CListBox::GetSelItems	Restituisce gli indici di stringhe attualmente selezionate in una casella di riepilogo.
CListBox::GetText	Copia un elemento della casella di riepilogo in un buffer.
CListBox::GetTextLen	Restituisce la lunghezza in byte di un elemento della casella di riepilogo.
CListBox::GetTopIndex	Restituisce l'indice della prima stringa visibile in una casella di riepilogo.
CListBox::InitStorage	Preassegna i blocchi di memoria per gli elementi e le stringhe della casella di riepilogo.
CListBox::InsertString	Inserisce una stringa a una posizione specifica in una casella di riepilogo.
CListBox::ItemFromPoint	Restituisce l'indice dell'elemento della casella di riepilogo il più vicino un punto.
CListBox::MeasureItem	Chiamato dal framework quando una casella di riepilogo Owner Draw viene creata per determinare le dimensioni della casella di riepilogo.
CListBox::ResetContent	Rimuove tutte le voci di una casella di riepilogo.
CListBox::SelectString	Le ricerche di e selezionare una stringa in una casella di riepilogo a selezione singola.
CListBox::SelItemRange	Seleziona o deseleziona un intervallo delle stringhe in una casella di riepilogo a selezione multipla.
CListBox::SetAnchorIndex	Impostare l'ancoraggio in una casella di riepilogo a selezione multipla per avviare una selezione estesa.
CListBox::SetCaretIndex	Imposta il rettangolo di attivazione all'elemento all'indice specificato in una casella di riepilogo a selezione multipla.
CListBox::SetColumnWidth	Impostare la larghezza di una casella di riepilogo a più colonne.
CListBox::SetCurSel	Selezionare una stringa della casella di riepilogo.
CListBox::SetHorizontalExtent	Imposta la larghezza in pixel di una casella di riepilogo può essere scorre orizzontalmente.
CListBox::SetItemData	Imposta il valore a 32 bit associato all'elemento della casella di riepilogo.
CListBox::SetItemDataPtr	Imposta un puntatore all'elemento della casella di riepilogo.
CListBox::SetItemHeight	L'altezza degli elementi in una casella di riepilogo.
CListBox::SetLocale	Imposta l'identificatore impostazioni locali per una casella di riepilogo.
CListBox::SetSel	Seleziona o deseleziona un elemento della casella di riepilogo in una casella di riepilogo a selezione multipla.
CListBox::SetTabStops	Imposta le posizioni tabstop in una casella di riepilogo.
CListBox::SetTopIndex	Imposta l'indice in base zero della prima stringa visibile in una casella di riepilogo.
CListBox::VKeyToItem	Override per fornire WM_KEYDOWN personalizzato che gestisce per le caselle di riepilogo con il set di stile LBS_WANTKEYBOARDINPUT.

Note

Una casella di riepilogo viene visualizzato un elenco di elementi, quali nomi file, che l'utente può visualizzare e selezionare.

In una casella di riepilogo a selezione singola, l'utente può selezionare solo un elemento. In una casella di riepilogo a selezione multipla, un intervallo di elementi selezionabili. Quando l'utente seleziona un elemento, viene evidenziato e la casella di riepilogo invia un messaggio di notifica alla finestra padre.

È possibile creare una casella di riepilogo da un modello di finestra di dialogo o direttamente nel codice. Per crearla direttamente, costruire l'oggetto CListBox, quindi chiamare la funzione membro Crea per creare il controllo casella di riepilogo di Windows e per associarlo all'oggetto CListBox. Per utilizzare una casella di riepilogo in un modello di finestra di dialogo, dichiarare una variabile della casella di riepilogo nella classe della finestra di dialogo, quindi utilizzare DDX_Control nella funzione DoDataExchange della classe della finestra di dialogo per connettersi la variabile membro al controllo. Questa operazione viene eseguita automaticamente quando si aggiunge una variabile di controllo alla classe della finestra di dialogo.)

La costruzione può essere un processo una fase in una classe derivata da CListBox. Scrivere un costruttore per la classe derivata e chiamare Crea dal costruttore.

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:

ON_Notification( id, memberFxn )

dove specifica id la finestra figlio ID del controllo casella di riepilogo 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_msg void memberFxn( );

Segue un elenco di voci della mappa messaggi potenziali e una descrizione dei casi in cui verrà inviata al padre:

ON_LBN_DBLCLK l'utente fa doppio clic su una stringa in una casella di riepilogo. Solo una casella di riepilogo con lo stile LBS_NOTIFY invierà il messaggio di notifica.
ON_LBN_ERRSPACE la casella di riepilogo impossibile allocare memoria sufficiente per soddisfare la richiesta.
ON_LBN_KILLFOCUS la casella di riepilogo viene perdendo lo stato attivo per l'input.
ON_LBN_SELCANCEL la selezione corrente della casella di riepilogo viene annullato. Questo messaggio viene inviato solo quando una casella di riepilogo con lo stile LBS_NOTIFY.
ON_LBN_SELCHANGE che la selezione nella casella di riepilogo viene modificato. Questa notifica non viene inviata se la selezione viene modificata dalla funzione membro CListBox::SetCurSel. Questa notifica viene applicato solo a una casella di riepilogo con lo stile LBS_NOTIFY. Il messaggio di notifica LBN_SELCHANGE viene inviato per una casella di riepilogo a selezione multipla quando l'utente preme un tasto di direzione, anche se la selezione non cambia.
ON_LBN_SETFOCUS la casella di riepilogo riceve lo stato attivo per l'input.
ON_WM_CHARTOITEM una casella di riepilogo Owner Draw che non dispone di stringhe riceve un messaggio WM_CHAR.
La casella di riepilogo diON_WM_VKEYTOITEM con lo stile LBS_WANTKEYBOARDINPUT riceve un messaggio WM_KEYDOWN.

Se si crea un oggetto CListBox di una finestra di dialogo tramite una risorsa finestra di dialogo, l'oggetto CListBox automaticamente eliminato quando l'utente chiude la finestra di dialogo.

Se si crea un oggetto CListBox interno di una finestra, potrebbe essere necessario distruggere l'oggetto CListBox. Se si crea l'oggetto CListBox nello stack, verrà automaticamente eliminato. Se si crea l'oggetto CListBox nell'heap mediante la funzione new, è necessario chiamare delete sull'oggetto per distruggerlo quando l'utente chiude la finestra padre.

Se allocare memoria in qualsiasi oggetto CListBox, eseguire l'override del distruttore CListBox per disporre di allocazione.