다음을 통해 공유


CMFCRibbonPanel 클래스

리본 요소 집합이 포함된 패널을 구현합니다. 패널을 그리면 지정된 패널 크기에 가능한 한 많은 요소를 표시합니다.

더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

구문

class CMFCRibbonPanel : public CObject

멤버

보호된 생성자

속성 설명
CMFCRibbonPanel::CMFCRibbonPanel CMFCRibbonPanel 개체를 생성하고 초기화합니다.

공용 메서드

이름 설명
CMFCRibbonPanel::Add 패널에 리본 요소를 추가합니다.
CMFCRibbonPanel::AddSeparator 리본 패널에 구분 기호를 추가합니다.
CMFCRibbonPanel::AddToolBar 리본 패널에 도구 모음을 추가합니다.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID 지정된 명령 ID로 식별되는 요소를 반환합니다.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount 리본 패널의 요소 수를 반환합니다.
CMFCRibbonPanel::GetData 패널과 연결된 사용자 정의 데이터를 반환합니다.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement 지정된 인덱스 위치에 있는 리본 요소를 반환합니다.
CMFCRibbonPanel::GetElements 리본 패널에 포함된 모든 요소를 검색합니다.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused 포커스가 지정된 요소를 반환합니다.
CMFCRibbonPanel::GetGalleryRect Gallery 요소의 경계 사각형을 반환합니다.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory 리본 패널의 부모 범주를 반환합니다.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements 표시되는 요소의 배열을 가져옵니다.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Insert 지정된 위치에 리본 요소를 삽입합니다.
CMFCRibbonPanel::InsertSeparator 지정된 위치에 구분 기호를 삽입합니다.
CMFCRibbonPanel::IsCenterColumnVert 모든 패널 요소를 세로로 열로 가운데에 맞출지 여부를 지정합니다.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns 모든 패널 열의 너비가 같은지 여부를 지정합니다.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible 갤러리를 스크롤하여 지정된 Ribbon 요소를 표시합니다.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Remove 지정된 인덱스에 있는 요소를 제거하고 선택적으로 삭제합니다.
CMFCRibbonPanel::RemoveAll 리본 패널에서 모든 요소를 제거합니다.
CMFCRibbonPanel::Replace 해당 인덱스 값에 따라 한 요소를 다른 요소로 대체합니다.
CMFCRibbonPanel::ReplaceByID 지정된 명령 ID에 따라 한 요소를 다른 요소로 대체합니다.
CMFCRibbonPanel::SetCenterColumnVert 패널을 열별로 세로로 정렬하도록 패널을 정렬합니다.
CMFCRibbonPanel::SetData 사용자 정의 데이터를 리본 패널에 연결합니다.
CMFCRibbonPanel::SetElementMenu 지정된 명령 ID가 있는 요소에 팝업 메뉴를 할당합니다.
CMFCRibbonPanel::SetElementRTC 제공된 런타임 클래스 정보로 지정된 리본 요소를 리본 패널에 추가합니다.
CMFCRibbonPanel::SetElementRTCByID 제공된 런타임 클래스 정보로 지정된 리본 요소를 리본 패널에 추가합니다.
CMFCRibbonPanel::SetFocused 포커스를 지정된 Ribbon 요소로 설정합니다.
CMFCRibbonPanel::SetJustifyColumns 열 근거를 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonPanel::SetKeys 리본 패널을 표시하는 바로 가기 키를 설정합니다.
CMFCRibbonPanel::ShowPopup

설명

리본 패널은 리본 범주 내에서 만드는 관련 작업의 논리적 그룹입니다. 리본 메뉴의 크기가 변경되면 패널 레이아웃이 가능한 한 많은 요소를 표시하도록 자동으로 조정됩니다.

CMFCRibbonCategory::GetPanel 메서드를 호출하여 리본 범주에 포함된 리본 패널을 가져올 수 있습니다.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 CMFCRibbonPanel 구성하는 방법을 보여 줍니다 CMFCRibbonPanel . 이 예제에서는 리본 패널을 표시하는 바로 가기 키를 설정하고, 패널의 요소를 세로로 열로 정렬하고, 열 근거를 사용하도록 설정하는 방법을 보여 줍니다. 이 코드 조각은 MS Office 2007 데모 샘플일부입니다.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

