Classe CMFCToolBarComboBoxButton

Articolo
10/12/2023

Pulsante della barra degli strumenti che contiene un controllo casella combinata ( classe CComboBox).

Sintassi

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton	Costruisce un oggetto `CMFCToolBarComboBoxButton`.

Metodi pubblici

Nome	Descrizione
CMFCToolBarComboBoxButton::AddItem	Aggiunge un elemento alla fine dell'elenco di caselle combinate.
CMFCToolBarComboBoxButton::AddSortedItem	Aggiunge un elemento all'elenco casella combinata. L'ordine degli elementi nell'elenco è specificato da `Compare`.
CMFCToolBarComboBoxButton::Compare	Confronta due elementi. Chiamato per ordinare gli elementi aggiunti `AddSortedItems` all'elenco delle caselle combinate.
CMFCToolBarComboBoxButton::CreateEdit	Crea un nuovo controllo di modifica per il pulsante casella combinata.
CMFCToolBarComboBoxButton::D eleteItem	Elimina un elemento dall'elenco casella combinata.
CMFCToolBarComboBoxButton::FindItem	Restituisce l'indice dell'elemento che contiene una stringa specificata.
CMFCToolBarComboBoxButton::GetByCmd	Restituisce un puntatore al pulsante della casella combinata con un ID di comando specificato.
CMFCToolBarComboBoxButton::GetComboBox	Restituisce un puntatore al controllo casella combinata incorporato nel pulsante casella combinata.
CMFCToolBarComboBoxButton::GetCount	Restituisce il numero di elementi nell'elenco casella combinata.
CMFCToolBarComboBoxButton::GetCountAll	Trova il pulsante della casella combinata con un ID di comando specificato. Restituisce il numero di elementi nell'elenco casella combinata del pulsante.
CMFCToolBarComboBoxButton::GetCurSel	Restituisce l'indice dell'elemento selezionato nell'elenco casella combinata.
CMFCToolBarComboBoxButton::GetCurSelAll	Trova il pulsante della casella combinata con un ID comando specificato e restituisce l'indice dell'elemento selezionato nell'elenco casella combinata di tale pulsante.
CMFCToolBarComboBoxButton::GetEditCtrl	Restituisce un puntatore al controllo di modifica incorporato nel pulsante casella combinata.
CMFCToolBarComboBoxButton::GetItem	Restituisce la stringa associata a un indice specificato nell'elenco casella combinata.
CMFCToolBarComboBoxButton::GetItemAll	Trova il pulsante della casella combinata con un ID comando specificato e restituisce la stringa associata a un indice nell'elenco casella combinata del pulsante.
CMFCToolBarComboBoxButton::GetItemData	Restituisce il valore a 32 bit associato a un indice specificato nell'elenco delle caselle combinate.
CMFCToolBarComboBoxButton::GetItemDataAll	Trova il pulsante casella combinata con un ID comando specificato e restituisce il valore a 32 bit associato a un indice nell'elenco casella combinata di tale pulsante.
CMFCToolBarComboBoxButton::GetItemDataPtrAll	Trova il pulsante della casella combinata con un ID di comando specificato. Recupera il valore a 32 bit associato a un indice nell'elenco casella combinata del pulsante e restituisce il valore a 32 bit come puntatore.
CMFCToolBarComboBoxButton::GetText	Restituisce il testo dal controllo di modifica della casella combinata.
CMFCToolBarComboBoxButton::GetTextAll	Trova il pulsante della casella combinata con un ID comando specificato e restituisce il testo dal controllo di modifica di tale pulsante.
CMFCToolBarComboBoxButton::IsCenterVert	Determina se i pulsanti casella combinata nell'applicazione sono allineati al centro o allineati alla parte superiore della barra degli strumenti.
CMFCToolBarComboBoxButton::IsFlatMode	Determina se i pulsanti della casella combinata nell'applicazione hanno un aspetto piatto.
CMFCToolBarComboBoxButton::RemoveAllItems	Rimuove tutti gli elementi dalla casella di riepilogo e il controllo di modifica della casella combinata.
CMFCToolBarComboBoxButton::SelectItem	Seleziona un elemento nella casella combinata in base all'indice, al valore a 32 bit o alla stringa e invia una notifica al controllo casella combinata sulla selezione.
CMFCToolBarComboBoxButton::SelectItemAll	Trova il pulsante della casella combinata con un ID di comando specificato. Chiama `SelectItem` per selezionare un elemento nella casella combinata di tale pulsante in base alla stringa, all'indice o al valore a 32 bit.
CMFCToolBarComboBoxButton::SetCenterVert	Specifica se i pulsanti della casella combinata nell'applicazione sono allineati al centro verticalmente o allineati alla parte superiore della barra degli strumenti.
CMFCToolBarComboBoxButton::SetDropDownHeight	Imposta l'altezza della casella di riepilogo a discesa.
CMFCToolBarComboBoxButton::SetFlatMode	Specifica se i pulsanti della casella combinata nell'applicazione hanno un aspetto piatto.

