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

RibbonDropDown Интерфейс

  • Ссылка

Определение

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

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

public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl
Атрибуты
GuidAttribute
Реализации
RibbonComponent RibbonControl IComponent IDisposable

Комментарии

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Некоторые элементы этого типа можно задать только перед загрузкой ленты в приложение 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

Получает коллекцию объектов 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.
SizeString

Получает или задает строку, которая определяет размер RibbonDropDown.
SuperTip

Получает или задает текст многострочной подсказки, отображаемой при наведении указателя мыши на объект RibbonDropDown.
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

Происходит, когда пользователь нажимает кнопку в объекте RibbonDropDown.
ItemsLoading

Вызывается при загрузке элементов управления в объект RibbonDropDown.
SelectionChanged

Вызывается при выборе нового элемента в раскрывающемся меню.

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