상속 계층 구조

CObject

CMFCRibbonPanel

요구 사항

헤더: afxRibbonPanel.h

CMFCRibbonPanel::Add

리본 패널에 포함된 리본 요소의 배열에 지정된 리본 요소를 추가합니다.

virtual void Add(CMFCRibbonBaseElement* pElem);

매개 변수

pElem
[in, out] 리본 요소에 대한 포인터입니다.

설명

CMFCRibbonPanel::AddSeparator

리본 패널에 구분 기호를 추가합니다.

virtual void AddSeparator();

설명

리본 패널에 구분 기호를 추가하려면 이 메서드를 호출합니다. CMFCRibbonPanel::Add에 대한 이전 호출에 의해 추가된 리본 요소 옆에 구분 기호가 추가됩니다. 지정된 위치에 구분 기호를 삽입하려면 CMFCRibbonPanel::InsertSeparator를 호출 합니다.

CMFCRibbonPanel::AddToolBar

리본 패널에 도구 모음을 추가합니다.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

매개 변수

uiToolbarResID
[in] 추가할 도구 모음의 리소스 ID를 지정합니다.

uiColdResID
[in] 도구 모음의 콜드 이미지의 리소스 ID를 지정합니다.

uiHotResID
[in] 도구 모음의 핫 이미지의 리소스 ID를 지정합니다.

uiDisabledResID
[in] 도구 모음의 비활성화된 이미지의 리소스 ID를 지정합니다.

Return Value

리본 패널에 도구 모음을 추가하려면 이 메서드를 호출합니다. 도구 모음은 CMFCRibbonPanel::Add에 대한 이전 호출에 의해 추가된 리본 요소 옆에 추가됩니다.

설명

도구 모음, 핫 이미지, 콜드 이미지 및 비활성화된 이미지에 대한 자세한 내용은 CMFCToolBar 클래스를 참조 하세요.

CMFCRibbonPanel::CMFCRibbonPanel

CMFCRibbonPanel 개체를 생성하고 초기화합니다.

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

매개 변수

lpszName
[in] 리본 패널의 이름입니다.

hIcon
[in] 리본 패널의 기본 단추 아이콘에 대한 핸들입니다.

pPaletteButton
[in] 리본 패널의 리본 갤러리에 대한 포인터입니다.

CMFCRibbonPanel::FindByData

지정된 데이터와 연결된 리본 요소를 검색합니다.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

매개 변수

dwData
[in] 리본 요소와 연결된 데이터입니다.

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonPanel::FindByID

지정된 명령 ID로 식별되는 리본 요소를 검색합니다.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

매개 변수

uiCmdID
[in] 리본 요소의 명령 ID입니다.

Return Value

지정된 명령 ID로 식별되는 리본 요소입니다. 리본 요소가 지정된 명령 ID로 식별되지 않으면 NULL이 아닙니다.

CMFCRibbonPanel::GetCaptionHeight

리본 패널의 캡션 높이를 검색합니다.

int GetCaptionHeight() const;

Return Value

리본 패널에 대한 캡션의 높이(픽셀)입니다.

설명

CMFCRibbonPanel::GetCount

리본 패널에 포함된 리본 요소의 수를 검색합니다.

int GetCount() const;

Return Value

리본 패널에 포함된 리본 요소의 수입니다.

CMFCRibbonPanel::GetData

패널과 연결된 사용자 정의 데이터를 반환합니다.

DWORD_PTR GetData() const;

Return Value

패널과 연결된 사용자 정의 데이터입니다.

CMFCRibbonPanel::GetDefaultButton

리본 패널의 기본 단추를 검색합니다.

CMFCRibbonButton& GetDefaultButton();

Return Value

리본 패널의 기본 단추입니다.

설명

리본 패널에 리본 요소를 표시할 공간이 부족한 경우 기본 단추가 표시됩니다.

CMFCRibbonPanel::GetDroppedDown

팝업 메뉴가 드롭다운되면 리본 요소에 대한 포인터를 검색합니다.

CMFCRibbonBaseElement* GetDroppedDown() const;

Return Value

팝업 메뉴가 드롭다운된 리본 요소에 대한 포인터입니다. 그렇지 않으면 팝업 메뉴가 드롭다운된 리본 요소가 없는 경우 NULL입니다.

설명

리본 패널에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonPanel::GetElement