Osservazioni:

Per aggiungere un pulsante casella combinata a una barra degli strumenti, seguire questa procedura:

Riservare un ID di risorsa fittizio per il pulsante nella risorsa della barra degli strumenti padre.
Costruire un CMFCToolBarComboBoxButton oggetto .
Nel gestore messaggi che elabora il messaggio AFX_WM_RESETTOOLBAR sostituire il pulsante fittizio con il nuovo pulsante casella combinata usando CMFCToolBar::ReplaceButton.

Per altre informazioni, vedere Procedura dettagliata: Inserimento di controlli sulle barre degli strumenti. Per un esempio di pulsante della barra degli strumenti della casella combinata, vedere il progetto di esempio VisualStudioDemo.

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCToolBarComboBoxButton . Nell'esempio viene illustrato come abilitare le caselle di modifica e combinate, impostare la posizione verticale dei pulsanti casella combinata nell'applicazione, impostare l'altezza della casella di riepilogo quando viene eliminata, impostare l'aspetto semplice dei pulsanti casella combinata nell'applicazione e impostare il testo nella casella di modifica del pulsante casella combinata. Questo frammento di codice fa parte dell'esempio demo di Visual Studio.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));

pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

Gerarchia di ereditarietà

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Requisiti

Intestazione: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

Aggiunge un elemento univoco alla casella di riepilogo.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parametri

lpszItem
[in] Testo dell'elemento da aggiungere alla casella di riepilogo.

dwData
[in] Dati associati all'elemento da aggiungere alla casella di riepilogo.

Valore restituito

Indice dell'ultimo elemento nella casella di riepilogo.

Osservazioni:

Non utilizzare questo metodo quando viene ordinato lo stile della casella di riepilogo.

Se il testo dell'elemento è già presente nella casella di riepilogo, i nuovi dati vengono archiviati con l'elemento esistente. La ricerca dell'elemento fa distinzione tra maiuscole e minuscole.

CMFCToolBarComboBoxButton::AddSortedItem

Aggiunge un elemento alla casella di riepilogo nell'ordine definito dal metodo Compare .

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parametri

lpszItem
[in] Testo dell'elemento da aggiungere alla casella di riepilogo.

dwData
[in] Dati associati all'elemento da aggiungere alla casella di riepilogo.

Valore restituito

Indice dell'elemento aggiunto alla casella di riepilogo.

Osservazioni:

Usare questa funzione per aggiungere elementi alla casella di riepilogo in un ordine specifico.

CMFCToolBarComboBoxButton::CanBeStretched

Indica se le dimensioni del pulsante della casella combinata possono cambiare.

virtual BOOL CanBeStretched() const;

Valore restituito

Restituisce TRUE.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Costruisce un oggetto CMFCToolBarComboBoxButton .

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

Parametri

uiID
[in] ID comando del nuovo pulsante.

