`CMFCButton` 수업

아티클
10/12/2023

이 클래스는 CMFCButton 단추 텍스트 정렬, 단추 텍스트와 이미지 결합, 커서 선택, 도구 설명 지정 등의 기능을 CButton 클래스에 추가합니다.

구문

class CMFCButton : public CButton

멤버

공용 생성자

속성	설명
`CMFCButton::CMFCButton`	기본 생성자입니다.
`CMFCButton::~CMFCButton`	소멸자

공용 메서드

이름	설명
`CMFCButton::CleanUp`	내부 변수를 다시 설정하여 이미지, 비트맵 및 아이콘과 같은 할당된 리소스를 해제합니다.
`CMFCButton::CreateObject`	프레임워크에서 이 클래스 형식의 동적 인스턴스를 만드는 데 사용합니다.
`CMFCButton::DrawItem`	소유자 그리기 단추의 시각적 측면이 변경된 경우 프레임워크에서 호출됩니다. ( `CButton::DrawItem`을 재정의합니다.)
`CMFCButton::EnableFullTextTooltip`	큰 도구 설명 창에 도구 설명의 전체 텍스트를 표시할지 또는 작은 도구 설명 창에서 잘린 버전의 텍스트를 표시할지 여부를 지정합니다.
`CMFCButton::EnableMenuFont`	단추 텍스트 글꼴이 애플리케이션 메뉴 글꼴과 같은지 여부를 지정합니다.
`CMFCButton::EnableWindowsTheming`	단추 테두리의 스타일이 현재 Windows 테마에 해당하는지 여부를 지정합니다.
`CMFCButton::GetThisClass`	프레임워크에서 이 클래스 형식과 연결된 개체에 `CRuntimeClass` 대한 포인터를 가져오는 데 사용됩니다.
`CMFCButton::GetToolTipCtrl`	기본 도구 설명 컨트롤에 대한 참조를 반환합니다.
`CMFCButton::IsAutoCheck`	확인란 또는 라디오 단추가 자동 단추인지 여부를 나타냅니다.
`CMFCButton::IsAutorepeatCommandMode`	단추가 자동 반복 모드로 설정되어 있는지 여부를 나타냅니다.
`CMFCButton::IsCheckBox`	단추가 확인란 단추인지 여부를 나타냅니다.
`CMFCButton::IsChecked`	현재 단추가 선택되어 있는지 여부를 나타냅니다.
`CMFCButton::IsHighlighted`	단추가 강조 표시되어 있는지 여부를 나타냅니다.
`CMFCButton::IsPressed`	단추를 누르고 강조 표시할지 여부를 나타냅니다.
`CMFCButton::IsPushed`	단추를 누를지 여부를 나타냅니다.
`CMFCButton::IsRadioButton`	단추가 라디오 단추인지 여부를 나타냅니다.
`CMFCButton::IsWindowsThemingEnabled`	단추 테두리의 스타일이 현재 Windows 테마에 해당하는지 여부를 나타냅니다.
`CMFCButton::OnDrawParentBackground`	지정된 영역에서 단추 부모의 배경을 그립니다. (재정의 `AFX_GLOBAL_DATA::DrawParentBackground`
`CMFCButton::PreTranslateMessage`	창 메시지가 디스패치되기 전에 및 `DispatchMessage` Windows 함수로 `TranslateMessage` 변환합니다. ( `CWnd::PreTranslateMessage`을 재정의합니다.)
`CMFCButton::SetAutorepeatMode`	단추를 자동 반복 모드로 설정합니다.
`CMFCButton::SetCheckedImage`	선택한 단추의 이미지를 설정합니다.
`CMFCButton::SetFaceColor`	단추 텍스트의 배경색을 설정합니다.
`CMFCButton::SetImage`	단추의 이미지를 설정합니다.
`CMFCButton::SetMouseCursor`	커서 이미지를 설정합니다.
`CMFCButton::SetMouseCursorHand`	커서를 손 이미지로 설정합니다.
`CMFCButton::SetStdImage`	개체를 `CMenuImages` 사용하여 단추 이미지를 설정합니다.
`CMFCButton::SetTextColor`	선택하지 않은 단추의 단추 텍스트 색을 설정합니다.
`CMFCButton::SetTextHotColor`	선택한 단추의 단추 텍스트 색을 설정합니다.
`CMFCButton::SetTooltip`	도구 설명을 단추와 연결합니다.
`CMFCButton::SizeToContent`	단추 텍스트와 이미지를 포함하도록 단추의 크기를 조정합니다.

보호된 메서드

속성	설명
`CMFCButton::OnDraw`	단추를 그리기 위해 프레임워크에서 호출됩니다.
`CMFCButton::OnDrawBorder`	단추의 테두리를 그리기 위해 프레임워크에서 호출됩니다.
`CMFCButton::OnDrawFocusRect`	단추에 대한 포커스 사각형을 그리기 위해 프레임워크에서 호출됩니다.
`CMFCButton::OnDrawText`	단추 텍스트를 그리기 위해 프레임워크에서 호출됩니다.
`CMFCButton::OnFillBackground`	단추 텍스트의 배경을 그리기 위해 프레임워크에서 호출됩니다.
`CMFCButton::SelectFont`	지정된 디바이스 컨텍스트와 연결된 글꼴을 검색합니다.

데이터 멤버

속성	설명
`CMFCButton::m_nAlignStyle`	단추 텍스트의 맞춤을 지정합니다.
`CMFCButton::m_bDontUseWinXPTheme`	Windows XP 테마를 사용할지 여부를 지정합니다.
`CMFCButton::m_bDrawFocus`	단추 주위에 포커스 사각형을 그릴지 여부를 나타냅니다.
`CMFCButton::m_nFlatStyle`	테두리 없는 단추, 플랫, 반평형 또는 3D와 같은 단추 스타일을 지정합니다.
`CMFCButton::m_bGrayDisabled`	TRUE이면 비활성화된 단추를 회색으로 그릴 수 있습니다.
`CMFCButton::m_bHighlightChecked`	커서를 마우스로 가리킬 때 BS_CHECKBOX 스타일 단추를 강조 표시할지 여부를 나타냅니다.
`CMFCButton::m_bResponseOnButtonDown`	단추 다운 이벤트에 응답할지 여부를 나타냅니다.
`CMFCButton::m_bRightImage`	단추의 오른쪽에 이미지를 표시할지 여부를 나타냅니다.
`CMFCButton::m_bTopImage`	이미지가 단추 위에 있는지 여부를 나타냅니다.
`CMFCButton::m_bTransparent`	단추가 투명한지 여부를 나타냅니다.
`CMFCButton::m_bWasDblClk`	마지막 클릭 이벤트가 두 번 클릭되었는지 여부를 나타냅니다.

설명

다른 유형의 단추는 하이퍼링크를 지원하는 클래스 및 색 선택 대화 상자를 지원하는 클래스와 CMFCColorButton 같은 CMFCURLLinkButton 클래스에서 CMFCButton 파생됩니다.

개체의 CMFCButton 스타일은 또는 flatsemi-flat no border.일 수 있습니다.3D 단추 텍스트는 단추의 왼쪽, 위쪽 또는 가운데에 정렬할 수 있습니다. 런타임에 단추에 텍스트, 이미지 또는 텍스트와 이미지가 표시되는지 여부를 제어할 수 있습니다. 커서가 단추 위로 마우스를 가져가면 특정 커서 이미지가 표시되도록 지정할 수도 있습니다.

코드에서 직접 또는 MFC 클래스 마법사 도구 및 대화 상자 템플릿을 사용하여 단추 컨트롤을 만듭니다. 단추 컨트롤을 직접 만드는 경우 애플리케이션에 변수를 추가한 CMFCButton 다음 개체의 생성자 및 Create 메서드를 CMFCButton 호출합니다. MFC 클래스 마법사를 사용하는 경우 애플리케이션에 변수를 CButton 추가한 다음 변수 CButton 의 형식을 변경합니다CMFCButton.

대화 상자 애플리케이션에서 알림 메시지를 처리하려면 각 알림에 대한 메시지 맵 항목 및 이벤트 처리기를 추가합니다. 개체에서 보낸 CMFCButton 알림은 개체에서 보낸 CButton 알림과 동일합니다.

예시

다음 예제에서는 클래스의 다양한 메서드 CMFCButton 를 사용하여 단추의 속성을 구성하는 방법을 보여 줍니다. 이 예제는 새 컨트롤 샘플의 일부입니다.

CMFCButton m_Button;

// int m_iImage
// IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
if (m_iImage == 1)
{
   m_Button.SetImage((HBITMAP)NULL);
}
else
{
   m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
}

// int m_iImage
if (m_iImage == 0)
{
   m_Button.SetWindowText(_T(""));
}
else
{
   m_Button.SetWindowText(_T("Button"));
}

// Resize the button.
m_Button.SizeToContent();
m_Button.EnableFullTextTooltip(true);
// Use the application menu font at the button text font.
m_Button.EnableMenuFont();
// Use the current Windows theme to draw the button borders.
m_Button.EnableWindowsTheming(true);
// Set the button to auto-repeat mode.
m_Button.SetAutorepeatMode();
// Set the background color for the button text.
m_Button.SetFaceColor(RGB(255,0,0),true);
m_Button.SetTextColor(RGB(0,0,255));
// Set the tooltip of the button.
m_Button.SetTooltip(_T("this is a button!"));

상속 계층 구조

요구 사항

머리글: afxbutton.h

`CMFCButton::CleanUp`

내부 변수를 다시 설정하여 이미지, 비트맵 및 아이콘과 같은 할당된 리소스를 해제합니다.

virtual void CleanUp();

`CMFCButton::EnableFullTextTooltip`

큰 도구 설명 창에 도구 설명의 전체 텍스트를 표시할지 또는 작은 도구 설명 창에서 잘린 버전의 텍스트를 표시할지 여부를 지정합니다.

void EnableFullTextTooltip(BOOL bOn=TRUE);

매개 변수

bOn
[in] TRUE 모든 텍스트를 표시하려면 입니다. FALSE 을 클릭하여 잘린 텍스트를 표시합니다.

설명

`CMFCButton::EnableMenuFont`

단추 텍스트 글꼴이 애플리케이션 메뉴 글꼴과 같은지 여부를 지정합니다.

void EnableMenuFont(
    BOOL bOn=TRUE,
    BOOL bRedraw=TRUE);

매개 변수

bOn
[in] TRUE 애플리케이션 메뉴 글꼴을 단추 텍스트 글꼴로 사용하려면 입니다. FALSE 시스템 글꼴을 사용합니다. 기본값은 TRUE입니다.

bRedraw
[in] TRUE 화면을 즉시 다시 그리려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

이 메서드를 사용하여 단추 텍스트 글꼴을 지정하지 않으면 메서드를 사용하여 글꼴 CWnd::SetFont 을 지정할 수 있습니다. 글꼴을 지정하지 않으면 프레임워크에서 기본 글꼴을 설정합니다.

`CMFCButton::EnableWindowsTheming`

단추 테두리의 스타일이 현재 Windows 테마에 해당하는지 여부를 지정합니다.

static void EnableWindowsTheming(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE 현재 Windows 테마를 사용하여 단추 테두리를 그리려면 FALSE Windows 테마를 사용하지 않는 경우 기본값은 TRUE입니다.

설명

이 메서드는 클래스에서 파생된 애플리케이션의 모든 단추에 영향을 줍니다 CMFCButton .

`CMFCButton::GetToolTipCtrl`

기본 도구 설명 컨트롤에 대한 참조를 반환합니다.

CToolTipCtrl& GetToolTipCtrl();

Return Value

기본 도구 설명 컨트롤에 대한 참조입니다.

설명

`CMFCButton::IsAutoCheck`

확인란 또는 라디오 단추가 자동 단추인지 여부를 나타냅니다.

BOOL IsAutoCheck() const;

Return Value

TRUE 단추에 스타일 BS_AUTOCHECKBOX 이 있으면 이고 BS_AUTORADIOBUTTON, FALSE그렇지 않으면 .

설명

`CMFCButton::IsAutorepeatCommandMode`

단추가 자동 반복 모드로 설정되어 있는지 여부를 나타냅니다.

BOOL IsAutorepeatCommandMode() const;

Return Value

TRUE단추가 자동 반복 모드로 설정되어 있으면 이고, 그렇지 않으면 . FALSE

설명

이 메서드를 CMFCButton::SetAutorepeatMode 사용하여 단추를 자동 반복 모드로 설정합니다.

`CMFCButton::IsCheckBox`

단추가 확인란 단추인지 여부를 나타냅니다.

BOOL IsCheckBox() const;

Return Value

TRUE단추에 스타일이 BS_AUTOCHECKBOX 있으면 BS_CHECKBOX 이고, FALSE그렇지 않으면 .

설명

`CMFCButton::IsChecked`

현재 단추가 선택되어 있는지 여부를 나타냅니다.

BOOL IsChecked() const;

Return Value

TRUE현재 단추가 선택되어 있으면 이고, 그렇지 않으면 . FALSE

설명

프레임워크는 다양한 방법을 사용하여 다양한 종류의 단추를 확인했음을 나타냅니다. 예를 들어 라디오 단추는 점이 포함된 경우 검사됩니다. 확인란에 .가 포함되어 있으면 확인란이 선택되어 있습니다 X.

`CMFCButton::IsHighlighted`

단추가 강조 표시되어 있는지 여부를 나타냅니다.

BOOL IsHighlighted() const;

Return Value

TRUE단추가 강조 표시되면 이고, 그렇지 않으면 . FALSE

설명

마우스가 단추 위로 마우스를 가져가면 단추가 강조 표시됩니다.

`CMFCButton::IsPressed`

단추를 누르고 강조 표시할지 여부를 나타냅니다.

BOOL IsPressed() const;

Return Value

TRUE단추를 누르면 이고, 그렇지 않으면 . FALSE

설명

`CMFCButton::IsPushed`

단추를 누를지 여부를 나타냅니다.

BOOL IsPushed() const;

Return Value

TRUE단추를 누르면 이고, 그렇지 않으면 . FALSE

설명

`CMFCButton::IsRadioButton`

단추가 라디오 단추인지 여부를 나타냅니다.

BOOL IsRadioButton() const;

Return Value

TRUE 단추 스타일이면 이 BS_RADIOBUTTON 고 BS_AUTORADIOBUTTON, FALSE그렇지 않으면 .

설명

`CMFCButton::IsWindowsThemingEnabled`

단추 테두리의 스타일이 현재 Windows 테마에 해당하는지 여부를 나타냅니다.

static BOOL IsWindowsThemingEnabled();

Return Value

TRUE단추 테두리의 스타일이 현재 Windows 테마에 해당하면 이고, 그렇지 않으면 . FALSE

`CMFCButton::m_bDontUseWinXPTheme`

단추를 그릴 때 Windows XP 테마를 사용할지 여부를 지정합니다.

BOOL m_bDontUseWinXPTheme;

`CMFCButton::m_bDrawFocus`

단추 주위에 포커스 사각형을 그릴지 여부를 나타냅니다.

BOOL m_bDrawFocus;

설명

단추가 m_bDrawFocus 포커스를 받는 경우 프레임워크가 단추의 텍스트와 이미지 주위에 포커스 사각형을 그리도록 지정하도록 TRUE 멤버를 설정합니다.

생성자는 이 CMFCButton 멤버 TRUE를 .로 초기화합니다.

`CMFCButton::m_bGrayDisabled`

이 경우 TRUE비활성화된 단추를 회색으로 그릴 수 있습니다.

BOOL m_bGrayDisabled;

`CMFCButton::m_bHighlightChecked`

커서를 마우스로 BS_CHECKBOX가리킬 때 -style 단추를 강조 표시할지 여부를 나타냅니다.

BOOL m_bHighlightChecked;

설명

m_bHighlightChecked 마우스로 가리킬 때 프레임워크가 -style 단추를 강조 BS_CHECKBOX표시하도록 TRUE 멤버를 설정합니다.

`CMFCButton::m_bResponseOnButtonDown`

단추 다운 이벤트에 응답할지 여부를 나타냅니다.

BOOL m_bResponseOnButtonDown;

`CMFCButton::m_bRightImage`

단추의 오른쪽에 이미지를 표시할지 여부를 나타냅니다.

BOOL m_bRightImage;

`CMFCButton::m_bTopImage](#m_bTopImage)`

이미지가 단추 위에 있는지 여부를 나타냅니다.

BOOL m_bTopImage;

설명

프레임워크가 m_bRightImage 단추의 텍스트 레이블 오른쪽에 단추 이미지를 표시하도록 지정하도록 멤버 TRUE 를 설정합니다.

`CMFCButton::m_bTransparent`

단추가 투명한지 여부를 나타냅니다.

BOOL m_bTransparent;

설명

프레임워크가 m_bTransparent 단추를 투명하게 만들도록 지정하도록 TRUE 멤버를 설정합니다. 생성자는 이 CMFCButton 멤버 FALSE를 .로 초기화합니다.

`CMFCButton::m_nAlignStyle`

단추 텍스트의 맞춤을 지정합니다.

AlignStyle m_nAlignStyle;

설명

다음 CMFCButton::AlignStyle 열거형 값 중 하나를 사용하여 단추 텍스트의 맞춤을 지정합니다.

값	설명
`ALIGN_CENTER`	(기본값) 단추 텍스트를 단추의 가운데에 맞춥니다.
`ALIGN_LEFT`	단추 텍스트를 단추 왼쪽에 맞춥니다.
`ALIGN_RIGHT`	단추 텍스트를 단추의 오른쪽에 맞춥니다.

생성자는 이 CMFCButton 멤버 ALIGN_CENTER를 .로 초기화합니다.

`CMFCButton::m_bWasDblClk`](#m_bWasDblClk)|

마지막 클릭 이벤트가 두 번 클릭했는지 여부를 나타냅니다.|

BOOL m_bWasDblClk;

`CMFCButton::m_nFlatStyle`

테두리 없는 단추, 플랫, 반평형 또는 3D와 같은 단추 스타일을 지정합니다.

FlatStyle  m_nFlatStyle;

설명

다음 표에서는 단추의 CMFCButton::m_nFlatStyle 모양을 지정하는 열거형 값을 나열합니다.

값	설명
`BUTTONSTYLE_3D`	(기본값) 단추에 높은 3차원 면이 있는 것처럼 보입니다. 단추를 클릭하면 단추가 깊게 들여쓰기된 것처럼 보입니다.
`BUTTONSTYLE_FLAT`	마우스가 단추 위로 일시 중지되지 않으면 단추가 2차원으로 나타나고 측면이 발생하지 않습니다. 마우스가 단추 위로 일시 중지되면 단추의 3차원 측면이 낮게 나타납니다. 단추를 클릭하면 단추를 얕은 들여쓰기에 눌렀던 것처럼 보입니다.
`BUTTONSTYLE_SEMIFLAT`	단추가 낮고 3차원인 것처럼 보입니다. 단추를 클릭하면 단추가 깊게 들여쓰기된 것처럼 보입니다.
`BUTTONSTYLE_NOBORDERS`	단추는 양면이 발생하지 않으며 항상 2차원으로 나타납니다. 단추를 클릭할 때 들여쓰기에 눌렀던 것처럼 보이지 않습니다.

생성자는 이 CMFCButton 멤버 BUTTONSTYLE_3D를 .로 초기화합니다.

예시

다음 예제에서는 클래스에서 멤버 변수 CMFCButton 의 m_nFlatStyle 값을 설정하는 방법을 보여 줍니다. 이 예제는 새 컨트롤 샘플의 일부입니다.

CMFCButton m_Button;

//int m_iBorderStyle
switch (m_iBorderStyle)
{
case 0:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_FLAT;
   break;

case 1:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_SEMIFLAT;
   break;

case 2:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_3D;
}

`CMFCButton::OnDraw`

단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    UINT uiState);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rect
[in] 단추를 경계로 하는 사각형에 대한 참조입니다.

uiState
[in] 현재 단추 상태입니다. 자세한 내용은 구조 항목의 멤버를DRAWITEMSTRUCT 참조 itemState 하세요.

설명

사용자 고유의 코드를 사용하여 단추를 그리려면 이 메서드를 재정의합니다.

`CMFCButton::OnDrawBorder`

단추의 테두리를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect& rectClient,
    UINT uiState);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rectClient
