共用方式為


CMFCToolBarComboBoxButton 類別

包含下拉式方塊控件的工具列按鈕( CComboBox 類別)。

語法

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

成員

公用建構函式

名稱 描述
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton 建構 CMFCToolBarComboBoxButton

公用方法

名稱 描述
CMFCToolBarComboBoxButton::AddItem 將專案加入下拉式方塊清單的結尾。
CMFCToolBarComboBoxButton::AddSortedItem 將專案加入下拉式方塊清單中。 清單中的項目順序是由 Compare指定。
CMFCToolBarComboBoxButton::Compare 比較兩個專案。 呼叫 以排序新增至下拉式方塊清單的專案 AddSortedItems
CMFCToolBarComboBoxButton::CreateEdit 建立下拉式方塊按鈕的新編輯控制件。
CMFCToolBarComboBoxButton::D eleteItem 從下拉式方塊清單中刪除專案。
CMFCToolBarComboBoxButton::FindItem 傳回包含指定字串之專案的索引。
CMFCToolBarComboBoxButton::GetByCmd 傳回具有指定命令標識碼的下拉式方塊按鈕指標。
CMFCToolBarComboBoxButton::GetComboBox 傳回下拉式方塊控件的指標,該控件內嵌在下拉式方塊按鈕中。
CMFCToolBarComboBoxButton::GetCount 傳回下拉式方塊清單中的項目數。
CMFCToolBarComboBoxButton::GetCountAll 尋找具有指定命令標識碼的下拉式方塊按鈕。 傳回該按鈕下拉式方塊清單中的項目數。
CMFCToolBarComboBoxButton::GetCurSel 會傳回下拉式方塊清單中的選取專案的索引。
CMFCToolBarComboBoxButton::GetCurSelAll 尋找具有指定命令標識碼的下拉式方塊按鈕,並在該按鈕的下拉式方塊清單中傳回所選專案的索引。
CMFCToolBarComboBoxButton::GetEditCtrl 傳回內嵌在下拉式方塊按鈕中的編輯控件指標。
CMFCToolBarComboBoxButton::GetItem 傳回與下拉式方塊清單中指定索引相關聯的字串。
CMFCToolBarComboBoxButton::GetItemAll 尋找具有指定命令標識碼的下拉式方塊按鈕,並傳回該按鈕下拉式方塊清單中與索引相關聯的字串。
CMFCToolBarComboBoxButton::GetItemData 傳回與下拉式方塊清單中指定索引相關聯的32位值。
CMFCToolBarComboBoxButton::GetItemDataAll 尋找具有指定命令標識碼的下拉式方塊按鈕,並傳回與該按鈕下拉式方塊清單中索引相關聯的 32 位值。
CMFCToolBarComboBoxButton::GetItemDataPtrAll 尋找具有指定命令標識碼的下拉式方塊按鈕。 擷取與該按鈕下拉式方塊清單中的索引相關聯的 32 位值,並將 32 位值當做指標傳回。
CMFCToolBarComboBoxButton::GetText 從下拉式方塊的編輯控件傳回文字。
CMFCToolBarComboBoxButton::GetTextAll 尋找具有指定命令標識碼的下拉式方塊按鈕,並從該按鈕的編輯控件傳回文字。
CMFCToolBarComboBoxButton::IsCenterVert 判斷應用程式中的下拉式方塊按鈕是置中還是對齊工具列頂端。
CMFCToolBarComboBoxButton::IsFlatMode 判斷應用程式中的下拉式方塊按鈕是否有一般外觀。
CMFCToolBarComboBoxButton::RemoveAllItems 從清單框移除所有專案,並編輯下拉式方塊的控件。
CMFCToolBarComboBoxButton::SelectItem 根據下拉式方塊中的專案索引、32 位值或字串,並通知下拉式方塊控件選取選取範圍。
CMFCToolBarComboBoxButton::SelectItemAll 尋找具有指定命令標識碼的下拉式方塊按鈕。 呼叫 SelectItem ,根據按鈕的字串、索引或32位值,在該按鈕的下拉式方塊中選取專案。
CMFCToolBarComboBoxButton::SetCenterVert 指定應用程式中的下拉式方塊按鈕是垂直置中還是對齊工具列頂端。
CMFCToolBarComboBoxButton::SetDropDownHeight 設定下拉式清單框的高度。
CMFCToolBarComboBoxButton::SetFlatMode 指定應用程式中的下拉式方塊按鈕是否具有一般外觀。