지정된 인덱스 위치에 있는 리본 요소를 반환합니다.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

매개 변수

nIndex
[in] 검색할 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

리본 패널의 nIndex 위치에 있는 기본 리본 요소에 대한 유효한 포인터이거나, 지정된 인덱스에 요소가 없는 경우 NULL입니다.

CMFCRibbonPanel::GetElements

리본 패널에 포함된 모든 리본 요소를 검색합니다.

void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

매개 변수

arElements
[out] 리본 패널에 포함된 모든 리본 요소로 채울 배열입니다.

설명

CMFCRibbonPanel::GetElementsByID

지정된 명령 ID가 있는 리본 요소를 지정된 배열에 추가합니다.

void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

매개 변수

uiCmdID
[in] 리본 요소의 명령 ID입니다.

arElements
[in] 리본 요소의 배열입니다.

설명

리본 패널에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonPanel::GetHighlighted

리본 패널에서 강조 표시된 리본 요소를 검색합니다.

CMFCRibbonBaseElement* GetHighlighted() const;

Return Value

리본 패널에서 강조 표시된 리본 요소에 대한 포인터입니다.

설명

CMFCRibbonPanel::GetIndex

리본 패널에 포함된 리본 요소의 배열에서 지정된 리본 요소의 인덱스(0부터 시작하는 인덱스)를 검색합니다.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

매개 변수

pElem
[in] 리본 요소에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 지정된 리본 요소의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

CMFCRibbonPanel::GetItemIDsList

리본 패널의 모든 리본 요소에 대한 명령 ID를 검색합니다.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

매개 변수

lstItems
[out] 리본 패널에 포함된 리본 요소에 대한 명령 ID 목록입니다.

설명

CMFCRibbonPanel::GetName

리본 패널의 이름을 검색합니다.

LPCTSTR GetName() const;

Return Value

리본 패널의 이름입니다.

설명

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Return Value

설명

CMFCRibbonPanel::GetParentCategory

리본 패널의 부모 범주를 반환합니다.

CMFCRibbonCategory* GetParentCategory() const;

Return Value

이 리본 패널을 포함하는 리본 범주에 대한 포인터입니다.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Return Value

설명

CMFCRibbonPanel::GetPreferedMenuLocation

리본 패널의 팝업 메뉴에 대한 기본 설정 표시 사각형을 검색합니다.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

매개 변수

rect
[out] 이 매개 변수는 사용되지 않습니다.

Return Value

항상 FALSE를 반환합니다.

설명

이 메서드는 항상 FALSE를 반환합니다. 리본 패널의 팝업 메뉴에 대한 기본 표시 사각형을 검색하려면 이 메서드를 재정의합니다.

CMFCRibbonPanel::GetPressed

사용자가 현재 리본 패널을 누를 경우 리본 패널의 리본 요소에 대한 포인터를 검색합니다.

CMFCRibbonBaseElement* GetPressed() const;

Return Value

사용자가 현재 리본 요소를 누를 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonPanel::GetRect

리본 패널의 표시 사각형을 검색합니다.

const CRect& GetRect() const;

Return Value

리본 패널의 표시 사각형입니다.

설명

CMFCRibbonPanel::HasElement

리본 패널에 지정된 리본 요소가 포함되어 있는지 여부를 나타냅니다.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

매개 변수

pElem
[in] 리본 요소에 대한 포인터입니다.

Return Value

리본 패널에 지정된 리본 요소가 포함되어 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonPanel::Highlight

선택한 리본 패널 및 포인트로 지정된 리본 요소의 강조 색을 설정합니다.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

매개 변수

bHighlight
[in] TRUE이면 리본 패널을 강조 표시합니다. FALSE를 사용하여 리본 패널을 해제합니다.

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

설명

CMFCRibbonPanel::HitTest

지정한 점이 있는 경우 리본 요소를 검색합니다.

virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

bCheckPanelCaption
[in] TRUE이면 리본 패널 캡션을 테스트합니다. 그렇지 않으면 FALSE입니다.

Return Value

지정한 점이 있는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

리본 패널에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonPanel::HitTestEx

지정한 점이 있는 리본 요소의 인덱스(0부터 시작하는 인덱스)를 검색합니다.

virtual int HitTestEx(CPoint point) const;

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

Return Value