[in] 단추를 경계로 하는 사각형에 대한 참조입니다.

uiState
[in] 현재 단추 상태입니다. 자세한 내용은 구조 항목의 멤버를DRAWITEMSTRUCT 참조 itemState 하세요.

설명

고유한 코드를 사용하여 테두리를 그리려면 이 메서드를 재정의합니다.

`CMFCButton::OnDrawFocusRect`

단추에 대한 포커스 사각형을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawFocusRect(
    CDC* pDC,
    const CRect& rectClient);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rectClient
[in] 단추를 경계로 하는 사각형에 대한 참조입니다.

설명

사용자 고유의 코드를 사용하여 포커스 사각형을 그리려면 이 메서드를 재정의합니다.

`CMFCButton::OnDrawText`

단추 텍스트를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawText(
    CDC* pDC,
    const CRect& rect,
    const CString& strText,
    UINT uiDTFlags,
    UINT uiState);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rect
[in] 단추를 경계로 하는 사각형에 대한 참조입니다.

strText
[in] 그릴 텍스트입니다.

uiDTFlags
[in] 텍스트의 서식을 지정하는 방법을 지정하는 플래그입니다. 자세한 내용은 메서드의 nFormat 매개 변수를 참조하세요 CDC::DrawText .

uiState
[in] 예약되어 있습니다.