iImage
[in] Indice immagine dell'immagine associata al nuovo pulsante.

dwStyle
[in] Stile del nuovo pulsante.

iWidth
[in] Larghezza, in pixel, del nuovo pulsante.

Osservazioni:

La larghezza predefinita è 150 pixel.

Per un elenco degli stili dei pulsanti della barra degli strumenti, vedere Stili di controllo della barra degli strumenti

CMFCToolBarComboBoxButton::ClearData

Elimina i dati definiti dall'utente.

virtual void ClearData();

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo in una classe derivata se si desidera eliminare dati definiti dall'utente.

CMFCToolBarComboBoxButton::Compare

Confronta due stringhe.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

Parametri

lpszItem1
[in] Prima stringa da confrontare.

lpszItem2
[in] Seconda stringa da confrontare.

Valore restituito

Valore che indica la relazione lessicografica con distinzione tra maiuscole e minuscole tra le stringhe. La tabella seguente elenca i possibili valori:

valore	Descrizione
<0	La prima stringa è minore del secondo.
0	La prima stringa è uguale alla seconda.
>0	La prima stringa è maggiore del secondo.

Osservazioni:

Eseguire l'override di questo metodo per modificare la modalità di ordinamento degli elementi nella casella di riepilogo.

Il confronto fa distinzione tra maiuscole e minuscole.

Questo metodo viene chiamato solo dal metodo AddSortedItem .

CMFCToolBarComboBoxButton::CopyFrom

Copia lo stato dell'oggetto specificato CMFCToolBarComboBoxButton nell'oggetto corrente.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametri

src
[in] Oggetto di origine CMFCToolBarComboBoxButton .

CMFCToolBarComboBoxButton::CreateCombo

Crea una nuova casella combinata per il pulsante casella combinata.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

Parametri

pWndParent
[in] Puntatore alla finestra padre del pulsante.

rect
[in] Rettangolo di delimitazione della casella combinata.

Valore restituito

Puntatore alla nuova casella combinata se il metodo ha avuto esito positivo; in caso contrario, NULL.

CMFCToolBarComboBoxButton::CreateEdit

Crea una nuova casella di modifica per il pulsante casella combinata.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

Parametri

pWndParent
[in] Puntatore alla finestra padre del pulsante.

rect
[in] Rettangolo di delimitazione della nuova casella di modifica.

dwEditStyle
[in] Stile di controllo della nuova casella di modifica.

Valore restituito

Puntatore alla nuova casella di modifica se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

Il framework chiama questo metodo quando crea una nuova casella di modifica per un pulsante casella combinata. Eseguire l'override di questo metodo per modificare la modalità di creazione di CMFCToolBarComboBoxEdit .

CMFCToolBarComboBoxButton::D eleteItem

Elimina un elemento specificato dalla casella di riepilogo.

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

Parametri

iIndex
[in] Indice in base zero dell'elemento da eliminare.

dwData
[in] Dati associati all'elemento da eliminare.

lpszText
[in] Testo dell'elemento da eliminare. Se sono presenti più elementi con lo stesso testo, il primo elemento viene eliminato.

Valore restituito

TRUE se l'elemento è stato individuato ed eliminato correttamente; in caso contrario, FALSE.

Osservazioni:

CMFCToolBarComboBoxButton::D uplicateData

Duplica i dati definiti dall'utente.

virtual void DuplicateData();

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo in una classe derivata se si desidera copiare dati definiti dall'utente.

CMFCToolBarComboBoxButton::EnableWindow

Abilita o disabilita le caselle combinate e di modifica.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare le caselle combinate e di modifica; FALSE per disabilitare le caselle combinate e di modifica.

Osservazioni:

Se disabilitato, i controlli non possono diventare attivi e non possono accettare l'input dell'utente.

CMFCToolBarComboBoxButton::ExportToMenuButton

Copia una stringa dalla tabella delle stringhe dell'applicazione nel menu specificato usando l'ID comando del pulsante casella combinata.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parametri