備註

若要將下拉式方塊按鈕新增至工具列,請遵循下列步驟:

  1. 為父工具列資源的按鈕保留假的資源 ID。

  2. CMFCToolBarComboBoxButton建構物件。

  3. 在處理AFX_WM_RESETTOOLBAR訊息的訊息處理程式中,使用 CMFCToolBar::ReplaceButton,將虛擬按鈕取代為新的下拉式方塊按鈕。

如需詳細資訊,請參閱 逐步解說:將控件放在工具欄上。 如需下拉式方塊工具列按鈕的範例,請參閱範例專案 VisualStudioDemo。

範例

下例示範如何在 CMFCToolBarComboBoxButton 類別中使用各種方法。 此範例示範如何啟用編輯和下拉式方塊,在應用程式中設定下拉式方塊按鈕的垂直位置、設定下拉式方塊按鈕的高度、在應用程式中設定下拉式方塊按鈕的平面樣式外觀,以及在下拉式方塊按鈕的編輯框中設定文字。 此代碼段是Visual Studio示範範例一部分。

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

繼承階層架構

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

需求

標頭: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

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

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

參數

lpszItem
[in]要加入至清單框的項目文字。

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

傳回值

清單框中最後一個專案的索引。

備註

排序列表框樣式時,請勿使用此方法。

如果專案文字已經在清單框中,新的數據會與現有的專案一起儲存。 專案的搜尋會區分大小寫。

CMFCToolBarComboBoxButton::AddSortedItem

依照 Compare 方法所定義的順序,將專案加入清單框。

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

參數

lpszItem
[in]要加入至清單框的項目文字。

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

傳回值

新增至清單框之專案的索引。

備註

使用此函式,以特定順序將專案新增至清單框。

CMFCToolBarComboBoxButton::CanBeStretched

指出下拉式方塊按鈕大小是否可以變更。

virtual BOOL CanBeStretched() const;

傳回值

傳回 TRUE。

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

建構 CMFCToolBarComboBoxButton 物件。

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

參數

uiID
[in]新按鈕的命令標識碼。

iImage
[in]與新按鈕相關聯的影像影像索引。

dwStyle
[in]新按鈕的樣式。

iWidth
[in]新按鈕的寬度,以像素為單位。

備註

默認寬度為150圖元。

如需工具列按鈕樣式的清單,請參閱 ToolBar控件樣式

CMFCToolBarComboBoxButton::ClearData

刪除使用者定義數據。

virtual void ClearData();

備註

根據預設,此方法不會執行任何動作。 如果您想要刪除任何使用者定義的數據,請覆寫衍生類別中的這個方法。

CMFCToolBarComboBoxButton::Compare

比較兩個字串。

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

參數

lpszItem1
[in]要比較的第一個字串。

lpszItem2
[in]要比較的第二個字串。

傳回值

值,表示字串之間區分大小寫的語匯關聯性。 下表列出可能的值:

描述
<0 第一個字串小於第二個字串。
0 第一個字串等於第二個字串。
>0 第一個字串大於第二個字串。

備註

覆寫此方法以變更專案在清單框中的排序方式。

比較會區分大小寫。

這個方法只會從 AddSortedItem 方法呼叫。

CMFCToolBarComboBoxButton::CopyFrom

將指定 CMFCToolBarComboBoxButton 的狀態複製到目前的物件。

virtual void CopyFrom(const CMFCToolBarButton& src);

參數

src
[in]來源 CMFCToolBarComboBoxButton 物件。

CMFCToolBarComboBoxButton::CreateCombo

為下拉式方塊按鈕建立新的下拉式方塊。

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

參數

pWndParent
[in]按鈕之父視窗的指標。

rect
[in]下拉式方塊的周框。

傳回值

如果方法成功,則為新下拉式方塊的指標;否則為 NULL。

CMFCToolBarComboBoxButton::CreateEdit

為下拉式方塊按鈕建立新的編輯框。

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

參數

