RibbonDropDown - интерфейс

Статья
05/19/2013

Представляет список элементов и список кнопок ленты, которые пользователь может выбрать или нажать соответственно.

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

Синтаксис

'Декларация
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Тип RibbonDropDown предоставляет следующие члены.

Свойства

	Имя	Описание
	Buttons	Получает коллекцию объектов RibbonButton, принадлежащих к данному объекту RibbonDropDown.
	Enabled	Возврат или установка значения, указывающего, включен ли объект RibbonControl. (Унаследовано от RibbonControl.)
	Id	Получает уникальную строку, используемую в Microsoft Office для идентификации данного объекта RibbonControl. (Унаследовано от RibbonControl.)
	Image	Возврат или установка изображения, которое отображается на объекте RibbonDropDown.
	ImageName	Возврат или установка имени, определяющего изображение элемента управления в обработчике событий LoadImage.
	Items	Получает коллекцию элементов в данном объекте RibbonDropDown.
	KeyTip	Получает или задает сочетание клавиш для данного RibbonDropDown.
	Label	Возврат или установка текста, отображаемого объектом RibbonDropDown.
	Name	Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	OfficeImageId	Возврат или установка изображения, отображаемого на объекте RibbonDropDown при использовании встроенного значка Microsoft Office.
	Parent	Возврат объекта RibbonComponent, который является родительским для этого объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	Ribbon	Возврат объекта верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent.)
	RibbonUI	Инфраструктура. Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent.)
	ScreenTip	Возвращает или задает текст подсказки, отображаемой при наведении указателя мыши на объект RibbonDropDown.
	SelectedItem	Возврат или установка выбранного на текущий момент объекта RibbonDropDownItem.
	SelectedItemIndex	Получает или задает индекс выбранного в настоящий момент объекта RibbonDropDownItem.
	ShowImage	Возврат или установка значения, которое определяет видимость изображения, связанного объектом RibbonDropDown.
	ShowItemImage	Возврат или установка значения, определяющего, отображаются ли изображения для элементов раскрывающегося меню.
	ShowItemLabel	Возврат или установка значения, определяющего, отображаются ли метки для элементов раскрывающегося меню.
	ShowLabel	Возврат или установка значения, определяющего видимость метки этого объекта RibbonDropDown.
	Site	Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.)
	SizeString	Возврат или установка строки, определяющей размер объекта RibbonDropDown.
	SuperTip	Возвращает или задает текст многострочной подсказки, отображаемой при наведении указателя мыши на объект RibbonDropDown.
	Tag	Возврат или установка данных приложения, связанных с этим объектом RibbonComponent. (Унаследовано от RibbonComponent.)
	Visible	Возврат или установка значения, определяющего видимость объекта RibbonControl. (Унаследовано от RibbonControl.)

В начало страницы

Методы

	Имя	Описание
	Dispose	Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
	PerformDynamicLayout	Вызов метода Microsoft.Office.Core.IRibbonUI.InvalidateControl родительского элемента управления, если для объекта RibbonComponent существует динамический родительский элемент, например динамическое меню, и размещение не приостановлено. (Унаследовано от RibbonComponent.)
	PerformLayout	Вызов метода Microsoft.Office.Core.IRibbonUI.InvalidateControl, если для объекта RibbonComponent существует родительский объект, и размещение не приостановлено. (Унаследовано от RibbonComponent.)
	ResumeLayout()	Отменяет результат вызова метода SuspendLayout. (Унаследовано от RibbonComponent.)
	ResumeLayout(Boolean)	Отменяет результат вызова метода SuspendLayout. (Унаследовано от RibbonComponent.)
	SuspendLayout	Запрет на обновление состояния элементов управления ленты в приложении Microsoft Office. (Унаследовано от RibbonComponent.)

В начало страницы

События

	Имя	Описание
	ButtonClick	Вызывается при нажатии пользователем кнопки объекта RibbonDropDown.
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
	ItemsLoading	Вызывается при загрузке элементов управления в объект RibbonDropDown.
	SelectionChanged	Вызывается при выборе нового элемента в раскрывающемся меню.

В начало страницы

Заметки

Объект RibbonDropDown может содержать объекты RibbonDropDownItem и элементы управления RibbonButton.

Можно создать RibbonDropDown во время выполнения, используя метод CreateRibbonDropDown объекта RibbonFactory.

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

С помощью свойства Factory класса ленты.Этот подход следует применять в коде класса ленты.
С помощью метода Globals.Factory.GetRibbonFactory.Этот подход следует применять за пределами класса ленты.

В коллекцию Buttons нельзя добавить кнопки во время выполнения, после загрузки ленты в Office.

Ниже приведены процедуры, в которых описывается порядок добавления объектов RibbonDropDownItem и элементов управления RibbonButton в объект RibbonDropDown.

Добавление объектов RibbonDropDownItem во время разработки

Выберите свойство Items в окне Свойства.
Нажмите кнопку с многоточием (...).
С помощью редактора коллекций раскрывающегося списка добавьте или измените новые элементы (также можно изменить их порядок).

Элементы управления RibbonButton можно добавлять к объекту RibbonDropDown только во время разработки.

Добавление элементов управления RibbonButton во время разработки

Щелкните свойство Buttons в окне Свойства.
Нажмите кнопку с многоточием (...).
С помощью редактора коллекций кнопок добавьте или измените новые элементы управления "кнопка" (также можно изменить их порядок).

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

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

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

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

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