CMFCRibbonPanel 클래스
리본 요소 집합이 포함된 패널을 구현합니다. 패널을 그리면 지정된 패널 크기에 가능한 한 많은 요소를 표시합니다.
자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.
구문
class CMFCRibbonPanel : public CObject
멤버
보호된 생성자
| 속성 | 설명 |
|---|---|
| CMFCRibbonPanel::CMFCRibbonPanel | CMFCRibbonPanel 개체를 생성하고 초기화합니다. |
공용 메서드
설명
리본 패널은 리본 범주 내에서 만드는 관련 작업의 논리적 그룹입니다. 리본 메뉴의 크기가 변경되면 패널 레이아웃이 가능한 한 많은 요소를 표시하도록 자동으로 조정됩니다.
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();
상속 계층 구조
요구 사항
헤더: 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 클래스
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기