설명

사용자 고유의 코드를 사용하여 단추 텍스트를 그리려면 이 메서드를 재정의합니다.

`CMFCButton::OnFillBackground`

단추 텍스트의 배경을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnFillBackground(
    CDC* pDC,
    const CRect& rectClient);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rectClient
[in] 단추를 경계로 하는 사각형에 대한 참조입니다.

설명

사용자 고유의 코드를 사용하여 단추의 배경을 그리려면 이 메서드를 재정의합니다.

`CMFCButton::SelectFont`

지정된 디바이스 컨텍스트와 연결된 글꼴을 검색합니다.

virtual CFont* SelectFont(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

Return Value

사용자 고유의 코드를 사용하여 글꼴을 검색하도록 이 메서드를 재정의합니다.

설명

`CMFCButton::SetAutorepeatMode`

단추를 자동 반복 모드로 설정합니다.

void SetAutorepeatMode(int nTimeDelay=500);

매개 변수

nTimeDelay
[in] 부모 창으로 전송되는 메시지 사이의 간격을 지정하는 음수입니다. 간격은 밀리초 단위로 측정되고 기본값은 500밀리초입니다. 자동 반복 메시지 모드를 사용하지 않도록 설정하려면 0을 지정합니다.

설명

이 메서드를 사용하면 단추가 해제되거나 nTimeDelay 매개 변수가 0으로 설정될 때까지 단추를 부모 창으로 지속적으로 메시지를 보냅니 WM_COMMAND 다.

`CMFCButton::SetCheckedImage`

선택한 단추의 이미지를 설정합니다.

void SetCheckedImage(
    HICON hIcon,
    BOOL bAutoDestroy=TRUE,
    HICON hIconHot=NULL,
    HICON hIconDisabled=NULL,
    BOOL bAlphaBlend=FALSE);

void SetCheckedImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy=TRUE,
    HBITMAP hBitmapHot=NULL,
    BOOL bMap3dColors=TRUE,
    HBITMAP hBitmapDisabled=NULL);

