다음을 통해 공유


CMFCRibbonCheckBox 클래스

CMFCRibbonCheckBox 클래스는 리본 패널, 빠른 실행 도구 모음 또는 팝업 메뉴에 추가할 수 있는 확인란을 구현합니다.

구문

class CMFCRibbonCheckBox : public CMFCRibbonButton

멤버

공용 생성자

속성 설명
CMFCRibbonCheckBox::CMFCRibbonCheckBox 생성자입니다.

공용 메서드

이름 설명
CMFCRibbonCheckBox::GetCompactSize (재정의 CMFCRibbonButton::GetCompactSize.)
CMFCRibbonCheckBox::GetIntermediateSize (재정의 CMFCRibbonButton::GetIntermediateSize.)
CMFCRibbonCheckBox::GetRegularSize (재정의 CMFCRibbonButton::GetRegularSize.)
CMFCRibbonCheckBox::IsDrawTooltipImage ( CMFCRibbonButton::IsDrawTooltipImage을 재정의합니다.)
CMFCRibbonCheckBox::OnDraw (재정의 CMFCRibbonButton::OnDraw.)
CMFCRibbonCheckBox::OnDrawMenuImage (재정의 CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonCheckBox::OnDrawOnList ( CMFCRibbonButton::OnDrawOnList을 재정의합니다.)
CMFCRibbonCheckBox::SetACCData (재정의 CMFCRibbonButton::SetACCData.)

설명

애플리케이션에서 CMFCRibbonCheckBox를 사용하려면 코드에 다음 생성자를 추가합니다.

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

여기서 nID 는 확인란 명령 ID이고 lpszText 는 확인란의 텍스트 레이블입니다.

CMFCRibbonPanel::Add를 사용하여 리본 패널에 확인란을 추가할 수 있습니다.

상속 계층 구조

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

요구 사항

헤더: afxribboncheckbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

리본 확인란 개체의 생성자

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

매개 변수

nID
[in] 명령 ID를 지정합니다.

lpszText
[in] 텍스트 레이블을 지정합니다.

Return Value

리본 확인란 개체를 생성합니다.

예시

다음 예제에서는 클래스의 개체를 생성하는 방법을 보여 줍니다 CMFCRibbonCheckBox .

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox::GetCompactSize

재정의되면 확인란의 압축 크기를 가져옵니다.

virtual CSize GetCompactSize(CDC* pDC);

매개 변수

pDC
[in] 확인란과 연결된 CDC에 대한 포인터입니다.

Return Value

CSize 확인란의 압축 크기를 포함하는 개체를 반환합니다.

설명

재정의되지 않은 경우 확인란의 중간 크기를 반환합니다.

CMFCRibbonCheckBox::GetIntermediateSize

확인란의 중간 크기를 가져옵니다.

virtual CSize GetIntermediateSize(CDC* pDC);

매개 변수

pDC
[in] 이 확인란과 연결된 CDC에 대한 포인터입니다.

Return Value

CSize 확인란의 중간 크기를 포함하는 개체입니다.

설명

재정의되지 않은 경우 중간 크기를 기본 확인란 크기( AFX_CHECK_BOX_DEFAULT_SIZE)와 텍스트 크기 및 여백으로 계산합니다.

CMFCRibbonCheckBox::GetRegularSize

확인란의 일반 크기를 가져옵니다.

virtual CSize GetRegularSize(CDC* pDC);

매개 변수

pDC
[in] 이 확인란과 연결된 CDC 개체에 대한 포인터입니다.

Return Value

CSize 확인란의 일반 크기를 포함하는 개체를 반환합니다.

설명

재정의되지 않은 경우 확인란의 중간 크기를 반환합니다.

CMFCRibbonCheckBox::IsDrawTooltipImage

확인란과 연결된 도구 설명 이미지가 있는지 여부를 나타냅니다.

virtual BOOL IsDrawTooltipImage() const;

Return Value

확인란과 연결된 도구 설명 이미지가 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

CMFCRibbonCheckBox::OnDraw

지정된 디바이스 컨텍스트를 사용하여 확인란을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(CDC* pDC);

매개 변수

pDC
[in] 확인란을 그릴 CDC에 대한 포인터입니다.

설명

CMFCRibbonCheckBox::OnDrawMenuImage

확인란에 대한 메뉴 이미지를 그리기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

매개 변수

[in] CDC*
확인란과 연결된 CDC에 대한 포인터입니다.

CRect
[in] CRect 메뉴 이미지를 그릴 사각형을 지정하는 개체입니다.

Return Value

이미지를 그린 경우 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

재정의되지 않으면 FALSE를 반환합니다.

CMFCRibbonCheckBox::OnDrawOnList

명령 목록 상자에 확인란을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

매개 변수

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

strText
[in] 표시 텍스트입니다.

nTextOffset
[in] 목록 상자의 왼쪽에서 표시 텍스트까지의 거리(픽셀)입니다.

rect
[in] 확인란의 표시 사각형입니다.

bIsSelected
[in] 확인란이 선택되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

bHighlighted
[in] 확인란이 강조 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonCheckBox::SetACCData

확인란의 접근성 데이터를 설정합니다.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

매개 변수

pParent
확인란의 부모 창입니다.

data
확인란의 접근성 데이터입니다.

Return Value

항상 TRUE를 반환합니다.

설명

기본적으로 이 메서드는 확인란의 접근성 데이터를 설정하고 항상 TRUE를 반환합니다. 내게 필요한 옵션 데이터를 설정하고 성공 또는 실패를 나타내는 값을 반환하려면 이 메서드를 재정의합니다.

참고 항목

계층 구조 차트
클래스
CMFCRibbonPanel 클래스