RibbonDialogLauncher Интерфейс

Определение

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

[System.Runtime.InteropServices.Guid("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable
Атрибуты
Реализации

Примеры

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

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

  1. Добавьте элемент Лента (визуальный конструктор) в проект Office.

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

  3. Если вы используете Visual Basic, добавьте в проект новый элемент диалогового окна . Если вы используете C#, добавьте новый элемент формы Windows и превратите его в диалоговое окно, добавив кнопки ОК и Отмена в форму и создав обработчики событий для событий нажатия кнопки.

  4. Задайте для свойства (имя) диалогового окна значение advancedSettingsDialog . Диалоговое окно можно настроить, добавив элементы управления и задав дополнительные свойства.

  5. Добавьте DialogLauncherClick обработчик событий в код.

  6. Поместите содержимое следующего метода в DialogLauncherClick обработчик событий.

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}
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

Комментарии

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

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

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

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

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

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

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

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

Примечание

Данный интерфейс реализуется набором средств Visual Studio для Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Visual Studio Tools for Office Runtime Overview.

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

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

Свойства

Enabled

Получает или задает значение, указывающее, включен ли этот объект RibbonDialogLauncher.

Image

Получает или задает изображение, которое отображается для этого объекта RibbonDialogLauncher при добавлении в панель быстрого доступа.

ImageName

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

KeyTip

Получает или задает сочетание клавиш для этого объекта RibbonDialogLauncher.

OfficeImageId

Получает или задает изображение, отображаемое для этого объекта RibbonDialogLauncher при использовании встроенного значка Microsoft Office.

Parent

Получает объект RibbonGroup, членом которого является этот объект RibbonDialogLauncher.

Ribbon

Возврат объекта OfficeRibbon, на котором размещается объект RibbonDialogLauncher.

ScreenTip

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

SuperTip

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

Visible

Получает или задает значение, указывающее, видим ли этот объект RibbonDialogLauncher.

Методы

ResumeLayout()

Отменяет результат вызова метода SuspendLayout().

SuspendLayout()

Запрещает обновление состояния элементов управления приложением Microsoft Office в OfficeRibbon.

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