RibbonGroup.DialogLauncher - свойство

Статья
05/19/2013

Возврат или установка кнопки вызова диалогового окна ленты, связанной с группой.

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

Синтаксис

'Декларация
Property DialogLauncher As RibbonDialogLauncher

RibbonDialogLauncher DialogLauncher { get; set; }

Значение свойства

Тип: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
Кнопка вызова диалогового окна ленты, связанная с группой.

Заметки

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

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

Некоторые свойства интерфейса RibbonDialogLauncher, например свойство Image, применимы только при их добавлении конечным пользователем на панель быстрого доступа.

Примеры

В следующем примере показано, как установить свойства KeyTip и ScreenTip элемента управления RibbonDialogLauncher, добавленного в группу по умолчанию.

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

Добавьте элемент Лента (визуальный конструктор) в проект Office.
Добавьте элемент RibbonDialogLauncher в группу по умолчанию Group1 как описано в разделе Практическое руководство. Добавление кнопки запуска диалогового окна в группу ленты.

Private Sub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"
End Sub

private void SetDialogLauncherProperties()
{
    group1.DialogLauncher.KeyTip = "A";
    group1.DialogLauncher.ScreenTip = "Advanced Settings";
}

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

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