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"));
상속 계층 구조
요구 사항
헤더: 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] 설정할 부모 범주에 대한 포인터입니다(리본 컨트롤의 탭 그룹을 범주라고 함).