CMFCCaptionButton 클래스

클래스는 CMFCCaptionButton 도킹 창 또는 미니 프레임 창의 캡션 표시줄에 표시되는 단추를 구현합니다. 일반적으로 프레임워크는 캡션 단추를 자동으로 만듭니다.

구문

class CMFCCaptionButton : public CObject

멤버

생성자

이름	설명
CMFCCaptionButton::CMFCCaptionButton	CMFCCaptionButton 개체를 생성합니다.

공용 메서드

이름	설명
CMFCCaptionButton::GetHit	단추가 나타내는 명령을 반환합니다.
CMFCCaptionButton::GetIconID	단추와 연결된 이미지 ID를 반환합니다.
CMFCCaptionButton::GetRect	단추가 차지하는 사각형을 반환합니다.
CMFCCaptionButton::GetSize	단추의 너비와 높이를 반환합니다.
CMFCCaptionButton::IsMiniFrameButton	제목 표시줄 높이가 미니 크기로 설정되어 있는지 여부를 나타냅니다.
CMFCCaptionButton::Move	단추 그리기 위치 및 창 표시 상태를 설정합니다.
CMFCCaptionButton::OnDraw	캡션 단추를 그립니다.
CMFCCaptionButton::SetMiniFrameButton	제목 표시줄의 미니 크기를 설정합니다.

설명

CPaneFrameWnd 클래스에서 클래스를 파생하고 보호된 메서드AddButton를 사용하여 미니 프레임 창에 캡션 단추를 추가할 수 있습니다.

CPaneFrameWnd.h는 두 가지 유형의 캡션 단추에 대한 명령 ID를 정의합니다.

• 도킹 창에서 자동 숨기기 모드를 지원할 때 고정 단추를 표시하는 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 매개 변수에 사용할 수 있는 값을 나열합니다.

값	명령어
AFX_HTCLOSE	닫기 단추입니다.
HTMINBUTTON	최소화 단추.
HTMAXBUTTON	최대화 단추.
AFX_HTLEFTBUTTON	왼쪽 화살표 단추.
AFX_HTRIGHTBUTTON	오른쪽 화살표 버튼.
AFX_HTMENU	아래쪽 화살표 메뉴 단추입니다.
HTNOWHERE	기본값입니다. 는 명령 없음을 나타냅니다.

설명

기본적으로 캡션 단추는 명령과 연결되지 않습니다.

캡션 단추는 오른쪽 또는 왼쪽에 정렬됩니다.

CMFCCaptionButton::GetHit

단추가 나타내는 명령을 반환합니다.

UINT GetHit() const;

Return Value

단추가 나타내는 명령입니다.

다음 표에서는 가능한 반환 값을 나열합니다.

값	명령어
AFX_HTCLOSE	닫기 단추입니다.
HTMINBUTTON	최소화 단추.
HTMAXBUTTON	최대화 단추.
AFX_HTLEFTBUTTON	왼쪽 화살표 단추.
AFX_HTRIGHTBUTTON	오른쪽 화살표 버튼.
AFX_HTMENU	아래쪽 화살표 메뉴 단추입니다.
HTNOWHERE	기본값입니다. 는 명령 없음을 나타냅니다.

CMFCCaptionButton::GetIconID

단추와 연결된 이미지 ID를 반환합니다.

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

매개 변수

bHorz
[in] 왼쪽 또는 오른쪽 화살표 이미지 ID의 경우 TRUE입니다. 위쪽 또는 아래쪽 화살표 이미지 ID의 경우 FALSE입니다.

bMaximized
[in] 이미지 ID 최대화의 경우 TRUE입니다. 이미지 ID 최소화에 대한 FALSE입니다.

Return Value

이미지 ID입니다.

설명

매개 변수는 캡션 단추를 최소화하거나 최대화하기 위해 이미지 ID를 지정합니다.

CMFCCaptionButton::GetRect

단추가 차지하는 사각형을 반환합니다.

virtual CRect GetRect() const;

Return Value

단추의 위치를 나타내는 사각형입니다.

설명

단추를 볼 수 없는 경우 반환되는 크기는 0입니다.

CMFCCaptionButton::GetSize

단추의 너비와 높이를 반환합니다.

static CSize GetSize();

Return Value

단추의 외부 차원입니다.

설명

반환되는 크기에는 단추 여백과 테두리가 포함됩니다.

CMFCCaptionButton::IsMiniFrameButton

제목 표시줄 높이가 미니 크기로 설정되어 있는지 여부를 나타냅니다.

BOOL IsMiniFrameButton() const;

Return Value

캡션 미니 크기로 설정하면 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 클래스