void SetCheckedImage(
    UINT uiBmpResId,
    UINT uiBmpHotResId=0,
    UINT uiBmpDsblResID=0);

매개 변수

hIcon
[in] 새 이미지의 비트맵 및 마스크가 포함된 아이콘에 대한 핸들입니다.

bAutoDestroy
[in] TRUE 비트맵 리소스가 자동으로 제거되도록 지정하려면 입니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

hIconHot
[in] 선택한 상태의 이미지가 들어 있는 아이콘에 대한 핸들입니다.

hBitmap
[in] 선택되지 않은 상태의 이미지를 포함하는 비트맵에 대한 핸들입니다.

hBitmapHot
[in] 선택한 상태의 이미지를 포함하는 비트맵에 대한 핸들입니다.

bMap3dColors
[in] 단추 배경의 투명한 색을 지정합니다. 즉, 단추의 얼굴입니다. TRUE 색 값 RGB(192, 192, 192)를 사용하려면 FALSE 에서 정의 AFX_GLOBAL_DATA::clrBtnFace한 색 값을 사용하려면

uiBmpResId
[in] 선택되지 않은 이미지의 리소스 ID입니다.

uiBmpHotResId
[in] 선택한 이미지의 리소스 ID입니다.

hIconDisabled
[in] 비활성화된 이미지의 아이콘에 대한 핸들입니다.

