RibbonGallery - интерфейс

Статья
08/11/2011

Представляет элемент управления, отображающий меню, которое содержит объекты RibbonDropDownItem и элементы управления RibbonButton.

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

Синтаксис

'Декларация
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Свойства

	Имя	Описание
	Buttons	Получает коллекцию кнопок на данном объекте RibbonGallery.
	ColumnCount	Возврат или установка числа столбцов Item в объекте RibbonGallery.
	ControlSize	Получает или задает размер элемента управления RibbonGallery.
	Description	Возврат или установка текста, отображаемого на элементе управления RibbonGallery в меню или на разворачивающейся кнопке.
	Enabled	Возврат или установка значения, указывающего, включен ли объект RibbonControl. (Унаследовано от RibbonControl.)
	Id	Получает уникальную строку, используемую в Microsoft Office для идентификации данного объекта RibbonControl. (Унаследовано от RibbonControl.)
	Image	Возврат или установка изображения, отображаемого на кнопке.
	ImageName	Возврат или установка имени, определяющего объект RibbonGallery в обработчике событий LoadImage.
	ItemImageSize	Возврат или установка объекта Size, содержащего размеры изображений, отображаемых элементами объекта RibbonGallery.
	Items	Получает коллекцию компонентов RibbonDropDownItem в данном объекте RibbonGallery.
	KeyTip	Возврат или установка сочетания клавиш, используемого для объекта RibbonGallery.
	Label	Возврат или установка текста, отображаемого объектом RibbonGallery.
	Name	Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	OfficeImageId	Возврат или установка изображения, отображаемого на элементе управления при использовании встроенного значка Microsoft Office.
	Parent	Возврат объекта RibbonComponent, который является родительским для этого объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	Position	Возврат или установка положения коллекции в меню Microsoft Office.
	Ribbon	Возврат объекта верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent.)
	RibbonUI	Инфраструктура. Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent.)
	RowCount	Возврат или установка числа строк компонентов RibbonDropDownItem, которые отображаются объектом RibbonGallery.
	ScreenTip	Возврат или установка текста подсказки, отображаемой при наведении указателя мыши на объект RibbonGallery.
	SelectedItem	Возврат или установка выбранного на текущий момент элемента.
	SelectedItemIndex	Возврат или установка индекса выбранного на текущий момент объекта RibbonDropDownItem.
	ShowImage	Возврат или установка значения, которое определяет видимость изображения, связанного объектом RibbonGallery.
	ShowItemImage	Возврат или установка значения, определяющего, отображаются ли изображения для элементов коллекции.
	ShowItemLabel	Возврат или установка значения, определяющего отображение меток для элементов объекта RibbonGallery.
	ShowItemSelection	Возврат или установка значения, определяющего режим выделения выбранного элемента RibbonDropDownItem по отношению к невыбранным.
	ShowLabel	Возврат или установка значения, определяющего видимость метки этого объекта RibbonGallery.
	Site	Получает или задает интерфейс ISite, связанный с интерфейсом IComponent. (Унаследовано от IComponent.)
	SuperTip	Возврат или установка текста многострочной подсказки, отображаемой при наведении указателя мыши на объект RibbonGallery.
	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	Вызывается при нажатии пользователем кнопки объекта RibbonGallery.
	Click	Вызывается при щелчке пользователем элемента объекта RibbonGallery.
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
	ItemsLoading	Вызывается при открытии объекта RibbonGallery.

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

Заметки

Как и интерфейс RibbonDropDown, RibbonGallery отображает меню, которое содержит объекты RibbonDropDownItem и элементы управления RibbonButton.

В отличие от интерфейса RibbonDropDown, интерфейс RibbonGallery вызывает события Click, вместо событий SelectionChanged которые происходят, когда пользователь щелкает RibbonDropDownItem. Например, это означает, что событие Click вызывается дважды при двойном щелчке одного объекта RibbonDropDownItem. (В этом случае событие SelectionChanged вызывалось бы не более одного раза при выполнении первоначального выбора в объекте RibbonDropDown в зависимости от того, какие элементы были выбраны перед первым щелчком.)

Свойство ShowItemSelection определяет режим выделения выбранного элемента RibbonDropDownItem по отношению к невыбранным. В объекте RibbonGallery допускается одновременный выбор только одного элемента.

С помощью свойства ItemImageSize можно задать размер изображения, отличающийся от форматов 16x16 и 32x32.

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

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

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

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

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

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

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

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

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

Примечание

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

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

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