pWndParent
[in]按鈕之父視窗的指標。

rect
[in]新編輯框的周框。

dwEditStyle
[in]新編輯框的控件樣式。

傳回值

如果方法成功,則為新編輯方塊的指標;否則為 NULL。

備註

架構會在建立下拉式方塊按鈕的新編輯方塊時呼叫此方法。 覆寫此方法以變更 CMFCToolBarComboBoxEdit 的建立方式

CMFCToolBarComboBoxButton::D eleteItem

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

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

參數

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

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

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

傳回值

如果專案已找到並成功刪除,則為TRUE;否則為 FALSE。

備註

CMFCToolBarComboBoxButton::D uplicateData

重複使用者定義數據。

virtual void DuplicateData();

備註

根據預設,此方法不會執行任何動作。 如果您想要複製任何使用者定義的數據,請覆寫衍生類別中的這個方法。

CMFCToolBarComboBoxButton::EnableWindow

啟用或停用編輯和下拉式方塊。

virtual void EnableWindow(BOOL bEnable = TRUE);

參數

bEnable
[in]TRUE 可啟用編輯和下拉式方塊;FALSE 表示停用編輯和下拉式方塊。

備註

停用時,控件無法變成作用中,且無法接受用戶輸入。

CMFCToolBarComboBoxButton::ExportToMenuButton

使用下拉式方塊按鈕命令標識碼,將字串從應用程式字串數據表複製到指定的功能表。

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

參數

menuButton
[out]功能表按鈕的參考。

傳回值

一律為 TRUE。

CMFCToolBarComboBoxButton::FindItem

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

int FindItem(LPCTSTR lpszText) const;

參數

lpszText
[in]清單框中要搜尋的文字。

傳回值

專案的索引;如果找不到專案,則為 或 CB_ERR。

備註

CMFCToolBarComboBoxButton::GetByCmd

取得具有指定命令標識碼的下拉式方塊按鈕指標。

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

bIsFocus
[in]TRUE 表示只搜尋焦點按鈕;FALSE 可搜尋所有按鈕。

傳回值

下拉式方塊按鈕的指標;如果找不到按鈕,則為 NULL。

備註

CMFCToolBarComboBoxButton::GetComboBox

傳回下拉式方塊按鈕中下拉式方塊的指標。

CComboBox* GetComboBox() const;

傳回值

如果方法成功,則為 CComboBox 類別 物件的指標,否則為 NULL。

備註

CMFCToolBarComboBoxButton::GetContextMenuID

取得下拉式方塊按鈕的快捷方式功能表資源標識碼。

UINT GetContextMenuID();

傳回值

快捷方式功能表資源標識碼。

CMFCToolBarComboBoxButton::GetCount

傳回清單框中的項目數。

INT_PTR GetCount() const;

傳回值

清單框中的項目數。

備註

CMFCToolBarComboBoxButton::GetCountAll

取得下拉式方塊按鈕清單框中具有指定命令標識碼的項目數。

static int GetCountAll(UINT uiCmd);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

傳回值

清單框中的項目數;否則,如果找不到下拉式方塊按鈕,CB_ERR。

備註

CMFCToolBarComboBoxButton::GetCurSel

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

int GetCurSel() const;

傳回值

清單框中目前選取專案的索引;如果未選取任何專案,則為 或 CB_ERR。

備註

清單框索引是以零起始。

CMFCToolBarComboBoxButton::GetCurSelAll

傳回下拉式方塊按鈕清單框中目前選取之專案的索引,該按鈕具有指定的命令標識符。

static int GetCurSelAll(UINT uiCmd);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

傳回值

清單框中目前選取專案的索引;否則,如果未選取任何專案或找不到下拉式方塊按鈕,則CB_ERR。

備註

清單框索引是以零起始。

CMFCToolBarComboBoxButton::GetEditCtrl

傳回下拉式方塊按鈕中編輯方塊的指標。

virtual CEdit* GetEditCtrl();

傳回值

如果方法成功,則為編輯方塊的指標;否則為 NULL。

備註

CMFCToolBarComboBoxButton::GetHwnd

傳回下拉式方塊的視窗句柄。

virtual HWND GetHwnd();

傳回值

視窗句柄,如果下拉式方塊與視窗對象沒有關聯,則為NULL。