hBitmapDisabled
[in] 비활성화된 이미지를 포함하는 비트맵에 대한 핸들입니다.

uiBmpDsblResID
[in] 비활성화된 비트맵의 리소스 ID입니다.

bAlphaBlend
[in] TRUE 알파 채널을 사용하는 32비트 이미지만 사용하려면 FALSE- 알파 채널 이미지만 사용하지 않습니다. 기본값은 FALSE입니다.

설명

`CMFCButton::SetFaceColor`

단추 텍스트의 배경색을 설정합니다.

void SetFaceColor(
    COLORREF crFace,
    BOOL bRedraw=TRUE);

매개 변수

crFace
[in] RGB 색 값입니다.

bRedraw
[in] TRUE 화면을 즉시 다시 그리려면 그렇지 않으면 . FALSE

설명

이 메서드를 사용하여 단추 배경(얼굴)에 대한 새 채우기 색을 정의합니다. 멤버 변수TRUE가 있는 경우 배경이 CMFCButton::m_bTransparent 채워지지 않습니다.

CMFCButton::SetImage

단추의 이미지를 설정합니다.

void SetImage(
    HICON hIcon,
    BOOL bAutoDestroy=TRUE,
    HICON hIconHot=NULL,
    HICON hIconDisabled=NULL,
    BOOL bAlphaBlend=FALSE);

void SetImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy=TRUE,
    HBITMAP hBitmapHot=NULL,
    BOOL bMap3dColors=TRUE,
    HBITMAP hBitmapDisabled=NULL);

void SetImage(
    UINT uiBmpResId,
    UINT uiBmpHotResId=0,
    UINT uiBmpDsblResID=0);

매개 변수

hIcon
[in] 새 이미지의 비트맵 및 마스크가 포함된 아이콘에 대한 핸들입니다.

bAutoDestroy
[in] TRUE 비트맵 리소스가 자동으로 제거되도록 지정하려면 입니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

hIconHot
[in] 선택한 상태의 이미지가 들어 있는 아이콘에 대한 핸들입니다.

hBitmap
[in] 선택되지 않은 상태의 이미지를 포함하는 비트맵에 대한 핸들입니다.

hBitmapHot
[in] 선택한 상태의 이미지를 포함하는 비트맵에 대한 핸들입니다.

uiBmpResId
[in] 선택되지 않은 이미지의 리소스 ID입니다.

uiBmpHotResId
[in] 선택한 이미지의 리소스 ID입니다.

hIconDisabled
[in] 비활성화된 이미지의 아이콘에 대한 핸들입니다.

hBitmapDisabled
[in] 비활성화된 이미지를 포함하는 비트맵에 대한 핸들입니다.

