RibbonGallery Интерфейс

Определение

Пространство имен:

Microsoft.Office.Tools.Ribbon

Сборка:

Microsoft.Office.Tools.Common.dll

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

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Атрибуты

GuidAttribute

Реализации

RibbonComponent RibbonControl IComponent IDisposable

Комментарии

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

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

Свойство ShowItemSelection определяет, визуально ли выбранный элемент RibbonDropDownItem отличается от невыбранных элементов. В можно выбрать только один элемент за раз в RibbonGallery.

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

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

1. Щелкните свойство Items в окне Свойства .

2. Щелкните многоточие (...).

3. В раскрывающемся списке Коллекция Редактор, добавлять, упорядочить и изменять новые элементы.

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

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

1. Щелкните свойство Button в окне Свойства .

2. Щелкните многоточие (...).

3. В коллекции кнопок Редактор добавить, упорядочить и изменить новые элементы управления "Кнопка".

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

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

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

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

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

Примечание

Данный интерфейс реализуется набором средств Visual Studio Tools for 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.

Свойства

Buttons	Получает коллекцию кнопок для этого объекта RibbonGallery.
ColumnCount	Возвращает или задает число столбцов Элемент в этом 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.
SuperTip	Получает или задает текст многострочной подсказки, отображаемой при наведении указателя мыши на объект RibbonGallery.
Tag	Получает или задает данные приложения, связанные с этим объектом RibbonComponent. (Унаследовано от RibbonComponent)
Visible	Получает или задает значение, указывающее, видим ли этот объект RibbonControl. (Унаследовано от RibbonControl)

Методы

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.
ItemsLoading	Происходит при открытии объекта RibbonGallery.