다음을 통해 공유


CMFCRibbonButton 클래스

CMFCRibbonButton 패널, 빠른 액세스 도구 모음 및 팝업 메뉴와 같은 리본 표시줄 요소 클래스 구현 단추는 배치할 수 있습니다.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Members

Public 생성자

Name

설명

CMFCRibbonButton::CMFCRibbonButton

리본 단추 개체를 만듭니다.

Public 메서드

Name

설명

CMFCRibbonButton::AddSubItem

단추와 연결 된 팝업 메뉴에 메뉴 항목을 추가 합니다.

CMFCRibbonButton::CanBeStretched

  (재정의 CMFCRibbonBaseElement::CanBeStretched.)

CMFCRibbonButton::CleanUpSizes

  (재정의 CMFCRibbonBaseElement::CleanUpSizes.)

CMFCRibbonButton::ClosePopupMenu

  (재정의 CMFCRibbonBaseElement::ClosePopupMenu.)

CMFCRibbonButton::DrawBottomText

 

CMFCRibbonButton::DrawImage

  (재정의 CMFCRibbonBaseElement::DrawImage.)

CMFCRibbonButton::DrawRibbonText

 

CMFCRibbonButton::FindSubItemIndexByID

지정 된 명령 ID와 연결 된 팝업 메뉴 항목의 인덱스를 반환 합니다.

CMFCRibbonButton::GetCommandRect

 

CMFCRibbonButton::GetCompactSize

컴팩트한 사이즈의 리본 요소를 반환합니다. (재정의 CMFCRibbonBaseElement::GetCompactSize.)

CMFCRibbonButton::GetIcon

 

CMFCRibbonButton::GetImageIndex

단추와 연결 된 이미지의 인덱스를 반환 합니다.

CMFCRibbonButton::GetImageSize

이미지 크기의 리본 요소를 반환합니다. (재정의 CMFCRibbonBaseElement::GetImageSize.)

CMFCRibbonButton::GetIntermediateSize

리본 구성 요소의 크기를 중간 상태로 반환합니다. (재정의 CMFCRibbonBaseElement::GetIntermediateSize.)

CMFCRibbonButton::GetMenu

리본 메뉴 단추에 할당 된 Windows 메뉴의 핸들을 반환 합니다.

CMFCRibbonButton::GetMenuRect

 

CMFCRibbonButton::GetRegularSize

일반 크기의 리본 요소를 반환합니다. (재정의 CMFCRibbonBaseElement::GetRegularSize.)

CMFCRibbonButton::GetSubItems

 

CMFCRibbonButton::GetTextRowHeight

 

CMFCRibbonButton::GetToolTipText

리본 구성 요소의 도구 설명 텍스트를 반환합니다. (재정의 CMFCRibbonBaseElement::GetToolTipText.)

CMFCRibbonButton::HasCompactMode

리본 요소 컴팩트 모드에 있는지 여부를 지정 합니다. (재정의 CMFCRibbonBaseElement::HasCompactMode.)

CMFCRibbonButton::HasIntermediateMode

리본 요소 중간 모드에 있는지 여부를 지정 합니다. (재정의 CMFCRibbonBaseElement::HasIntermediateMode.)

CMFCRibbonButton::HasLargeMode

리본 요소 큰 모드에 있는지 여부를 결정 합니다. (재정의 CMFCRibbonBaseElement::HasLargeMode.)

CMFCRibbonButton::HasMenu

  (재정의 CMFCRibbonBaseElement::HasMenu.)

CMFCRibbonButton::IsAlwaysDrawBorder

 

CMFCRibbonButton::IsAlwaysLargeImage

  (재정의 CMFCRibbonBaseElement::IsAlwaysLargeImage.)

CMFCRibbonButton::IsApplicationButton

 

CMFCRibbonButton::IsCommandAreaHighlighted

 

CMFCRibbonButton::IsDefaultCommand

리본 메뉴 단추를 기본 명령 사용 여부를 결정 합니다.

CMFCRibbonButton::IsDefaultPanelButton

 

CMFCRibbonButton::IsDrawTooltipImage

 

CMFCRibbonButton::IsLargeImage

 

CMFCRibbonButton::IsMenuAreaHighlighted

 

CMFCRibbonButton::IsMenuOnBottom

 

CMFCRibbonButton::IsPopupDefaultMenuLook

 

CMFCRibbonButton::IsRightAlignMenu

메뉴 오른쪽 맞춤 인지 여부를 결정 합니다.

CMFCRibbonButton::IsSingleLineText

 

CMFCRibbonButton::OnCalcTextSize

  (재정의 CMFCRibbonBaseElement::OnCalcTextSize.)

CMFCRibbonButton::OnDrawBorder

 

CMFCRibbonButton::OnDraw

리본 요소를 그리려면 프레임 워크에서 호출 됩니다. (재정의 CMFCRibbonBaseElement::OnDraw.)

CMFCRibbonButton::OnFillBackground

 

CMFCRibbonButton::RemoveAllSubItems

팝업 메뉴에서 모든 메뉴 항목을 제거합니다.

CMFCRibbonButton::RemoveSubItem

팝업 메뉴에서 메뉴 항목을 제거합니다.

CMFCRibbonButton::SetACCData

  (재정의 CMFCRibbonBaseElement::SetACCData.)

CMFCRibbonButton::SetAlwaysLargeImage

사용자는 단추를 축소 하면 단추가 크게 표시 여부 또는 작은 이미지를 지정 합니다.

CMFCRibbonButton::SetDefaultCommand

리본 메뉴의 단추에 대 한 기본 명령이 있습니다.

CMFCRibbonButton::SetDescription

리본 요소에 대 한 설명을 설정합니다. (재정의 CMFCRibbonBaseElement::SetDescription.)

CMFCRibbonButton::SetImageIndex

단추의 이미지 인덱스를 지정 합니다.

CMFCRibbonButton::SetMenu

팝업 메뉴는 리본 메뉴 단추에 할당합니다.

CMFCRibbonButton::SetParentCategory

  (재정의 CMFCRibbonBaseElement::SetParentCategory.)

CMFCRibbonButton::SetRightAlignMenu

팝업 메뉴 단추를 오른쪽에 맞춥니다.

CMFCRibbonButton::SetText

리본 요소에 대 한 텍스트를 설정합니다. (재정의 CMFCRibbonBaseElement::SetText.)

Protected 메서드

Name

설명

CMFCRibbonButton::OnClick

사용자가 단추를 클릭할 때 프레임 워크에 의해 호출 됩니다.

예제

다음 예제에서는 다양 한 메서드를 사용 하는 방법의 CMFCRibbonButton 클래스입니다. 개체를 만드는 방법의 예제는 CMFCRibbonButton 클래스, 팝업 메뉴가 리본 단추에 할당, 단추에 대 한 설명을 설정 팝업 메뉴에서 메뉴 항목을 제거 및 단추 가장자리 팝업 메뉴 오른쪽 맞춤.

  strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button. 
    // The third parameter is a zero-based index of the button's small image in the  
    // image list of the parent category. 
    // The fourth parameter is a zero-based index of the button's large image in the  
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

설명

응용 프로그램에 리본 메뉴 단추를 사용 하려면 단추 개체를 생성 하 고 해당 리본 메뉴에 추가 패널.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));

상속 계층 구조

CObject

   CMFCRibbonBaseElement

      CMFCRibbonButton

요구 사항

헤더: afxribbonbutton.h

참고 항목

참조

계층 구조 차트

기타 리소스

MFC 클래스