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);
상속 계층 구조
요구 사항
헤더: afxcaptionbutton.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입니다.