menuButton
[out] Riferimento a un pulsante di menu.

Valore restituito

Sempre TRUE.

CMFCToolBarComboBoxButton::FindItem

Restituisce l'indice del primo elemento nella casella di riepilogo contenente una stringa specificata.

int FindItem(LPCTSTR lpszText) const;

Parametri

lpszText
[in] Testo per il quale eseguire la ricerca nella casella di riepilogo.

Valore restituito

Indice dell'elemento; o CB_ERR se l'elemento non viene trovato.

Osservazioni:

CMFCToolBarComboBoxButton::GetByCmd

Ottiene un puntatore al pulsante della casella combinata con un ID comando specificato.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata.

bIsFocus
[in] TRUE per cercare solo pulsanti con stato attivo; FALSE per eseguire ricerche in tutti i pulsanti.

Valore restituito

Puntatore a un pulsante casella combinata; o NULL se il pulsante non viene trovato.

Osservazioni:

CMFCToolBarComboBoxButton::GetComboBox

Restituisce un puntatore alla casella combinata nel pulsante casella combinata.

CComboBox* GetComboBox() const;

Valore restituito

Puntatore all'oggetto Classe CComboBox se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

CMFCToolBarComboBoxButton::GetContextMenuID

Ottiene l'ID risorsa del menu di scelta rapida per il pulsante casella combinata.

UINT GetContextMenuID();

Valore restituito

ID risorsa del menu di scelta rapida.

CMFCToolBarComboBoxButton::GetCount

Restituisce il numero di elementi nella casella di riepilogo.

INT_PTR GetCount() const;

Valore restituito

Numero di elementi nella casella di riepilogo.

Osservazioni:

CMFCToolBarComboBoxButton::GetCountAll

Ottiene il numero di elementi nella casella di riepilogo di un pulsante casella combinata con un ID di comando specificato.

static int GetCountAll(UINT uiCmd);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata.

Valore restituito

Numero di elementi nella casella di riepilogo; in caso contrario, CB_ERR se il pulsante casella combinata non viene trovato.

Osservazioni:

CMFCToolBarComboBoxButton::GetCurSel

Ottiene l'indice dell'elemento attualmente selezionato nella casella di riepilogo.

int GetCurSel() const;

Valore restituito

Indice dell'elemento attualmente selezionato nella casella di riepilogo; o CB_ERR se non è selezionato alcun elemento.

Osservazioni:

L'indice della casella di riepilogo è in base zero.

CMFCToolBarComboBoxButton::GetCurSelAll

Restituisce l'indice dell'elemento attualmente selezionato nella casella di riepilogo di un pulsante casella combinata con un ID comando specificato.

static int GetCurSelAll(UINT uiCmd);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata.

Valore restituito

Indice dell'elemento attualmente selezionato nella casella di riepilogo; in caso contrario, CB_ERR se non viene selezionato alcun elemento o se non viene trovato alcun pulsante casella combinata.

Osservazioni:

L'indice della casella di riepilogo è in base zero.

CMFCToolBarComboBoxButton::GetEditCtrl

Restituisce un puntatore alla casella di modifica nel pulsante casella combinata.

virtual CEdit* GetEditCtrl();

Valore restituito

Puntatore alla casella di modifica se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

CMFCToolBarComboBoxButton::GetHwnd

Restituisce l'handle di finestra per la casella combinata.

virtual HWND GetHwnd();

Valore restituito

Handle di finestra o NULL se la casella combinata non è associata a un oggetto finestra.

CMFCToolBarComboBoxButton::GetItem

Restituisce la stringa associata a un elemento in corrispondenza di un indice specificato nella casella di riepilogo.

LPCTSTR GetItem(int iIndex=-1) const;

Parametri

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

Valore restituito

Puntatore alla stringa associata all'elemento; in caso contrario, NULL se il parametro di indice non è valido o se il parametro di indice è -1 e non è presente alcun elemento selezionato nella casella combinata.

