RibbonComboBox - интерфейс

Статья
08/11/2011

Представляет поле со списком на пользовательской ленте.

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

Синтаксис

'Декларация
<GuidAttribute("97074be3-d4bb-4923-881a-7a6e225738af")> _
Public Interface RibbonComboBox _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("97074be3-d4bb-4923-881a-7a6e225738af")]
public interface RibbonComboBox : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Свойства

	Имя	Описание
	Enabled	Возврат или установка значения, указывающего, включен ли объект RibbonControl. (Унаследовано от RibbonControl.)
	Id	Получает уникальную строку, используемую в Microsoft Office для идентификации данного объекта RibbonControl. (Унаследовано от RibbonControl.)
	Image	Получает или задает изображение, отображаемое в данном объекте RibbonComboBox.
	ImageName	Возврат или установка имени, определяющего изображение элемента управления в обработчике событий LoadImage.
	Items	Получает коллекцию элементов в данном объекте RibbonComboBox.
	KeyTip	Возврат или установка сочетания клавиш, используемого для объекта RibbonComboBox.
	Label	Возврат или установка текста, отображаемого объектом RibbonComboBox.
	MaxLength	Возврат или установка значения, определяющего максимально допустимое число знаков для ввода в объекте RibbonComboBox.
	Name	Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	OfficeImageId	Возврат или установка изображения, отображаемого на объекте RibbonComboBox при использовании встроенного значка Microsoft Office.
	Parent	Возврат объекта RibbonComponent, который является родительским для этого объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	Ribbon	Возврат объекта верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent.)
	RibbonUI	Инфраструктура. Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent.)
	ScreenTip	Возврат или установка текста подсказки, отображаемой при наведении указателя мыши на объект RibbonComboBox.
	ShowImage	Возврат или установка значения, которое определяет видимость изображения, связанного с объектом RibbonComboBox.
	ShowItemImage	Возврат или установка значения, определяющего, отображаются ли изображения для элементов раскрывающегося меню.
	ShowLabel	Возврат или установка значения, определяющего видимость метки этого объекта RibbonComboBox.
	Site	Получает или задает интерфейс ISite, связанный с интерфейсом IComponent. (Унаследовано от IComponent.)
	SizeString	Возврат или установка строки, определяющей размер объекта RibbonComboBox.
	SuperTip	Возвращает или задает текст многострочной подсказки, отображаемой при наведении указателя мыши на объект RibbonComboBox.
	Tag	Возврат или установка данных приложения, связанных с этим объектом RibbonComponent. (Унаследовано от RibbonComponent.)
	Text	Возврат или установка текста, отображаемого в объекте RibbonComboBox.
	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.)

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

События

	Имя	Описание
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
	ItemsLoading	Происходит при открытии раскрывающегося списка объекта RibbonComboBox.
	TextChanged	Происходит при изменении текста в объекте RibbonComboBox пользователем.

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

Заметки

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

Можно создать RibbonComboBox во время выполнения, используя метод CreateRibbonComboBox объекта 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.