RibbonDialogLauncher Класс (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Представляет небольшой стандартный значок в группе, с помощью которого открывается диалоговое окно.

Пространство имен: Microsoft.Office.Tools.Ribbon
Сборка: Microsoft.Office.Tools.Common.v9.0 (в Microsoft.Office.Tools.Common.v9.0.dll)

Синтаксис

'Декларация
Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable
'Применение
Dim instance As RibbonDialogLauncher

public sealed class RibbonDialogLauncher : IDisposable

Заметки

Объект RibbonDialogLauncher по умолчанию отображается в левом нижнем углу группы.

Свойства Image, ImageName и OfficeImageId не имеют видимого действия, если на группе ленты отображается объект RibbonDialogLauncher. Однако при добавлении объекта RibbonDialogLauncher на панель быстрого доступа эти свойства определяют поведение отображаемого изображения. Также свойство Visible не может использоваться для скрытия объекта RibbonDialogLauncher, отображаемого в панели быстрого доступа. Пользователь можно добавить объект RibbonDialogLauncher на панель быстрого доступа с помощью пункта меню Лента (XML). Дополнительные сведения см. в разделе Обзор ленты.

Объект RibbonDialogLauncher применяется только к объекту RibbonGroup. Класс RibbonGroup содержит член свойства DialogLauncher, который имеет тип RibbonDialogLauncher. Дополнительные сведения о добавлении объекта RibbonDialogLauncher к объекту RibbonGroup см. в разделе Практическое руководство. Добавление кнопки запуска диалогового окна в группу ленты.

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

Примеры

В следующем примере демонстрируется добавление объекта RibbonDialogLauncher в группу ленты и открытие пользовательского диалогового окна, которое позволяет выбрать дополнительные параметры. Диалоговое окно открывается по щелчку значка RibbonDialogLauncher, находящегося в нижнем правом углу группы ленты RibbonGroup.

Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте элемент RibbonDialogLauncher в группу по умолчанию Group1 как описано в разделе Практическое руководство. Добавление кнопки запуска диалогового окна в группу ленты.
В проекте Visual Basic добавьте в проект новый элемент Диалоговое окно. В проекте C# добавьте элемент форма Windows Forms и превратите его в диалоговое окно, добавив на форму кнопки ОК и Отмена и создав обработчики событий нажатия кнопок.
Установите для свойства (Name) диалогового окна значение advancedSettingsDialog. Можно настроить это диалоговое окно, добавив другие элементы управления и установив дополнительные свойства.
Добавьте обработчик событий DialogLauncherClick.
Поместите содержимое следующего метода в обработчик событий DialogLauncherClick.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}

Иерархия наследования

System.Object
Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.