지정한 점이 있는 리본 요소의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

리본 패널에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonPanel::Insert

리본 패널에 포함된 리본 요소 배열의 지정된 위치에 지정된 리본 요소를 삽입합니다.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

매개 변수

pElem
[in, out] 리본 요소에 대한 포인터입니다.

nIndex
[in] -1부터 배열에 포함된 리본 요소 수에 이르기까지 0부터 시작하는 값입니다.

Return Value

리본 요소가 성공적으로 삽입되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

nIndex이 -1이거나 nIndex가 배열의 리본 요소 수와 같으면 지정된 리본 요소가 배열의 끝에 추가됩니다. nIndex 값이 범위를 벗어나면 메서드가 실패합니다.

CMFCRibbonPanel::InsertSeparator

지정된 위치에 구분 기호를 삽입합니다.

virtual BOOL InsertSeparator(int nIndex);

매개 변수

nIndex
[in] 구분 기호가 삽입되는 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

구분 기호가 성공적으로 삽입되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

nIndex에서 지정한 위치에 구분 기호를 삽입하려면 이 메서드를 호출합니다. 가장 최근에 추가된 리본 요소 옆에 구분 기호를 삽입하려면 CMFCRibbonPanel::AddSeparator를 호출 합니다.

CMFCRibbonPanel::IsCenterColumnVert

리본 요소의 세로 위치가 표시 사각형 내에서 가운데에 배치되는지 여부를 나타냅니다.

BOOL IsCenterColumnVert() const;

Return Value

TRUE이면 리본 요소의 세로 위치가 표시 사각형 내에서 가운데에 배치됩니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonPanel::IsCollapsed

리본 패널의 표시 크기가 가로 방향으로 최소화되는지 여부를 나타냅니다.

BOOL IsCollapsed() const;

Return Value

TRUE이면 리본 패널의 표시 크기가 가로 방향으로 최소화됩니다. 그렇지 않으면 FALSE입니다.

설명

리본 패널이 축소되면 기본 단추, 이름 및 드롭다운 화살표만 표시됩니다.

CMFCRibbonPanel::IsHighlighted

리본 패널의 표시가 강조 표시되어 있는지 여부를 나타냅니다.

BOOL IsHighlighted() const;

Return Value

리본 패널의 표시가 강조 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

리본 패널의 표시는 포인터가 위에 있을 때 강조 표시됩니다.

CMFCRibbonPanel::IsJustifyColumns

리본 패널의 동일한 열에 있는 리본 요소의 표시 크기를 동일한 너비로 설정할지 여부를 나타냅니다.

BOOL IsJustifyColumns() const;

Return Value

TRUE이면 리본 패널의 동일한 열에 있는 리본 요소의 표시 차원이 동일한 너비로 설정됩니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonPanel::IsMainPanel

리본 패널이 주 리본 패널인지 여부를 나타냅니다.

virtual BOOL IsMainPanel() const;

Return Value

항상 FALSE를 반환합니다.

설명

이 메서드는 항상 FALSE를 반환합니다. 리본 패널이 주 리본 패널인지 여부를 나타내려면 이 메서드를 재정의합니다.

사용자가 애플리케이션 단추를 선택하면 기본 리본 패널이 표시됩니다.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Return Value

설명

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

매개 변수

[in] nChar

Return Value

설명

CMFCRibbonPanel::RecalcWidths

리본 패널에 대한 각 디스플레이 레이아웃 구성의 너비를 다시 계산합니다.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

매개 변수

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

nHeight
[in] 리본 패널의 높이입니다.

설명

리본 패널에서 사용 가능한 너비가 변경됨에 따라 레이아웃 구성이 변경됩니다.

CMFCRibbonPanel::Remove

지정된 인덱스에 있는 요소를 제거하고 선택적으로 삭제합니다.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

매개 변수

nIndex
[in] 리본 패널에서 제거되는 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

bDelete
[in] 제거되는 요소를 삭제하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.

Return Value

요소가 제거되고 삭제된 경우 TRUE입니다(bDelete가 TRUE인 경우). 요소가 제거되지 않았거나 nIndex리본 요소가 없는 경우 FALSE입니다.

설명

리본 패널에서 요소를 제거하려면 이 메서드를 호출합니다.

CMFCRibbonPanel::RemoveAll

