CMFCButton 클래스

이 클래스는 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-flatno 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!"));

상속 계층 구조

CObject

CCmdTarget

CWnd

CButton

CMFCButton

요구 사항

헤더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_RADIOBUTTONBS_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를 .로 초기화합니다.

예시

다음 예제에서는 클래스에서 멤버 변수 CMFCButtonm_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입니다.

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

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 클래스