共用方式為


CMFCCaptionButton 類別

類別 CMFCCaptionButton 會實作停駐窗格或迷你框架視窗標題列上顯示的按鈕。 Framework 通常會自動建立標題按鈕。

語法

class CMFCCaptionButton : public CObject

成員

建構函式

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

公用方法

名稱 描述
CMFCCaptionButton::GetHit 傳回按鈕所代表的命令。
CMFCCaptionButton::GetIconID 傳回與按鈕相關聯的影像標識碼。
CMFCCaptionButton::GetRect 傳回按鈕所佔用的矩形。
CMFCCaptionButton::GetSize 傳回按鈕的寬度和高度。
CMFCCaptionButton::IsMiniFrameButton 指出標題欄高度是否設定為迷你大小。
CMFCCaptionButton::Move 設定按鈕繪製位置和視窗顯示狀態。
CMFCCaptionButton::OnDraw 繪製標題按鈕。
CMFCCaptionButton::SetMiniFrameButton 設定標題列的迷你大小。

備註

您可以從 CPaneFrameWnd 類別衍生類別,並使用受保護的方法 AddButton,將標題按鈕新增至迷你框架視窗。

CPaneFrameWnd.h 會定義兩種標題按鈕類型的命令識別碼:

  • AFX_CAPTION_BTN_PIN,當停駐窗格支援自動隱藏模式時,會顯示釘選按鈕。

  • AFX_CAPTION_BTN_CLOSE,當窗格可以關閉或隱藏時,會顯示 [ 關閉 ] 按鈕。

範例

下列範例示範如何建構 CMFCCaptionButton 物件,並設定標題欄的迷你大小。

CMFCCaptionButton *captionButton = new CMFCCaptionButton(AFX_HTCLOSE);
captionButton->SetMiniFrameButton(true);

繼承階層架構

CObject

CMFCCaptionButton

需求

標頭: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

建構 CMFCCaptionButton 物件。

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

參數

nHit
[in]與按鈕相關聯的命令。

bLeftAlign
[in]指定按鈕是否對齊左邊。

下表列出 nHit 參數的可能值。

Command
AFX_HTCLOSE 關閉按鈕。
HTMINBUTTON 最小化按鈕。
HTMAXBUTTON 最大化按鈕。
AFX_HTLEFTBUTTON 向左箭號按鈕。
AFX_HTRIGHTBUTTON 向右箭號按鈕。
AFX_HTMENU 向下鍵功能表按鈕。
HTNOWHERE 預設值;表示沒有命令。

備註

根據預設,標題按鈕不會與命令相關聯。

標題按鈕會靠右或靠左對齊。

CMFCCaptionButton::GetHit

傳回按鈕所代表的命令。

UINT GetHit() const;

傳回值

按鈕所表示的命令。

下表列出可能的傳回值。

Command
AFX_HTCLOSE 關閉按鈕。
HTMINBUTTON 最小化按鈕。
HTMAXBUTTON 最大化按鈕。
AFX_HTLEFTBUTTON 向左箭號按鈕。
AFX_HTRIGHTBUTTON 向右箭號按鈕。
AFX_HTMENU 向下鍵功能表按鈕。
HTNOWHERE 預設值;表示沒有命令。

CMFCCaptionButton::GetIconID

傳回與按鈕相關聯的影像標識碼。

virtual CMenuImages::IMAGES_IDS GetIconID(
    BOOL bHorz,
    BOOL bMaximized = FALSE) const;

參數

bHorz
[in]若為向左或向右箭號影像標識符,則為TRUE;FALSE 表示向上或向下箭號影像標識符。

bMaximized
[in]最大化影像標識碼的 TRUE;FALSE 表示最小化影像標識碼。

傳回值

映像標識碼。

備註

參數會指定影像標識碼,以最小化或最大化標題按鈕。

CMFCCaptionButton::GetRect

傳回按鈕所佔用的矩形。

virtual CRect GetRect() const;

傳回值

代表按鈕位置的矩形。

備註

如果您看不到按鈕,傳回的大小會是 0。

CMFCCaptionButton::GetSize

傳回按鈕的寬度和高度。

static CSize GetSize();

傳回值

按鈕的外部維度。

備註

傳回的大小包括按鈕邊界和框線。

CMFCCaptionButton::IsMiniFrameButton

指出標題欄高度是否設定為迷你大小。

BOOL IsMiniFrameButton() const;

傳回值

如果標題設定為迷你大小,則為TRUE;否則為 FALSE。

備註

CMFCCaptionButton::Move

設定按鈕繪製位置和視窗顯示狀態。

void Move(
    const CPoint& ptTo,
    BOOL bHide = FALSE);

參數

ptTo
[in]新位置。

bHide
[in]是否要顯示按鈕。

CMFCCaptionButton::OnDraw

繪製標題按鈕。

virtual void OnDraw(
    CDC* pDC,
    BOOL bActive,
    BOOL bHorz = TRUE,
    BOOL bMaximized = TRUE,
    BOOL bDisabled = FALSE);

參數

pDC
[in]按鈕之裝置內容的指標。

bActive
[in]是否要繪製使用中的按鈕影像。

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

bMaximized
[in]是否要繪製最大化的按鈕影像。

bDisabled
[in]是否要繪製已啟用的按鈕影像。

備註

當按鈕是最大化或最小化按鈕時,會使用 bMaximized 參數。

CMFCCaptionButton::SetMiniFrameButton

設定標題列的迷你大小。

void SetMiniFramebutton(BOOL bSet = TRUE);

參數

bSet
[in]TRUE 表示迷你標題欄高度;默認標題欄高度的 FALSE。

另請參閱

階層架構圖表
類別
CPaneFrameWnd 類別
CDockablePane 類別