Osservazioni:

Un parametro di indice di -1 restituisce la stringa dell'elemento attualmente selezionato.

CMFCToolBarComboBoxButton::GetItemAll

Restituisce la stringa associata a un elemento in corrispondenza di un indice specificato nella casella di riepilogo di un pulsante casella combinata con un ID di comando specificato.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata.

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

Valore restituito

Puntatore alla stringa dell'elemento se il metodo ha avuto esito positivo; in caso contrario, NULL se l'indice non è valido, non viene trovato un pulsante casella combinata oppure se l'indice è -1 e non è presente alcun elemento selezionato nella casella combinata.

Osservazioni:

Il valore di indice -1 restituisce la stringa dell'elemento attualmente selezionato.

CMFCToolBarComboBoxButton::GetItemData

Restituisce i dati associati a un elemento in corrispondenza di un indice specifico nella casella di riepilogo.

DWORD_PTR GetItemData(int iIndex=-1) const;

Parametri

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

Valore restituito

Dati associati all'elemento; o 0 se l'elemento non esiste.

Osservazioni:

Un parametro di indice di -1 restituisce i dati associati all'elemento attualmente selezionato.

CMFCToolBarComboBoxButton::GetItemDataAll

Restituisce i dati associati a un elemento in corrispondenza di un indice specifico nella casella di riepilogo di un pulsante casella combinata con un ID di comando specifico.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata.

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

Valore restituito

Dati associati all'elemento se il metodo ha avuto esito positivo; in caso contrario, 0 se l'indice specificato non è valido o CB_ERR se il pulsante della casella combinata non viene trovato.

Osservazioni:

Un parametro di indice di -1 restituisce i dati associati all'elemento attualmente selezionato.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

Restituisce i dati associati a un elemento in corrispondenza di un indice specifico nella casella di riepilogo di un pulsante casella combinata con un ID di comando specifico. Questi dati vengono restituiti come puntatore.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

Parametri

uiCmd
[in] ID comando del pulsante casella combinata.

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

Valore restituito

Puntatore associato all'elemento se il metodo ha avuto esito positivo; in caso contrario, -1 se si verifica un errore o NULL se il pulsante della casella combinata non viene trovato.

Osservazioni:

CMFCToolBarComboBoxButton::GetPrompt

Restituisce la stringa di richiesta per il pulsante casella combinata.

virtual CString GetPrompt() const;

Valore restituito

Stringa del prompt.

Osservazioni:

Questo metodo non è attualmente implementato.

CMFCToolBarComboBoxButton::GetText

Ottiene il testo nella casella di modifica.

LPCTSTR GetText() const;

Valore restituito

Testo nella casella di modifica.

Osservazioni:

CMFCToolBarComboBoxButton::GetTextAll

Ottiene il testo nella casella di modifica di un pulsante casella combinata con un ID comando specificato.

static LPCTSTR GetTextAll(UINT uiCmd);

Parametri

uiCmd
[in] ID comando di un pulsante casella combinata specifica.

Valore restituito

Testo nella casella di modifica se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

CMFCToolBarComboBoxButton::HasFocus

Indica se la casella combinata ha attualmente lo stato attivo.

virtual BOOL HasFocus() const;

Valore restituito

TRUE se la casella combinata ha attualmente lo stato attivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo restituisce TRUE anche se una finestra figlio della casella combinata ha attualmente lo stato attivo.

CMFCToolBarComboBoxButton::IsCenterVert

Restituisce la posizione verticale dei pulsanti casella combinata nell'applicazione.

static BOOL IsCenterVert();

Valore restituito

TRUE se i pulsanti sono centrati; FALSE se i pulsanti sono allineati in alto.

Osservazioni:

CMFCToolBarComboBoxButton::IsFlatMode

Restituisce l'aspetto semplice dei pulsanti casella combinata nell'applicazione.

static BOOL IsFlatMode();

