Поделиться через


RibbonGallery Интерфейс

Определение

Представляет элемент управления, отображающий меню, которое содержит объекты 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
Атрибуты
Реализации

Комментарии

Как и интерфейс 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.

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