리본 패널에서 모든 리본 요소를 삭제합니다.

void RemoveAll();

설명

모든 리본 메뉴 요소는 리본 패널에서 삭제되고 제거됩니다.

CMFCRibbonPanel::Replace

인덱스 값에 따라 한 요소를 다른 요소로 대체합니다.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

매개 변수

nIndex
[in] 바꿀 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

pElem
[in, out] 원래 요소를 대체하는 요소에 대한 유효한 포인터입니다.

Return Value

원래 리본 요소가 새 리본 요소로 대체되었으면 TRUE입니다. RIBBON 요소가 대체되지 않았거나 지정된 인덱스에서 요소가 없는 경우 FALSE입니다.

설명

리본 요소를 명령 ID로 바꾸려면 CMFCRibbonPanel::ReplaceByID를 호출합니다.

CMFCRibbonPanel::ReplaceByID

지정된 명령 ID에 따라 한 요소를 다른 요소로 대체합니다.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

매개 변수

uiCmdID
[in] 바꿀 요소의 명령 ID를 지정합니다.

pElem
[in, out] 원래 요소를 대체할 요소에 대한 유효한 포인터입니다.

Return Value

원래 리본 요소가 새 리본 요소로 대체되었으면 TRUE입니다. 리본 요소를 대체하지 않았거나 지정된 명령 ID를 가진 요소가 실제로 없는 경우 FALSE입니다.

설명

위치에 따라 리본 요소를 바꾸려면 CMFCRibbonPanel::Replace를 호출 합니다.

CMFCRibbonPanel::SetCenterColumnVert

표시 사각형 내에서 리본 요소의 세로 위치 가운데 맞춤을 사용하거나 사용하지 않도록 설정합니다.

void SetCenterColumnVert(BOOL bSet = TRUE);

매개 변수

bSet
[in] TRUE이면 리본 요소의 세로 위치를 표시 사각형 내에 배치합니다. 이 기능을 사용하지 않도록 설정하려면 FALSE입니다.

설명

CMFCRibbonPanel::SetData

사용자 정의 데이터를 리본 패널에 연결합니다.

void SetData(DWORD_PTR dwData);

매개 변수

dwData
[in] 설정할 사용자 정의 데이터를 지정합니다.

설명

사용자 정의 데이터를 리본 패널과 연결하려면 이 메서드를 호출합니다.

CMFCRibbonPanel::SetElementMenu

지정된 명령 ID가 있는 요소에 팝업 메뉴를 할당합니다.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

매개 변수

uiCmdID
[in] 메뉴가 추가되는 리본 요소의 명령 ID를 지정합니다.

hMenu
[in] 리본 패널에 추가할 Windows 메뉴의 핸들을 지정합니다.

bIsDefautCommand
[in] TRUE이면 리본 요소를 클릭할 때 리본 요소와 연결된 명령을 실행해야 합니다. 이 경우 메뉴는 사용자가 리본 요소 옆의 화살표를 클릭할 때만 열립니다. 리본 요소를 클릭할 경우 리본 요소와 연결된 명령을 실행해서는 안 되도록 지정하는 FALSE입니다. 이 경우 사용자가 요소를 클릭하는 위치에 관계없이 팝업 메뉴가 나타납니다.

bRightAlign
[in] TRUE이면 팝업 메뉴가 오른쪽에 맞춰지도록 지정합니다. 그렇지 않으면 FALSE입니다.

uiMenuResID
[in] 리본 패널에 추가할 메뉴의 리소스 ID를 지정합니다.

Return Value

메뉴가 리본 요소에 할당된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

지정된 명령 ID가 있는 리본 요소에 팝업 메뉴를 할당하려면 이 메서드를 호출합니다.

CMFCRibbonPanel::SetElementRTC

제공된 런타임 클래스 정보로 지정된 리본 요소를 리본 패널에 추가합니다.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

매개 변수

nIndex
[in] 추가할 리본 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

pRTC
[in, out] 리본 패널에 추가되는 리본 요소의 런타임 클래스 정보에 대한 포인터입니다.

Return Value

지정된 런타임 클래스 정보를 사용하여 만든 리본 요소입니다.

설명

