Classe CVSListBox
La CVSListBox classe supporta un controllo elenco modificabile.
Sintassi
class CVSListBox : public CVSListBoxBase
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CVSListBox::CVSListBox | Costruisce un oggetto CVSListBox. |
CVSListBox::~CVSListBox |
Distruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CVSListBox::AddItem | Aggiunge una stringa a un controllo elenco. Esegue l'override di CVSListBoxBase::AddItem. |
| CVSListBox::EditItem | Avvia un'operazione di modifica sul testo di un elemento del controllo elenco. Esegue l'override di CVSListBoxBase::EditItem. |
| CVSListBox::GetCount | Recupera il numero di stringhe in un controllo elenco modificabile. Esegue l'override di CVSListBoxBase::GetCount. |
| CVSListBox::GetItemData | Recupera un valore a 32 bit specifico dell'applicazione associato a un elemento di controllo elenco modificabile. Esegue l'override di CVSListBoxBase::GetItemData. |
| CVSListBox::GetItemText | Recupera il testo di un elemento di controllo elenco modificabile. Esegue l'override di CVSListBoxBase::GetItemText. |
| CVSListBox::GetSelItem | Recupera l'indice in base zero dell'elemento attualmente selezionato in un controllo elenco modificabile. Esegue l'override di CVSListBoxBase::GetSelItem. |
CVSListBox::PreTranslateMessage |
Converte i messaggi della finestra prima che vengano inviati alle funzioni di Windows TranslateMessage e DispatchMessage . Per altre informazioni e sintassi del metodo, vedere CWnd::P reTranslateMessage. Esegue l'override di CVSListBoxBase::PreTranslateMessage. |
| CVSListBox::RemoveItem | Rimuove un elemento da un controllo elenco modificabile. Esegue l'override di CVSListBoxBase::RemoveItem. |
| CVSListBox::SelectItem | Seleziona una stringa di controllo elenco modificabile. Esegue l'override di CVSListBoxBase::SelectItem. |
| CVSListBox::SetItemData | Associa un valore a 32 bit specifico dell'applicazione a un elemento di controllo elenco modificabile. Esegue l'override di CVSListBoxBase::SetItemData. |
Metodi protetti
| Nome | Descrizione |
|---|---|
| CVSListBox::GetListHwnd | Restituisce l'handle al controllo visualizzazione elenco incorporato corrente. |
Osservazioni:
La CVSListBox classe fornisce un set di pulsanti di modifica che consentono all'utente di creare, modificare, eliminare o ridisporre gli elementi in un controllo elenco.
Di seguito è riportata un'immagine del controllo elenco modificabile. La seconda voce di elenco, denominata "Item2", è selezionata per la modifica.
Se si usa l'editor di risorse per aggiungere un controllo elenco modificabile, si noti che il riquadro Casella degli strumenti dell'editor non fornisce un controllo elenco modificabile predefinito. Aggiungere invece un controllo statico, ad esempio il controllo Group Box . Il framework usa il controllo statico come segnaposto per specificare le dimensioni e la posizione del controllo elenco modificabile.
Per usare un controllo elenco modificabile in un modello di finestra di dialogo, dichiarare una CVSListBox variabile nella classe della finestra di dialogo. Per supportare lo scambio di dati tra la variabile e il controllo, definire una DDX_Control voce di macro nel DoDataExchange metodo della finestra di dialogo. Per impostazione predefinita, il controllo elenco modificabile viene creato senza pulsanti di modifica. Utilizzare il metodo CVSListBoxBase::SetStandardButtons ereditato per abilitare i pulsanti di modifica.
Per altre informazioni, vedere la directory Samples, l'esempio New Controls , i file Page3.cpp e Page3.h.
Gerarchia di ereditarietà
CVSListBoxBase
Requisiti
Intestazione: afxvslistbox.h
CVSListBox::AddItem
Aggiunge una stringa a un controllo elenco.
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
Parametri
strIext
[in] Riferimento a una stringa.
dwData
[in] Valore a 32 bit specifico dell'applicazione associato alla stringa. Il valore predefinito è 0.
iIndex
[in] Indice in base zero della posizione che conterrà la stringa. Se il parametro iIndex è -1, la stringa viene aggiunta alla fine dell'elenco. Il valore predefinito è -1.
Valore restituito
Indice in base zero della posizione della stringa nel controllo elenco.
Osservazioni:
Utilizzare il metodo CVSListBox::GetItemData per recuperare il valore specificato dal parametro dwData . Questo valore può essere un numero intero specifico dell'applicazione o un puntatore ad altri dati.
CVSListBox::CVSListBox
Costruisce un oggetto CVSListBox.
CVSListBox();
Valore restituito
Osservazioni:
CVSListBox::EditItem
Avvia un'operazione di modifica sul testo di un elemento del controllo elenco.
virtual BOOL EditItem(int iIndex);
Parametri
iIndex
[in] Indice in base zero di un elemento del controllo elenco.
Valore restituito
TRUE se l'operazione di modifica viene avviata correttamente; in caso contrario, FALSE.
Osservazioni:
L'utente avvia un'operazione di modifica facendo doppio clic sull'etichetta di un elemento oppure premendo F2 o BARRA SPAZIATRICE quando un elemento ha lo stato attivo.
CVSListBox::GetCount
Recupera il numero di stringhe in un controllo elenco modificabile.
virtual int GetCount() const;
Valore restituito
Numero di elementi nel controllo elenco.
Osservazioni:
Si noti che il conteggio è maggiore del valore di indice dell'ultimo elemento perché l'indice è in base zero.
CVSListBox::GetItemData
Recupera un valore a 32 bit specifico dell'applicazione associato a un elemento di controllo elenco modificabile.
virtual DWORD_PTR GetItemData(int iIndex) const;
Parametri
iIndex
[in] Indice in base zero di un elemento di controllo elenco modificabile.
Valore restituito
Valore a 32 bit associato all'elemento specificato.
Osservazioni:
Utilizzare il metodo CVSListBox::SetItemData o CVSListBox::AddItem per associare il valore a 32 bit all'elemento del controllo elenco. Questo valore può essere un numero intero specifico dell'applicazione o un puntatore ad altri dati.
CVSListBox::GetItemText
Recupera il testo di un elemento di controllo elenco modificabile.
virtual CString GetItemText(int iIndex) const;
Parametri
iIndex
[in] Indice in base zero di un elemento di controllo elenco modificabile.
Valore restituito
Oggetto CString che contiene il testo dell'elemento specificato.
Osservazioni:
CVSListBox::GetListHwnd
Restituisce l'handle al controllo visualizzazione elenco incorporato corrente.
virtual HWND GetListHwnd() const;
Valore restituito
Handle per il controllo visualizzazione elenco incorporato.
Osservazioni:
Utilizzare questo metodo per recuperare un handle per il controllo visualizzazione elenco incorporato che supporta la CVSListBox classe .
CVSListBox::GetSelItem
Recupera l'indice in base zero dell'elemento attualmente selezionato in un controllo elenco modificabile.
virtual int GetSelItem() const;
Valore restituito
Se questo metodo ha esito positivo, l'indice in base zero dell'elemento attualmente selezionato; in caso contrario, -1.
Osservazioni:
CVSListBox::RemoveItem
Rimuove un elemento da un controllo elenco modificabile.
virtual BOOL RemoveItem(int iIndex);
Parametri
iIndex
[in] Indice in base zero di un elemento di controllo elenco modificabile.
Valore restituito
TRUE se l'elemento specificato viene rimosso; in caso contrario, FALSE.
Osservazioni:
CVSListBox::SelectItem
Seleziona una stringa di controllo elenco modificabile.
virtual BOOL SelectItem(int iItem);
Parametri
iItem
[in] Indice in base zero di un elemento di controllo elenco modificabile.
Valore restituito
TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.
Osservazioni:
Questo metodo seleziona l'elemento specificato e, se necessario, scorre l'elemento nella visualizzazione.
CVSListBox::SetItemData
Associa un valore a 32 bit specifico dell'applicazione a un elemento di controllo elenco modificabile.
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
Parametri
iIndex
[in] Indice in base zero di un elemento di controllo elenco modificabile.
dwData
[in] Valore a 32 bit. Questo valore può essere un numero intero specifico dell'applicazione o un puntatore ad altri dati.