CMFCToolBarComboBoxButton::GetItem

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

LPCTSTR GetItem(int iIndex=-1) const;

參數

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

傳回值

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

備註

-1 的索引參數會傳回目前選取之專案的字串。

CMFCToolBarComboBoxButton::GetItemAll

在具有指定命令標識碼的下拉式方塊按鈕清單框中,傳回與位於指定索引處之專案相關聯的字串。

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

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

傳回值

如果方法成功,則為專案字串的指標;否則,如果索引無效,找不到下拉式方塊按鈕,或索引為 -1,而且下拉式方塊中沒有選取的專案,則為 NULL。

備註

-1 的索引值會傳回目前選取之專案的字串。

CMFCToolBarComboBoxButton::GetItemData

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

DWORD_PTR GetItemData(int iIndex=-1) const;

參數

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

傳回值

與專案相關聯的數據;如果專案不存在,則為 0。

備註

-1 的索引參數會傳回與目前選取的專案相關聯的數據。

CMFCToolBarComboBoxButton::GetItemDataAll

在具有特定命令標識碼的下拉式方塊按鈕清單框中,傳回與專案相關聯的數據。

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

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

傳回值

如果方法成功,則與專案相關聯的數據;否則,如果指定的索引無效,則為 0,如果找不到下拉式方塊按鈕,則為 CB_ERR。

備註

-1 的索引參數會傳回與目前選取的專案相關聯的數據。

CMFCToolBarComboBoxButton::GetItemDataPtrAll

在具有特定命令標識碼的下拉式方塊按鈕清單框中,傳回與專案相關聯的數據。 此數據會以指標的形式傳回。

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

參數

uiCmd
[in]下拉式方塊按鈕的命令標識碼。

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

傳回值

如果方法成功,則為與專案相關聯的指標;否則,如果發生錯誤,則為 -1;如果找不到下拉式方塊按鈕,則為 NULL。

備註

CMFCToolBarComboBoxButton::GetPrompt

傳回下拉式方塊按鈕的提示字串。

virtual CString GetPrompt() const;

傳回值

提示字串。

備註

這個方法目前尚未實作。

CMFCToolBarComboBoxButton::GetText

取得編輯框中的文字。

LPCTSTR GetText() const;

傳回值

編輯框中的文字。

備註

CMFCToolBarComboBoxButton::GetTextAll

取得下拉式方塊按鈕之編輯方塊中具有指定命令標識符的文字。

static LPCTSTR GetTextAll(UINT uiCmd);

參數

uiCmd
[in]特定下拉式方塊按鈕的命令標識碼。

傳回值

如果方法成功,則編輯框中的文字;否則為 NULL。

備註

CMFCToolBarComboBoxButton::HasFocus

指出下拉式方塊目前是否有焦點。

virtual BOOL HasFocus() const;

傳回值

如果下拉式方塊目前有焦點,則為TRUE;否則為 FALSE。

備註

如果下拉式方塊的任何子視窗目前有焦點,這個方法也會傳回 TRUE。

CMFCToolBarComboBoxButton::IsCenterVert

傳回應用程式中下拉式方塊按鈕的垂直位置。

static BOOL IsCenterVert();

傳回值

如果按鈕置中,則為TRUE;如果按鈕對齊頂端,則為 FALSE。

備註

CMFCToolBarComboBoxButton::IsFlatMode

傳回應用程式中下拉式方塊按鈕的平面樣式外觀。

static BOOL IsFlatMode();

傳回值

如果按鈕有一般樣式,則為TRUE;否則為 FALSE。

備註

下拉式方塊按鈕的預設平面樣式為 FALSE。

CMFCToolBarComboBoxButton::IsOwnerOf

指出指定的句柄是否與下拉式方塊按鈕或其中一個子系相關聯。

virtual BOOL IsOwnerOf(HWND hwnd);

參數

hwnd
[in]視窗句柄。

傳回值

如果句柄是使用下拉式方塊按鈕或其中一個子系來配置,則為TRUE;否則為 FALSE。

CMFCToolBarComboBoxButton::IsRibbonButton

指出下拉式方塊按鈕是否位於功能區面板上。

BOOL IsRibbonButton() const;

傳回值

