RibbonButton Интерфейс

Определение

public interface class RibbonButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("b57e6217-33f2-46bf-9625-c313526de60c")]
public interface RibbonButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("b57e6217-33f2-46bf-9625-c313526de60c")>]
type RibbonButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonButton
Implements IComponent, IDisposable, RibbonControl

Атрибуты

GuidAttribute

Реализации

RibbonComponent RibbonControl IComponent IDisposable

Примеры

В следующем примере создается новая кнопка, задаются различные свойства кнопки, а затем она добавляется в меню. Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия:

1. Добавление элемента ленты (visual Designer) в проект, созданный с помощью средств разработки Office в Visual Studio.

2. Добавьте группу на настраиваемую вкладку.

3. Добавьте меню в группу.

4. Присвойте свойству Dynamic меню значение true.

5. Задайте для свойства ItemSize меню значение RibbonControlSizeLarge.

private void AddButtonsToMenu()
{
    RibbonButton tempButton = this.Factory.CreateRibbonButton();
    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);

}

Private Sub AddButtonsToMenu()
    Dim tempButton = Me.Factory.CreateRibbonButton()
    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

Комментарии

Visual Studio создает экземпляр класса , который реализует RibbonButton интерфейс при перетаскивании элемента управления Кнопка с вкладки Элементы управления ленты Officeпанели элементов на Designer ленты.

Вы также можете создать экземпляр этого элемента управления во время выполнения и добавить его в динамическое меню. Меню является динамическим, если для его Dynamic свойства задано значение true.

Некоторые свойства этого элемента управления можно задать только перед загрузкой ленты в приложение Office или перед добавлением элемента управления в динамическое меню во время выполнения. Сведения о настройке этих свойств см. в разделе Общие сведения об объектной модели ленты.

Можно создать RibbonButton во время выполнения с помощью CreateRibbonButton метода RibbonFactory объекта .

Существует два способа доступа к объекту RibbonFactory:

• С помощью свойства Factory класса ленты. Используйте этот подход в коде в классе ленты.

• С помощью метода Globals.Factory.GetRibbonFactory. Используйте этот подход в коде вне класса ленты.

Общие задачи

В следующей таблице перечислены элементы, которые используются для распространенных задач.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию об этом типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Свойства

Методы

События

Применяется к