CMFCRibbonButtonsGroup 클래스

클래스 CMFCRibbonButtonsGroup 를 사용하면 리본 단추 집합을 그룹으로 구성할 수 있습니다. 그룹의 모든 단추는 가로로 서로 직접 인접해 있으며 테두리로 둘러싸여 있습니다.

구문

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

멤버

공용 생성자

속성	설명
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	CMFCRibbonButtonsGroup 개체를 생성합니다.

공용 메서드

이름	설명
CMFCRibbonButtonsGroup::AddButton	그룹에 단추를 추가합니다.
CMFCRibbonButtonsGroup::AddButtons	그룹에 단추 목록을 추가합니다.
CMFCRibbonButtonsGroup::GetButton	지정된 인덱스 위치에 있는 단추에 대한 포인터를 반환합니다.
CMFCRibbonButtonsGroup::GetCount	그룹의 단추 수를 반환합니다.
CMFCRibbonButtonsGroup::GetImageSize	리본 그룹에 있는 일반 이미지의 이미지 크기를 반환합니다 (CMFCRibbonBaseElement::GetImageSize를 재정의합니다.)
CMFCRibbonButtonsGroup::GetRegularSize	리본 요소의 일반 크기를 반환합니다 (CMFCRibbonBaseElement::GetRegularSize 재정의).
CMFCRibbonButtonsGroup::HasImages	개체에 CMFCRibbonButtonsGroup 도구 모음 이미지가 포함되어 있는지 여부를 보고합니다.
CMFCRibbonButtonsGroup::OnDrawImage	단추가 정상인지, 강조 표시되었는지 또는 사용하지 않도록 설정되었는지에 따라 지정된 단추에 적합한 이미지를 그립니다.
CMFCRibbonButtonsGroup::RemoveAll	개체에서 CMFCRibbonButtonsGroup 모든 단추를 제거합니다.
CMFCRibbonButtonsGroup::SetImages	그룹에 이미지를 할당합니다.
CMFCRibbonButtonsGroup::SetParentCategory	개체의 부모 CMFCRibbonCategory 및 개체 내의 CMFCRibbonButtonsGroup 모든 단추를 설정합니다(CMFCRibbonBaseElement::SetParentCategory를 재정의합니다.)

설명

이 그룹은 CMFCBaseRibbonElement에서 파생되며 단일 엔터티로 조작할 수 있습니다. 모든 패널 또는 팝업 메뉴에 그룹을 배치할 수 있습니다.

예시

다음 예제에서는 CMFCRibbonButtonsGroup 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 개체를 CMFCRibbonButtonsGroup 생성하고, 리본 단추 그룹에 이미지를 할당하고, 리본 단추 그룹에 단추를 추가하는 방법을 보여 줍니다. 이 코드 조각은 클라이언트 그리기 샘플의 일부입니다.

CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;

CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));

CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));

if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
   pSBGroup->SetImages(&images, &hotimages, NULL);
}

pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));

// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));

상속 계층 구조

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

요구 사항

헤더: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

그룹에 단추를 추가합니다.

void AddButton(CMFCRibbonBaseElement* pButton);

매개 변수

pButton
[in] 추가할 단추에 대한 포인터입니다.

CMFCRibbonButtonsGroup::AddButtons

그룹에 단추 목록을 추가합니다.

void AddButtons(
    const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);

매개 변수

lstButtons
[in] 추가하려는 단추에 대한 포인터 목록입니다.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

CMFCRibbonButtonsGroup 개체를 생성합니다.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

매개 변수

pButton
[in] 새로 만든 CMFCRibbonButtonsGroup 개체에 추가할 단추를 지정합니다.

Return Value

설명

CMFCRibbonButtonsGroup::GetButton

지정된 인덱스 위치에 있는 단추에 대한 포인터를 반환합니다.

CMFCRibbonBaseElement* GetButton(int i) const;

매개 변수

i
[in] 반환할 단추의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

지정된 인덱스 위치에 있는 단추에 대한 포인터입니다. 지정된 인덱스가 범위를 벗어나면 NULL입니다.

설명

CMFCRibbonButtonsGroup::GetCount

그룹의 단추 수를 반환합니다.

int GetCount() const;

Return Value

그룹의 단추 수입니다.

CMFCRibbonButtonsGroup::GetImageSize

보호된 CMFCToolBarImages 멤버 m_Images의 원본 이미지 크기를 검색합니다.

const CSize GetImageSize() const;

Return Value

도구 모음 이미지의 원본 이미지 크기(있는 경우) 또는 0(없는 경우)을 CSize 반환합니다.

설명

CMFCRibbonButtonsGroup::GetRegularSize

리본 그룹 요소의 가능한 최대 크기를 검색합니다.

virtual CSize GetRegularSize(CDC* pDC);

매개 변수

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

Return Value

설명

CMFCRibbonButtonsGroup::HasImages

개체에 CMFCRibbonButtonsGroup 도구 모음 이미지가 포함되어 있는지 여부를 보고합니다.

BOOL HasImages() const;

Return Value

보호된 CMFCToolBarImages 멤버 m_Images 에 이미지가 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

CMFCRibbonButtonsGroup::OnDrawImage

단추가 정상인지, 강조 표시되었는지 또는 사용하지 않도록 설정되었는지에 따라 지정된 단추에 적합한 이미지를 그립니다.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rectImage,
    CMFCRibbonBaseElement* pButton,
    int nImageIndex);

매개 변수

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

rectImage
[in] 이미지를 그릴 사각형입니다.

pButton
[in] 이미지를 그릴 단추입니다.

nImageIndex
[in] 단추에 그릴 이미지의 인덱스입니다(일반, 강조 표시 또는 비활성화된 단추의 세 가지 이미지 배열 중 하나).

설명

CMFCRibbonButtonsGroup::RemoveAll

개체에서 CMFCRibbonButtonsGroup 모든 단추를 제거합니다.

void RemoveAll();

설명

CMFCRibbonButtonsGroup::SetImages

리본 단추 그룹에 이미지를 할당합니다.

void SetImages(
    CMFCToolBarImages* pImages,
    CMFCToolBarImages* pHotImages,
    CMFCToolBarImages* pDisabledImages);

매개 변수

pImages
[in] 일반 이미지.

pHotImages
[in] 핫 이미지.

pDisabledImages
[in] 비활성화된 이미지.

설명

그룹에 단추를 추가하기 전에 호출 SetImages 합니다. 이미지 수는 그룹에 추가할 단추 수보다 크거나 같아야 합니다.

참고 항목

핫 이미지는 사용자가 단추를 마우스로 가리킬 때 표시되는 이미지입니다. 비활성화된 이미지는 단추를 사용하지 않도록 설정할 때 표시되는 이미지입니다.

CMFCRibbonButtonsGroup::SetParentCategory

개체의 CMFCRibbonButtonsGroup 부모 CMFCRibbonCategory 및 개체 내의 모든 단추를 설정합니다.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

매개 변수

pCategory
[in] 설정할 부모 범주에 대한 포인터입니다(리본 컨트롤의 탭 그룹을 범주라고 함).

설명

참고 항목

계층 구조 차트
클래스