一律為 FALSE。

備註

根據預設,此方法一律會傳回 FALSE,這表示功能區面板上永遠不會顯示下拉式方塊按鈕。

CMFCToolBarComboBoxButton::IsWindowVisible

傳回下拉式方塊按鈕的可見性狀態。

virtual BOOL IsWindowVisible();

傳回值

下拉式方塊按鈕的可見性狀態。

CMFCToolBarComboBoxButton::NotifyCommand

指出下拉式方塊按鈕是否處理訊息。

virtual BOOL NotifyCommand(int iNotifyCode);

參數

iNotifyCode
[in]與命令相關聯的通知訊息。

傳回值

下拉式方塊按鈕是否處理訊息。

CMFCToolBarComboBoxButton::OnAddToCustomizePage

當按鈕新增至 [自定義 ] 對話框時,由架構呼叫。

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

由架構呼叫以計算按鈕的大小。

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

參數

pDC
[in]顯示下拉式方塊按鈕的裝置內容。

sizeDefault
[in]下拉式方塊按鈕的預設大小。

bHorz
[in]父工具列的停駐狀態。 當工具列水準停駐時為TRUE,當工具列垂直停駐時為 FALSE。

傳回值

SIZE結構,包含下拉式方塊按鈕的維度,以像素為單位。

CMFCToolBarComboBoxButton::OnChangeParentWnd

當下拉式方塊按鈕插入新的工具列時,由架構呼叫。

virtual void OnChangeParentWnd(CWnd* pWndParent);

參數

pWndParent
[in]新父工具列的指標。

CMFCToolBarComboBoxButton::OnClick

當使用者按下拉式方塊按鈕時,由架構呼叫。

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

參數

pWnd
[in]下拉式方塊按鈕之父視窗的指標。

bDelay
[in]保留供衍生類別使用。

傳回值

如果方法處理事件,則為TRUE;否則為 FALSE。

CMFCToolBarComboBoxButton::OnCtlColor

當使用者變更父工具列色彩以設定下拉式方塊按鈕色彩時,由架構呼叫。

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

參數

pDC
[in]顯示下拉式方塊按鈕的裝置內容。

nCtlColor
[in] 未使用。

傳回值

架構用來繪製下拉式方塊按鈕背景的筆刷句柄。

備註

這個方法也會設定下拉式方塊按鈕文字色彩。

CMFCToolBarComboBoxButton::OnDraw

由架構呼叫,以使用指定的樣式和選項繪製下拉式方塊按鈕。

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

參數

Pdc
[in]顯示按鈕的裝置內容。

rect
[in]按鈕的周框。

pImages
[in]與按鈕相關聯的影像集合。

bHorz
[in]父工具列的停駐狀態。 當工具列水準停駐時為TRUE,當工具列垂直停駐時為 FALSE。

bCustomizeMode
[in]應用程式是否處於自定義模式。

bHighlight
[in]是否要反白顯示下拉式方塊按鈕。

bDrawBorder
[in]是否要以框線繪製下拉式方塊按鈕。

bGrayDisabledButtons
[in]TRUE 表示繪製已停用陰影的按鈕;FALSE 表示使用已停用的影像集合。

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

由架構呼叫,以在 [自定義] 對話方塊的 [命令] 窗格中繪製下拉式方塊按鈕

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

參數

pDC
[in]顯示下拉式方塊按鈕的裝置內容。

rect
[in]下拉式方塊按鈕的周框。

bSelected
[in]如果已選取下拉式方塊按鈕,則為TRUE;否則為 FALSE。

傳回值

下拉式方塊按鈕的寬度,以像素為單位。

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

由架構呼叫,以在應用程式字型變更時設定下拉式方塊按鈕字型。

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

由架構呼叫,以在父工具列移動時變更下拉式方塊按鈕的位置。

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

隱藏或顯示下拉式方塊按鈕時,由架構呼叫。

virtual void OnShow(BOOL bShow);

參數

bShow
[in]是否隱藏或顯示下拉式方塊按鈕。

CMFCToolBarComboBoxButton::OnSize

由架構呼叫,以在父工具列變更大小時變更下拉式方塊按鈕的大小。

virtual void OnSize(int iSize);

參數