Valore restituito

TRUE se i pulsanti hanno uno stile piatto; in caso contrario, FALSE.

Osservazioni:

Lo stile flat predefinito per i pulsanti della casella combinata è FALSE.

CMFCToolBarComboBoxButton::IsOwnerOf

Indica se l'handle specificato è associato al pulsante casella combinata o a uno dei relativi elementi figlio.

virtual BOOL IsOwnerOf(HWND hwnd);

Parametri

hwnd
[in] Handle di finestra.

Valore restituito

TRUE se l'handle è associato al pulsante della casella combinata o a uno dei relativi elementi figlio; in caso contrario, FALSE.

CMFCToolBarComboBoxButton::IsRibbonButton

Indica se il pulsante della casella combinata si trova in un pannello della barra multifunzione.

BOOL IsRibbonButton() const;

Valore restituito

Sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE, il che significa che il pulsante della casella combinata non viene mai visualizzato in un pannello della barra multifunzione.

CMFCToolBarComboBoxButton::IsWindowVisible

Restituisce lo stato di visibilità del pulsante casella combinata.

virtual BOOL IsWindowVisible();

Valore restituito

Stato di visibilità del pulsante casella combinata.

CMFCToolBarComboBoxButton::NotifyCommand

Indica se il pulsante casella combinata elabora il messaggio.

virtual BOOL NotifyCommand(int iNotifyCode);

Parametri

iNotifyCode
[in] Messaggio di notifica associato al comando.

Valore restituito

Indica se il pulsante della casella combinata elabora il messaggio.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

Chiamato dal framework quando il pulsante viene aggiunto alla finestra di dialogo Personalizza .

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

Chiamato dal framework per calcolare le dimensioni del pulsante.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante casella combinata.

sizeDefault
[in] Dimensioni predefinite del pulsante casella combinata.

bHorz
[in] Stato di ancoraggio della barra degli strumenti padre. TRUE quando la barra degli strumenti è ancorata orizzontalmente e FALSE quando la barra degli strumenti è ancorata verticalmente.

Valore restituito

Struttura SIZE che contiene le dimensioni del pulsante casella combinata, in pixel.

CMFCToolBarComboBoxButton::OnChangeParentWnd

Chiamato dal framework quando il pulsante casella combinata viene inserito in una nuova barra degli strumenti.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametri

pWndParent
[in] Puntatore alla nuova barra degli strumenti padre.

CMFCToolBarComboBoxButton::OnClick

Chiamato dal framework quando l'utente fa clic sul pulsante della casella combinata.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parametri

pWnd
[in] Puntatore alla finestra padre del pulsante casella combinata.

bDelay
[in] Riservato per l'uso in una classe derivata.

Valore restituito

TRUE se il metodo gestisce l'evento; in caso contrario, FALSE.

CMFCToolBarComboBoxButton::OnCtlColor

Chiamato dal framework quando l'utente modifica il colore della barra degli strumenti padre per impostare il colore del pulsante casella combinata.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante casella combinata.

nCtlColor
[in] Inutilizzato.

Valore restituito

Handle per il pennello utilizzato dal framework per disegnare lo sfondo del pulsante casella combinata.

Osservazioni:

Questo metodo imposta anche il colore del testo del pulsante casella combinata.

CMFCToolBarComboBoxButton::OnDraw

Chiamato dal framework per disegnare il pulsante casella combinata usando gli stili e le opzioni specificati.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parametri

Pdc
[in] Contesto del dispositivo che visualizza il pulsante.

rect
[in] Rettangolo di delimitazione del pulsante.

pImages
[in] Raccolta di immagini associate al pulsante.

bHorz
[in] Stato di ancoraggio della barra degli strumenti padre. TRUE quando la barra degli strumenti è ancorata orizzontalmente e FALSE quando la barra degli strumenti è ancorata verticalmente.

bCustomizeMode
[in] Indica se l'applicazione è in modalità di personalizzazione.

