Condividi tramite


Classe CMFCRibbonComboBox

La CMFCRibbonComboBox classe implementa un controllo casella combinata che è possibile aggiungere a una barra multifunzione, a un pannello della barra multifunzione o a un menu popup della barra multifunzione.

Sintassi

class CMFCRibbonComboBox : public CMFCRibbonEdit

Membri

Costruttori

Nome Descrizione
CMFCRibbonComboBox::CMFCRibbonComboBox Costruisce un oggetto CMFCRibbonComboBox.

Metodi pubblici

Nome Descrizione
CMFCRibbonComboBox::AddItem Aggiunge un elemento univoco alla casella di riepilogo.
CMFCRibbonComboBox::D eleteItem Elimina un elemento specificato dalla casella di riepilogo.
CMFCRibbonComboBox::EnableDropDownListResize Specifica se la casella di riepilogo può modificare le dimensioni quando viene eliminata.
CMFCRibbonComboBox::FindItem Restituisce l'indice del primo elemento della casella di riepilogo corrispondente a una stringa specificata.
CMFCRibbonComboBox::GetCount Restituisce il numero di elementi nella casella di riepilogo.
CMFCRibbonComboBox::GetCurSel Ottiene l'indice dell'elemento attualmente selezionato nella casella di riepilogo.
CMFCRibbonComboBox::GetDropDownHeight Ottiene l'altezza della casella di riepilogo quando la casella di riepilogo viene eliminata.
CMFCRibbonComboBox::GetIntermediateSize Restituisce le dimensioni della casella combinata visualizzata in modalità intermedia.
CMFCRibbonComboBox::GetItem Restituisce la stringa associata a un elemento in corrispondenza di un indice specificato nella casella di riepilogo.
CMFCRibbonComboBox::GetItemData Restituisce i dati associati a un elemento in corrispondenza di un indice specificato nella casella di riepilogo.
CMFCRibbonComboBox::HasEditBox Indica se il controllo contiene una casella di modifica.
CMFCRibbonComboBox::IsResizeDropDownList Indica se la casella di riepilogo può essere ridimensionata o meno.
CMFCRibbonComboBox::OnSelectItem Chiamato dal framework quando l'utente seleziona un elemento nella casella di riepilogo.
CMFCRibbonComboBox::RemoveAllItems Elimina tutti gli elementi dalla casella di riepilogo e cancella la casella di modifica.
CMFCRibbonComboBox::SelectItem Seleziona un elemento nella casella di riepilogo.
CMFCRibbonComboBox::SetDropDownHeight Imposta l'altezza della casella di riepilogo quando viene eliminata.

Osservazioni:

La casella combinata della barra multifunzione è costituita da una casella di riepilogo combinata con un'etichetta statica o un'etichetta che può essere modificata dall'utente. È necessario specificare il tipo desiderato quando si crea la casella combinata della barra multifunzione.

Esempio

Nell'esempio seguente viene illustrato come costruire un oggetto della CMFCRibbonComboBox classe , aggiungere un elemento alla casella combinata, selezionare un elemento nella casella combinata e aggiungere una casella combinata a un pannello.

// Create a simple combo box with two entries:
// The first parameter is the id of the combo box.
// The third parameter is the width of the combo box in pixels.
// The fourth parameter is the display label of the combo box.
// The fifth parameter is the index of the small image of the combo box.
CMFCRibbonComboBox *pComboSimple = new CMFCRibbonComboBox(-1, FALSE, -1, 0, -1);

// Add two items to the combo box and select the first item in the list:
pComboSimple->AddItem(_T("Hi!"));
pComboSimple->AddItem(_T("Hello!"));
pComboSimple->SelectItem(0);

// Add combo button to "Favorites" panel:
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(pComboSimple);

Gerarchia di ereditarietà

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

Requisiti

Intestazione: afxribboncombobox.h

CMFCRibbonComboBox::AddItem

Aggiunge un elemento univoco alla casella di riepilogo.

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

Parametri

lpszItem
[in] Stringa dell'elemento da aggiungere.

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

Valore restituito

Indice in base zero dell'elemento aggiunto.

CMFCRibbonComboBox::CMFCRibbonComboBox

Costruisce un oggetto CMFCRibbonComboBox.

public:
CMFCRibbonComboBox(
    UINT nID,
    BOOL bHasEditBox=TRUE,
    Int nWidth=-1,
    LPCTSTR lpszLabel=NULL,
    Int nImage=-1);

protected:
CMFCRibbonComboBox();

Parametri

nID
[in] ID della casella combinata.

bHasEditBox
[in] TRUE se si desidera una casella di modifica all'interno del controllo; FALSE in caso contrario.