uiBmpDsblResID
[in] 비활성화된 비트맵의 리소스 ID입니다.

bAlphaBlend
[in] TRUE 알파 채널을 사용하는 32비트 이미지만 사용하려면 FALSE- 알파 채널 이미지만 사용하지 않습니다. 기본값은 FALSE입니다.

설명

예시

다음 예제에서는 클래스에서 메서드의 다양 한 SetImage 버전을 사용 하는 방법을 보여 줍니다 CMFCButton . 이 예제는 새 컨트롤 샘플의 일부입니다.

CMFCButton m_Button;

// int m_iImage
// IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
if (m_iImage == 1)
{
   m_Button.SetImage((HBITMAP)NULL);
}
else
{
   m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
}

`CMFCButton::SetMouseCursor`

커서 이미지를 설정합니다.

void SetMouseCursor(HCURSOR hcursor);

매개 변수

hcursor
[in] 커서의 핸들입니다.

설명

이 메서드를 사용하여 손 커서와 같은 커서 이미지를 단추와 연결합니다. 커서가 애플리케이션 리소스에서 로드됩니다.

예시

다음 예제에서는 클래스에서 메서드를 SetMouseCursor 사용 하는 방법을 보여 줍니다 CMFCButton . 이 예제는 새 컨트롤 샘플의 코드에 속합니다.

CMFCButton m_Button;

// int m_iCursor
void CPage1::OnSetCursor()
{
   UpdateData();

   switch (m_iCursor)
   {
   case 0:
      m_Button.SetMouseCursor(NULL);
      break;

   case 1:
      m_Button.SetMouseCursorHand();
      break;

   case 2:
      m_Button.SetMouseCursor(AfxGetApp()->LoadCursor(IDC_CURSOR));
      break;
   }
}

`CMFCButton::SetMouseCursorHand`

커서를 손 이미지로 설정합니다.

void SetMouseCursorHand();

설명

이 메서드를 사용하여 손의 커서 이미지를 단추와 연결합니다. 커서가 애플리케이션 리소스에서 로드됩니다.

`CMFCButton::SetStdImage`

개체를 CMenuImages 사용하여 단추 이미지를 설정합니다.

void SetStdImage(
    CMenuImages::IMAGES_IDS id,
    CMenuImages::IMAGE_STATE state=CMenuImages::ImageBlack,
    CMenuImages::IMAGES_IDS idDisabled=(CMenuImages::IMAGES_IDS)0);

매개 변수

id
[in] 열거형에 정의된 CMenuImage::IMAGES_IDS 단추 이미지 식별자 중 하나입니다. 이미지 값은 화살표, 핀 및 라디오 단추와 같은 이미지를 지정합니다.

state
[in] 열거형에 정의된 CMenuImages::IMAGE_STATE 단추 이미지 상태 식별자 중 하나입니다. 이미지 상태는 검은색, 회색, 연한 회색, 흰색 및 진한 회색과 같은 단추 색을 지정합니다. 기본값은 CMenuImages::ImageBlack입니다.

idDisabled
[in] 열거형에 정의된 CMenuImage::IMAGES_IDS 단추 이미지 식별자 중 하나입니다. 이미지는 단추가 비활성화되었음을 나타냅니다. 기본값은 첫 번째 단추 이미지( CMenuImages::IdArrowDown)입니다.

설명

`CMFCButton::SetTextColor`

선택하지 않은 단추의 단추 텍스트 색을 설정합니다.

void SetTextColor(COLORREF clrText);

매개 변수

clrText
[in] RGB 색 값입니다.

설명

`CMFCButton::SetTextHotColor`

선택한 단추의 단추 텍스트 색을 설정합니다.

void SetTextHotColor(COLORREF clrTextHot);

매개 변수

clrTextHot
[in] RGB 색 값입니다.

설명

`CMFCButton::SetTooltip`

도구 설명을 단추와 연결합니다.

void SetTooltip(LPCTSTR lpszToolTipText);

매개 변수

lpszToolTipText
[in] 도구 설명의 텍스트에 대한 포인터입니다. 도구 설명을 사용하지 않도록 지정 NULL 합니다.

설명

