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

需求

標頭： afx標題button.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 類別