共用方式為


CMFCRibbonComboBox 類別

類別 CMFCRibbonComboBox 會實作下拉式方塊控件,您可以新增至功能區列、功能區面板或功能區快捷功能表。

語法

class CMFCRibbonComboBox : public CMFCRibbonEdit

成員

建構函式

名稱 描述
CMFCRibbonComboBox::CMFCRibbonComboBox 建構 CMFCRibbonComboBox 物件。

公用方法

名稱 描述
CMFCRibbonComboBox::AddItem 將唯一專案附加至清單框。
CMFCRibbonComboBox::D eleteItem 從清單框中刪除指定的專案。
CMFCRibbonComboBox::EnableDropDownListResize 指定清單框是否可以在下拉式清單時變更大小。
CMFCRibbonComboBox::FindItem 傳回清單框中符合指定字串之第一個專案的索引。
CMFCRibbonComboBox::GetCount 傳回清單框中的項目數。
CMFCRibbonComboBox::GetCurSel 取得清單框中目前選取專案的索引。
CMFCRibbonComboBox::GetDropDownHeight 取得放下清單框時清單框的高度。
CMFCRibbonComboBox::GetIntermediateSize 傳回以中繼模式顯示的下拉式方塊大小。
CMFCRibbonComboBox::GetItem 傳回與清單框中指定索引處之項目相關聯的字串。
CMFCRibbonComboBox::GetItemData 傳回與清單框中指定索引處之專案相關聯的數據。
CMFCRibbonComboBox::HasEditBox 指出控制項是否包含編輯框。
CMFCRibbonComboBox::IsResizeDropDownList 指出清單框是否可以重設大小。
CMFCRibbonComboBox::OnSelectItem 當使用者在清單框中選取專案時,由架構呼叫。
CMFCRibbonComboBox::RemoveAllItems 從清單框刪除所有專案,並清除編輯框。
CMFCRibbonComboBox::SelectItem 選取清單框中的專案。
CMFCRibbonComboBox::SetDropDownHeight 設定下拉式清單框的高度。

備註

功能區下拉式方塊是由清單框所組成,結合用戶可編輯的靜態標籤或標籤。 當您建立功能區下拉式方塊時,必須指定您想要的類型。

範例

下列範例示範如何建構 類別的物件 CMFCRibbonComboBox 、將專案新增至下拉式方塊、選取下拉式方塊中的專案,以及將下拉式方塊新增至面板。

// 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);

繼承階層架構

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

需求

標頭: afxribboncombobox.h

CMFCRibbonComboBox::AddItem

將唯一專案附加至清單框。

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

參數

lpszItem
[in]要加入之專案的字串。

dwData
[in]與要加入之專案相關聯的數據。

傳回值

附加專案的以零起始的索引。

CMFCRibbonComboBox::CMFCRibbonComboBox

建構 CMFCRibbonComboBox 物件。

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

protected:
CMFCRibbonComboBox();

參數

nID
[in]下拉式方塊的標識碼。

bHasEditBox
[in]如果您想要控件內的編輯方塊,則為TRUE;否則為 FALSE。

nWidth
[in]以像素為單位的下拉式方塊寬度;或 -1 表示預設寬度。

lpszLabel
[in]下拉式方塊的顯示標籤。

nImage
[in]下拉式方塊的小型影像索引。

備註

默認寬度為 108 像素。

CMFCRibbonComboBox::D eleteItem

從清單框中刪除指定的專案。

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

BOOL DeleteItem(LPCTSTR lpszText);

參數

iIndex
[in]要刪除之專案之以零起始的索引。

dwData
[in]與要刪除之專案相關聯的數據。

lpszText
[in]要刪除之專案的字串。 如果有多個具有相同字串的專案,則會刪除第一個專案。

傳回值

如果已刪除指定的專案,則為TRUE;否則為 FALSE。

備註

CMFCRibbonComboBox::EnableDropDownListResize

指定清單框是否可以在下拉式清單時變更大小。

void EnableDropDownListResize(BOOL bEnable=FALSE);

參數

bEnable
[in]TRUE 可啟用重設大小;FALSE 表示停用重設大小。

備註

啟用重設大小時,清單框會變更大小以符合它顯示的專案。

CMFCRibbonComboBox::FindItem

傳回清單框中符合指定字串之第一個專案的索引。

int FindItem(LPCTSTR lpszText) const;

參數

lpszText
[in]清單框中專案的字串。

傳回值

專案以零起始的索引;如果找不到專案,則為 -1。

備註

CMFCRibbonComboBox::GetCount

傳回清單框中的項目數。

INT_PTR GetCount() const;

傳回值

清單框中的項目數,如果清單框不包含任何專案,則為 0。

備註

CMFCRibbonComboBox::GetCurSel

取得清單框中目前選取專案的索引。

int GetCurSel() const;

傳回值

清單框中目前選取專案的以零起始的索引;如果未選取任何專案,則為 -1。

CMFCRibbonComboBox::GetDropDownHeight

取得放下清單框時清單框的高度。

int GetDropDownHeight();

傳回值

清單框的高度,以像素為單位。

備註

CMFCRibbonComboBox::GetIntermediateSize

傳回以中繼模式顯示的下拉式方塊大小。

virtual CSize GetIntermediateSize(CDC* pDC);

參數

pDC
[in]下拉式方塊之裝置內容的指標。

傳回值

下拉式方塊的大小。

備註

傳回的大小是以顯示小型影像時下拉式方塊的大小為基礎。

CMFCRibbonComboBox::GetItem

傳回與清單框中指定索引處之項目相關聯的字串。

LPCTSTR GetItem(int iIndex) const;

參數

iIndex
[in]清單框中專案以零起始的索引。

傳回值

與專案相關聯的字串指標;否則,如果索引參數無效,或索引參數為 -1,且下拉式方塊中沒有選取任何專案,則為 NULL。

備註

CMFCRibbonComboBox::GetItemData

傳回與清單框中指定索引處之專案相關聯的數據。

DWORD_PTR GetItemData(int iIndex) const;

參數

iIndex
[in]清單框中專案以零起始的索引。

傳回值

與專案相關聯的數據;如果專案不存在,或索引參數為 -1,且清單框中沒有選取的專案,則為 0。

CMFCRibbonComboBox::HasEditBox

指出控制項是否包含編輯框。

BOOL HasEditBox() const;

傳回值

如果控件包含編輯框,則為TRUE;否則為 FALSE。

備註

CMFCRibbonComboBox::IsResizeDropDownList

指出清單框是否可以重設大小。

BOOL IsResizeDropDownList() const;

傳回值

如果清單框可以重設大小,則為TRUE;否則為 FALSE。 CMFCRibbonComboBox::EnableDropDownListResize

備註

您可以使用 CMFCRibbonComboBox::EnableDropDownListResize 方法來啟用清單框重設 大小

CMFCRibbonComboBox::OnSelectItem

當使用者在清單框中選取專案時,由架構呼叫。

virtual void OnSelectItem(int nItem);

參數

nItem
[in]所選取專案的索引。

備註

如果您想要處理使用者輸入選取專案,請覆寫此方法。

CMFCRibbonComboBox::RemoveAllItems

從清單框刪除所有專案,並清除編輯框。

void RemoveAllItems();

備註

CMFCRibbonComboBox::SelectItem

選取清單框中的專案。

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

BOOL SelectItem(LPCTSTR lpszText);

參數

iIndex
[in]清單框中專案以零起始的索引。

dwData
[in]與清單框中專案相關聯的數據。

lpszText
[in]清單框中專案的字串。

傳回值

如果方法成功,則為TRUE;否則為 FALSE。

備註

CMFCRibbonComboBox::SetDropDownHeight

設定下拉式清單框的高度。

void SetDropDownHeight(int nHeight);

參數

nHeight
[in]清單框的高度,以像素為單位。

備註

預設高度為 150 像素。

另請參閱

階層架構圖表
類別
CMFCRibbonEdit 類別