RibbonButton 클래스(2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

사용자 지정 리본 메뉴의 단추를 나타냅니다.

네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)

구문

<ToolboxBitmapAttribute(GetType(RibbonButton), "RibbonButton.bmp")> _
Public NotInheritable Class RibbonButton _
    Inherits RibbonControl

Dim instance As RibbonButton

[ToolboxBitmapAttribute(typeof(RibbonButton), "RibbonButton.bmp")]
public sealed class RibbonButton : RibbonControl

설명

도구 상자의 Office 리본 컨트롤 탭에서 Button 컨트롤을 리본 디자이너로 끌어 오면 Visual Studio Tools for Office에서는 RibbonButton 클래스의 인스턴스를 만듭니다.

런타임에 이 컨트롤의 인스턴스를 만들어 동적 메뉴에 추가할 수도 있습니다. Dynamic 속성이 true로 설정된 메뉴가 동적 메뉴입니다.

이 컨트롤의 일부 속성은 Office 응용 프로그램에 리본 메뉴가 로드되기 전 또는 런타임에 동적 메뉴에 컨트롤이 추가되기 전에만 설정할 수 있습니다. 이러한 속성 설정에 대한 자세한 내용은 리본 개체 모델 개요를 참조하십시오.

일반 작업

다음 표에서는 일반적인 작업에 유용한 멤버를 보여 줍니다.

작업	멤버
런타임에 Dynamic 속성이 true로 설정된 메뉴에 단추를 추가합니다.	RibbonButton 생성자를 사용하여 RibbonButton 클래스의 인스턴스를 만듭니다. 메뉴의 Items 컬렉션에 인스턴스를 추가합니다.
단추의 크기를 변경합니다.	ControlSize를 원하는 값으로 설정합니다. 예를 들어 큰 단추의 경우 이 속성을 Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge로 설정합니다.
단추에 이미지를 표시합니다.	이미지를 표시하는 방법에는 다음과 같은 세 가지가 있습니다. Image 속성을 사용합니다. 이 속성을 사용하면 가장 효과적으로 제어할 수 있습니다. OfficeImageId를 단추의 아이콘으로 표시할 기본 제공 Microsoft Office 이미지의 ID로 설정합니다. ImageName 속성을 LoadImage 이벤트와 함께 사용합니다. 이 속성을 사용하면 성능이 향상될 수 있습니다.
단추를 비활성화하거나 숨깁니다.	단추를 비활성화하려면 Enabled를 false로 설정합니다. 단추를 숨기려면 Visible를 false로 설정합니다.
사용자가 단추를 클릭할 때 코드를 실행합니다.	Click 이벤트 처리기에 코드를 추가합니다.

예제

다음 예제에서는 새 단추를 만들고 단추의 여러 속성을 설정한 다음 해당 단추를 메뉴에 추가합니다. 이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

리본(비주얼 디자이너) 항목을 Visual Studio Tools for Office 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
그룹에 메뉴를 추가합니다.
메뉴의 Dynamic 속성을 true로 설정합니다.
메뉴의 ItemSize 속성을 RibbonControlSizeLarge로 설정합니다.

Private Sub AddButtonsToMenu()
    Dim tempButton As New RibbonButton()
    tempButton.Label = "Button 1"
    tempButton.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    tempButton.Description = "My Ribbon Button"
    tempButton.ShowImage = True
    tempButton.ShowImage = True
    tempButton.Image = My.Resources.Image1
    tempButton.Image = My.Resources.Image2
    tempButton.KeyTip = "A1"
    menu1.Items.Add(tempButton)
End Sub

private void AddButtonsToMenu()
{
    RibbonButton tempButton = new RibbonButton();
    tempButton.Label = "Button 1";
    tempButton.ControlSize = 
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    tempButton.Description = "My Ribbon Button";
    tempButton.ShowImage = true;
    tempButton.ShowImage = true;
    tempButton.Image = Properties.Resources.Image1;
    tempButton.Image = Properties.Resources.Image2;
    tempButton.KeyTip = "A1";
    menu1.Items.Add(tempButton);

}