`CMFCButton::SizeToContent`

단추 텍스트와 이미지를 포함하도록 단추의 크기를 조정합니다.

virtual CSize SizeToContent(BOOL bCalcOnly=FALSE);

매개 변수

bCalcOnly
[in] TRUE 단추의 새 크기를 계산할 수 있지만 변경되지는 않습니다. FALSE 을 클릭하여 단추의 크기를 변경합니다. 기본값은 FALSE입니다.

Return Value

CSize 단추의 새 크기를 포함하는 개체입니다.

설명

기본적으로 이 메서드는 가로 여백이 10픽셀이고 세로 여백이 5픽셀인 새 크기를 계산합니다.

참고 항목

계층 구조 차트
클래스
CMFCLinkCtrl 클래스
CMFCColorButton 클래스
CMFCMenuButton 클래스

다음을 통해 공유

CMFCButton 수업

구문

멤버

공용 생성자

공용 메서드

보호된 메서드

데이터 멤버

설명

예시

상속 계층 구조

요구 사항

CMFCButton::CleanUp

CMFCButton::EnableFullTextTooltip

매개 변수

설명

CMFCButton::EnableMenuFont

매개 변수

설명

CMFCButton::EnableWindowsTheming

매개 변수

설명

CMFCButton::GetToolTipCtrl

Return Value

설명

CMFCButton::IsAutoCheck

Return Value

설명

CMFCButton::IsAutorepeatCommandMode

Return Value

설명

CMFCButton::IsCheckBox

Return Value

설명

CMFCButton::IsChecked

Return Value

설명

CMFCButton::IsHighlighted

Return Value

설명

CMFCButton::IsPressed

Return Value

설명

CMFCButton::IsPushed

Return Value

설명

CMFCButton::IsRadioButton

Return Value

설명

CMFCButton::IsWindowsThemingEnabled

Return Value

CMFCButton::m_bDontUseWinXPTheme

CMFCButton::m_bDrawFocus

설명

CMFCButton::m_bGrayDisabled

CMFCButton::m_bHighlightChecked

설명

CMFCButton::m_bResponseOnButtonDown

CMFCButton::m_bRightImage

CMFCButton::m_bTopImage](#m_bTopImage)

설명

CMFCButton::m_bTransparent

설명

CMFCButton::m_nAlignStyle

설명

CMFCButton::m_bWasDblClk](#m_bWasDblClk)|

CMFCButton::m_nFlatStyle

설명

예시

CMFCButton::OnDraw

매개 변수

설명

CMFCButton::OnDrawBorder

매개 변수

설명

CMFCButton::OnDrawFocusRect

매개 변수

설명

CMFCButton::OnDrawText

매개 변수

`CMFCButton` 수업

`CMFCButton::CleanUp`

`CMFCButton::EnableFullTextTooltip`

`CMFCButton::EnableMenuFont`

`CMFCButton::EnableWindowsTheming`

`CMFCButton::GetToolTipCtrl`

`CMFCButton::IsAutoCheck`

`CMFCButton::IsAutorepeatCommandMode`

`CMFCButton::IsCheckBox`

`CMFCButton::IsChecked`

`CMFCButton::IsHighlighted`

`CMFCButton::IsPressed`

`CMFCButton::IsPushed`

`CMFCButton::IsRadioButton`

`CMFCButton::IsWindowsThemingEnabled`

`CMFCButton::m_bDontUseWinXPTheme`

`CMFCButton::m_bDrawFocus`

`CMFCButton::m_bGrayDisabled`

`CMFCButton::m_bHighlightChecked`

`CMFCButton::m_bResponseOnButtonDown`

`CMFCButton::m_bRightImage`

`CMFCButton::m_bTopImage](#m_bTopImage)`

`CMFCButton::m_bTransparent`

`CMFCButton::m_nAlignStyle`

`CMFCButton::m_bWasDblClk`](#m_bWasDblClk)|

`CMFCButton::m_nFlatStyle`

`CMFCButton::OnDraw`

`CMFCButton::OnDrawBorder`

`CMFCButton::OnDrawFocusRect`

`CMFCButton::OnDrawText`

`CMFCButton::OnFillBackground`

`CMFCButton::SelectFont`

`CMFCButton::SetAutorepeatMode`

`CMFCButton::SetCheckedImage`

`CMFCButton::SetFaceColor`

`CMFCButton::SetMouseCursor`

`CMFCButton::SetMouseCursorHand`

`CMFCButton::SetStdImage`

`CMFCButton::SetTextColor`

`CMFCButton::SetTextHotColor`

`CMFCButton::SetTooltip`

`CMFCButton::SizeToContent`