bHighlight
[in] Indica se disegnare il pulsante casella combinata evidenziato.

bDrawBorder
[in] Indica se disegnare il pulsante casella combinata con un bordo.

bGrayDisabledButtons
[in] TRUE per disegnare pulsanti disattivati ombreggiati; FALSE per usare la raccolta di immagini disabilitate.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

Chiamato dal framework per disegnare il pulsante della casella combinata nel riquadro Comandi della finestra di dialogo Personalizza .

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante casella combinata.

rect
[in] Rettangolo di delimitazione del pulsante casella combinata.

bSelected
[in] TRUE se il pulsante della casella combinata è selezionato; in caso contrario, FALSE.

Valore restituito

Larghezza, in pixel, del pulsante casella combinata.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

Chiamato dal framework per impostare il tipo di carattere del pulsante casella combinata quando il tipo di carattere dell'applicazione cambia.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

Chiamato dal framework per modificare la posizione del pulsante della casella combinata quando viene spostata la barra degli strumenti padre.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

Chiamato dal framework quando il pulsante casella combinata è nascosto o visualizzato.

virtual void OnShow(BOOL bShow);

Parametri

bShow
[in] Indica se nascondere o visualizzare il pulsante della casella combinata.

CMFCToolBarComboBoxButton::OnSize

Chiamato dal framework per modificare le dimensioni del pulsante casella combinata quando la barra degli strumenti padre cambia dimensione.

virtual void OnSize(int iSize);

Parametri

iSize
[in] Nuova larghezza del pulsante casella combinata.

CMFCToolBarComboBoxButton::OnUpdateToolTip

Chiamato dal framework quando l'utente modifica la descrizione comando per il pulsante casella combinata.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parametri

pWndParent
[in] Puntatore alla finestra padre per il pulsante casella combinata.

iButtonIndex
[in] ID del pulsante casella combinata.

wndToolTip
[in] Descrizione comando da associare al pulsante casella combinata.

str
[in] Testo della descrizione comando.

Valore restituito

TRUE se il metodo gestisce l'evento; in caso contrario, FALSE.

CMFCToolBarComboBoxButton::RemoveAllItems

Elimina tutti gli elementi dalle caselle di riepilogo e modifica.

void RemoveAllItems();

Osservazioni:

Rimuove tutti gli elementi dalla casella di riepilogo e il controllo di modifica di una casella combinata.

CMFCToolBarComboBoxButton::SelectItem

Seleziona un elemento nella casella di riepilogo.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

Parametri

iIndex
[in] Indice in base zero di un elemento nella casella di riepilogo.

bNotify
[in] TRUE per notificare al pulsante della casella combinata la selezione; in caso contrario FALSE.

dwData
[in] Dati associati a un elemento nella casella di riepilogo.

lpszText
[in] Testo di un elemento nella casella di riepilogo.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario FALSE.

Osservazioni:

CMFCToolBarComboBoxButton::SelectItemAll

Seleziona un elemento nella casella di riepilogo di un pulsante casella combinata con un ID comando specificato.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

Parametri

uiCmd
[in] ID comando del pulsante casella combinata che contiene la casella di riepilogo.

iIndex
[in] Indice in base zero dell'elemento nella casella di riepilogo. Il valore -1 rimuove qualsiasi selezione corrente nella casella di riepilogo e deseleziona la casella di modifica.

dwData
[in] Dati di un elemento nella casella di riepilogo.

lpszText
[in] Testo di un elemento nella casella di riepilogo.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario FALSE.

Osservazioni:

CMFCToolBarComboBoxButton::Serialize

Legge questo oggetto da un archivio o lo scrive in un archivio.

virtual void Serialize(CArchive& ar);

Parametri

Ar
[in, out] Oggetto CArchive da serializzare.

Osservazioni:

Le impostazioni nell'oggetto CArchive determinano se questo metodo legge o scrive nell'archivio.

CMFCToolBarComboBoxButton::SetACCData

