RibbonGallery Класс (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

Синтаксис

'Декларация
<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl
'Применение
Dim instance As RibbonGallery

[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

Заметки

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

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

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

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

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

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

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

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

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

Создайте новый объект RibbonDropDownItem с помощью метода RibbonDropDownItem.
Добавьте созданный объект RibbonDropDownItem в коллекцию Items объекта RibbonGallery.

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

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

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

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

Иерархия наследования

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.