iSize
[in]下拉式方塊按鈕的新寬度。

CMFCToolBarComboBoxButton::OnUpdateToolTip

當使用者變更下拉式方塊按鈕的工具提示時,由架構呼叫。

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

參數

pWndParent
[in]下拉式方塊按鈕的父視窗指標。

iButtonIndex
[in]下拉式方塊按鈕的標識碼。

wndToolTip
[in]要與下拉式方塊按鈕建立關聯的工具提示。

str
[in]工具提示文字。

傳回值

如果方法處理事件,則為TRUE;否則為 FALSE。

CMFCToolBarComboBoxButton::RemoveAllItems

從清單和編輯方塊中刪除所有專案。

void RemoveAllItems();

備註

從清單框移除所有專案,並編輯下拉式方塊的控件。

CMFCToolBarComboBoxButton::SelectItem

選取清單框中的專案。

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

參數

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

bNotify
[in]TRUE 可通知選取專案的下拉式方塊按鈕;否則為 FALSE。

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

lpszText
[in]清單框中項目的文字。

傳回值

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

備註

CMFCToolBarComboBoxButton::SelectItemAll

在具有指定命令識別碼的下拉式方塊按鈕清單框中選取專案。

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

參數

uiCmd
[in]包含清單框的下拉式方塊按鈕命令標識碼。

iIndex
[in]清單框中專案之以零起始的索引。 值 -1 會移除清單框中的任何目前選取範圍,並清除編輯框。

dwData
[in]清單框中項目的數據。

lpszText
[in]清單框中項目的文字。

傳回值

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

備註

CMFCToolBarComboBoxButton::Serialize

從封存讀取此物件,或將它寫入封存。

virtual void Serialize(CArchive& ar);

參數

ar
[in, out]要 CArchive 串行化的物件。

備註

物件中的 CArchive 設定會決定這個方法是否會讀取或寫入封存。

CMFCToolBarComboBoxButton::SetACCData

使用下拉式方塊按鈕的輔助功能數據填入指定的 CAccessibilityData 物件。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

參數

pParent
[in]下拉式方塊按鈕的父視窗。

data
[out] CAccessibilityData 物件,從下拉式方塊按鈕接收輔助功能數據。

傳回值

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

CMFCToolBarComboBoxButton::SetCenterVert

設定應用程式中下拉式方塊按鈕的垂直位置。

static void SetCenterVert(BOOL bCenterVert=TRUE);

參數

bCenterVert
[in]TRUE 表示將工具列中的下拉式方塊按鈕置中;FALSE 可將下拉式方塊按鈕對齊工具列頂端。

備註

根據預設,下拉式方塊按鈕會對齊頂端。

CMFCToolBarComboBoxButton::SetContextMenuID

設定下拉式方塊按鈕的快捷方式功能表資源標識碼。

void SetContextMenuID(UINT uiResID);

參數

uiResID
[in]快捷方式功能表資源標識碼。

CMFCToolBarComboBoxButton::SetDropDownHeight

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

void SetDropDownHeight(int nHeight);

參數

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

備註

預設高度為 150 像素。

CMFCToolBarComboBoxButton::SetFlatMode

設定應用程式中下拉式方塊按鈕的平面樣式外觀。

static void SetFlatMode(BOOL bFlat=TRUE);

參數

bFlat
[in]若為一般樣式外觀,則為TRUE;否則為 FALSE。

備註

下拉式方塊按鈕的預設平面樣式為 FALSE。

CMFCToolBarComboBoxButton::SetStyle

設定下拉式方塊按鈕的指定樣式,如果未停用,則會重新繪製控件。

virtual void SetStyle(UINT nStyle);

參數

nStyle
[in]工具列樣式的位元組合 (OR) 。

備註

如需工具列按鈕樣式的清單,請參閱 ToolBar控件樣式

CMFCToolBarComboBoxButton::SetText

設定下拉式方塊按鈕編輯方塊中的文字。

void SetText(LPCTSTR lpszText);

參數

lpszText
[in]包含編輯方塊文字的字串指標。

另請參閱

階層架構圖表
類別
CMFCToolBarButton 類別
CComboBox 類別
CMFCToolBar::ReplaceButton
逐步解說:將控制項放在工具列上