RibbonGroup.DialogLauncherClick - событие

Статья
08/11/2011

Происходит при нажатии кнопки вызова диалогового окна ленты.

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

Синтаксис

'Декларация
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

Заметки

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

Примеры

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

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

Добавьте элемент Лента (визуальный конструктор) в проект Office.
Добавьте элемент RibbonDialogLauncher в группу по умолчанию, как описано в разделе Практическое руководство. Добавление кнопки запуска диалогового окна в группу ленты.
В проекте Visual Basic добавьте в проект новый элемент “форма Windows Forms” Диалоговое окно. В проекте 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();
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

RibbonGroup Интерфейс

Microsoft.Office.Tools.Ribbon - пространство имен

Другие ресурсы

Практическое руководство. Добавление кнопки запуска диалогового окна в группу ленты

Поделиться через