nWidth
[in] Larghezza della casella combinata in pixel; o -1 per la larghezza predefinita.

lpszLabel
[in] Etichetta di visualizzazione della casella combinata.

nImage
[in] Indice dell'immagine piccola della casella combinata.

Osservazioni:

La larghezza predefinita è 108 pixel.

CMFCRibbonComboBox::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] Stringa dell'elemento da eliminare. Se sono presenti più elementi con la stessa stringa, il primo elemento viene eliminato.

Valore restituito

TRUE se l'elemento specificato è stato eliminato; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonComboBox::EnableDropDownListResize

Specifica se la casella di riepilogo può modificare le dimensioni quando viene eliminata.

void EnableDropDownListResize(BOOL bEnable=FALSE);

Parametri

bEnable
[in] TRUE per abilitare il ridimensionamento; FALSE per disabilitare il ridimensionamento.

Osservazioni:

Quando il ridimensionamento è abilitato, la casella di riepilogo cambierà le dimensioni in base agli elementi visualizzati.

CMFCRibbonComboBox::FindItem

Restituisce l'indice del primo elemento della casella di riepilogo corrispondente a una stringa specificata.

int FindItem(LPCTSTR lpszText) const;

Parametri

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

Valore restituito

Indice in base zero dell'elemento; o -1 se l'elemento non viene trovato.

Osservazioni:

CMFCRibbonComboBox::GetCount

Restituisce il numero di elementi nella casella di riepilogo.

INT_PTR GetCount() const;

Valore restituito

Numero di elementi nella casella di riepilogo o 0 se la casella di riepilogo non contiene elementi.

Osservazioni:

CMFCRibbonComboBox::GetCurSel

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

int GetCurSel() const;

Valore restituito

Indice in base zero dell'elemento attualmente selezionato nella casella di riepilogo; oppure -1 se non è selezionato alcun elemento.

CMFCRibbonComboBox::GetDropDownHeight

Ottiene l'altezza della casella di riepilogo quando la casella di riepilogo viene eliminata.

int GetDropDownHeight();

Valore restituito

Altezza, in pixel, della casella di riepilogo.

Osservazioni:

CMFCRibbonComboBox::GetIntermediateSize

Restituisce le dimensioni della casella combinata visualizzata in modalità intermedia.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo per la casella combinata.

Valore restituito

Dimensioni della casella combinata.

Osservazioni:

Le dimensioni restituite si basano sulle dimensioni della casella combinata quando vengono visualizzate immagini di piccole dimensioni.

CMFCRibbonComboBox::GetItem

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

LPCTSTR GetItem(int iIndex) 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 è selezionato alcun elemento nella casella combinata.

Osservazioni:

CMFCRibbonComboBox::GetItemData

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

DWORD_PTR GetItemData(int iIndex) const;

Parametri

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

Valore restituito

Dati associati all'elemento; oppure 0 se l'elemento non esiste o se il parametro di indice è -1 e non è presente alcun elemento selezionato nella casella di riepilogo.

CMFCRibbonComboBox::HasEditBox

Indica se il controllo contiene una casella di modifica.

BOOL HasEditBox() const;

Valore restituito

TRUE se il controllo contiene una casella di modifica; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonComboBox::IsResizeDropDownList

Indica se la casella di riepilogo può essere ridimensionata o meno.

BOOL IsResizeDropDownList() const;

Valore restituito

TRUE se la casella di riepilogo può essere ridimensionata; in caso contrario FALSE. CMFCRibbonComboBox::EnableDropDownListResize

Osservazioni:

È possibile abilitare il ridimensionamento delle caselle di riepilogo usando il metodo CMFCRibbonComboBox::EnableDropDownListResize .

CMFCRibbonComboBox::OnSelectItem

Chiamato dal framework quando un utente seleziona un elemento nella casella di riepilogo.

virtual void OnSelectItem(int nItem);

Parametri

nItem
[in] Indice dell'elemento selezionato.

Osservazioni:

Eseguire l'override di questo metodo se si desidera elaborare una selezione di input dell'utente.

CMFCRibbonComboBox::RemoveAllItems

Elimina tutti gli elementi dalla casella di riepilogo e cancella la casella di modifica.

void RemoveAllItems();

Osservazioni:

CMFCRibbonComboBox::SelectItem

Seleziona un elemento nella casella di riepilogo.

BOOL SelectItem(int iIndex);
BOOL SelectItem(DWORD_PTR dwData);

BOOL SelectItem(LPCTSTR lpszText);

Parametri

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

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

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

Valore restituito

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

Osservazioni:

CMFCRibbonComboBox::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.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCRibbonEdit