共用方式為

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 類別