RibbonDialogLauncher Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет небольшой стандартный значок для группы, который может использоваться для открытия диалогового окна.
[System.Runtime.InteropServices.Guid("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable
- Атрибуты
- Реализации
Примеры
В следующем примере показано, как добавить объект RibbonDialogLauncher в группу ленты и как запустить пользовательское диалоговое окно, которое позволяет пользователям выбирать дополнительные параметры при щелчке RibbonDialogLauncher значка в правом нижнем углу RibbonGroup .
Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия.
Добавьте элемент Лента (визуальный конструктор) в проект Office.
Добавьте в RibbonDialogLauncher группу по умолчанию
Group1, как описано в этой статьи. Добавление средства запуска диалогового окна в группу ленты.Если вы используете Visual Basic, добавьте в проект новый элемент диалогового окна . Если вы используете C#, добавьте новый элемент формы Windows и превратите его в диалоговое окно, добавив кнопки ОК и Отмена в форму и создав обработчики событий для событий нажатия кнопки.
Задайте для свойства (имя) диалогового окна значение
advancedSettingsDialog. Диалоговое окно можно настроить, добавив элементы управления и задав дополнительные свойства.Добавьте DialogLauncherClick обработчик событий в код.
Поместите содержимое следующего метода в 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. |