Popola l'oggetto specificato CAccessibilityData usando i dati di accessibilità dal pulsante casella combinata.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametri

pParent
[in] Finestra padre del pulsante casella combinata.

data
[out] Oggetto CAccessibilityData che riceve i dati di accessibilità dal pulsante casella combinata.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario FALSE.

CMFCToolBarComboBoxButton::SetCenterVert

Imposta la posizione verticale dei pulsanti casella combinata nell'applicazione.

static void SetCenterVert(BOOL bCenterVert=TRUE);

Parametri

bCenterVert
[in] TRUE per centrare il pulsante della casella combinata sulla barra degli strumenti; FALSE per allineare il pulsante della casella combinata alla parte superiore della barra degli strumenti.

Osservazioni:

Per impostazione predefinita, i pulsanti della casella combinata sono allineati alla parte superiore.

CMFCToolBarComboBoxButton::SetContextMenuID

Imposta l'ID risorsa del menu di scelta rapida per il pulsante casella combinata.

void SetContextMenuID(UINT uiResID);

Parametri

uiResID
[in] ID risorsa del menu di scelta rapida.

CMFCToolBarComboBoxButton::SetDropDownHeight

Imposta l'altezza della casella di riepilogo quando viene eliminata.

void SetDropDownHeight(int nHeight);

Parametri

nHeight
[in] Altezza, in pixel, della casella di riepilogo.

Osservazioni:

L'altezza predefinita è 150 pixel.

CMFCToolBarComboBoxButton::SetFlatMode

Imposta l'aspetto dello stile piatto dei pulsanti casella combinata nell'applicazione.

static void SetFlatMode(BOOL bFlat=TRUE);

Parametri

bFlat
[in] TRUE per un aspetto di stile piatto; in caso contrario FALSE.

Osservazioni:

Lo stile flat predefinito per i pulsanti della casella combinata è FALSE.

CMFCToolBarComboBoxButton::SetStyle

Imposta lo stile specificato per il pulsante casella combinata e ridisegna il controllo se non è disabilitato.

virtual void SetStyle(UINT nStyle);

Parametri

nStyle
[in] Combinazione bit per bit (OR) degli stili della barra degli strumenti.

Osservazioni:

Per un elenco degli stili dei pulsanti della barra degli strumenti, vedere Stili di controllo della barra degli strumenti

CMFCToolBarComboBoxButton::SetText

Imposta il testo nella casella di modifica del pulsante casella combinata.

void SetText(LPCTSTR lpszText);

Parametri

lpszText
[in] Puntatore a una stringa contenente il testo per la casella di modifica.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBarButton
Classe CComboBox
CMFCToolBar::ReplaceButton
Procedura dettagliata: inserimento di controlli nelle barre degli strumenti

Condividi tramite

Classe CMFCToolBarComboBoxButton

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCToolBarComboBoxButton::AddItem

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::AddSortedItem

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::CanBeStretched

Valore restituito

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Parametri

Osservazioni:

CMFCToolBarComboBoxButton::ClearData

Osservazioni:

CMFCToolBarComboBoxButton::Compare

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::CopyFrom

Parametri

CMFCToolBarComboBoxButton::CreateCombo

Parametri

Valore restituito

CMFCToolBarComboBoxButton::CreateEdit

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::D eleteItem

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::D uplicateData

Osservazioni:

CMFCToolBarComboBoxButton::EnableWindow

Parametri

Osservazioni:

CMFCToolBarComboBoxButton::ExportToMenuButton

Parametri

Valore restituito

CMFCToolBarComboBoxButton::FindItem

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetByCmd

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetComboBox

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetContextMenuID

Valore restituito

CMFCToolBarComboBoxButton::GetCount

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetCountAll

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetCurSel

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetCurSelAll

Parametri

Valore restituito

Osservazioni:

CMFCToolBarComboBoxButton::GetEditCtrl

Valore restituito

Osservazioni: