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);
繼承階層架構
需求
標頭： 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 像素。