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à
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.