리본 패널에 사용자 지정 요소(예: 색 단추)를 추가하려면 사용자 지정 요소의 런타임 클래스 정보를 지정해야 합니다. 리본은 이 정보를 저장하고, 사용자 지정 요소를 만들고, 지정된 명령 ID에 있는(식별자) 기존 요소를 대체합니다. 리본은 새로 만든 요소에 대한 포인터를 반환합니다.

CMFCRibbonPanel::SetElementRTCByID

제공된 런타임 클래스 정보로 지정된 리본 요소를 리본 패널에 추가합니다.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

매개 변수

uiCmdID
[in] 추가할 리본 요소의 명령 ID를 지정합니다.

pRTC
[in, out] 리본 패널에 추가되는 리본 요소와 연결된 런타임 클래스 정보에 대한 포인터입니다.

Return Value

지정된 런타임 클래스 정보를 사용하여 만든 리본 요소입니다.

설명

리본 패널에 사용자 지정 요소(예: 색 단추)를 추가하려면 사용자 지정 요소의 런타임 클래스 정보를 지정해야 합니다. 리본은 이 정보를 저장하고, 사용자 지정 요소를 만들고, 지정된 명령 ID로 있는 기존 요소를 대체합니다. 그런 다음 새로 만든 요소에 대한 포인터를 반환합니다.

예시

다음 예제에서는 메서드를 사용하는 SetElementRTCByID 방법을 보여줍니다.

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

동일한 열에 있는 리본 요소의 너비 조정을 사용하거나 사용하지 않도록 설정합니다.

void SetJustifyColumns(BOOL bSet = TRUE);

매개 변수

bSet
[in] TRUE이면 동일한 열에 있는 리본 요소의 너비를 열에서 가장 큰 리본 요소의 너비로 조정합니다. 이 너비 조정을 사용하지 않도록 설정하려면 FALSE입니다.

설명

리본 패널에서 이 기능을 사용하도록 설정하면 동일한 열에 있는 리본 요소의 너비가 동일한 열에서 가장 큰 리본 요소의 너비로 조정됩니다.

CMFCRibbonPanel::SetKeys

리본 패널의 기본 단추에 대한 키 설명을 설정합니다.

void SetKeys(LPCTSTR lpszKeys);

매개 변수

lpszKeys
[in] 리본 패널의 기본 단추에 대한 키 설명입니다.

설명

리본 패널에 리본 요소를 표시할 공간이 부족한 경우 기본 단추가 표시됩니다.

CMFCRibbonPanel::ShowPopup

리본 패널에 대한 팝업 메뉴를 만들고 표시합니다.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

매개 변수

pButton
[in] 리본 패널의 기본 단추에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 리본 패널의 팝업 메뉴에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

리본 패널의 팝업 메뉴는 리본 패널의 표시가 축소된 경우에만 사용할 수 있습니다.

CMFCRibbonPanel::SetFocused

포커스를 지정된 Ribbon 요소로 설정합니다.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

매개 변수

pNewFocus
포커스를 받는 Ribbon 요소에 대한 포인터입니다.

설명

CMFCRibbonPanel::MakeGalleryItemVisible

갤러리를 스크롤하여 지정된 Ribbon 요소를 표시합니다.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

매개 변수

pItem
표시할 Ribbon 요소에 대한 포인터입니다.

설명

CMFCRibbonPanel::IsWindows7Look

부모 리본에 Windows 7 모양(작은 사각형 응용 프로그램 단추)이 있는지 여부를 나타냅니다.

BOOL IsWindows7Look() const;

Return Value

부모 리본에 Windows 7 모양이 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonPanel::GetVisibleElements

표시되는 요소의 배열을 검색합니다.

void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);

매개 변수

arElements
함수가 반환되면 이 매개 변수에는 표시되는 요소의 배열이 포함됩니다.

설명

CMFCRibbonPanel::GetGalleryRect

Gallery 요소의 경계 사각형을 반환합니다.

CRect GetGalleryRect();

Return Value

이 패널 내의 Gallery 요소의 크기 및 위치입니다.

설명

CMFCRibbonPanel::GetFocused

포커스가 지정된 요소를 반환합니다.

CMFCRibbonBaseElement* GetFocused() const;

Return Value

포커스가 있는 요소 또는 NULL에 대한 포인터입니다.

설명

참고 항목

계층 구조 차트
클래스
CObject 클래스
CMFCRibbonCategory 클래스
CMFCRibbonBaseElement 클래스