RibbonGroup.DialogLauncherClick - событие

Статья
05/19/2013

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

Пространство имен: 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 - пространство имен

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

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

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