CMFCCaptionButton 類別

發行項
08/04/2024

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

共用方式為