RibbonSplitButton - интерфейс

Статья
08/11/2011

Элемент управления ленты, в котором объединяются кнопка или выключатель и раскрывающееся меню.

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

Синтаксис

'Декларация
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Свойства

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

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

События

	Имя	Описание
	Click	Происходит при нажатии элемента управления RibbonSplitButton.
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)

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

Заметки

В элементе управления RibbonSplitButton объединяются кнопка или выключатель и раскрывающееся меню. Чтобы использовать кнопку или выключатель, установите соответствующее значение свойства ButtonType.

В отличие от элемента управления RibbonMenu, элемент RibbonSplitButton не содержит свойства Dynamic, в связи с чем изменение коллекции Items во время выполнения невозможно.

Можно создать RibbonSplitButton во время выполнения, используя метод CreateRibbonSplitButton объекта RibbonFactory.

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

С помощью свойства Factory класса ленты. Этот подход следует применять в коде класса ленты.
С помощью метода Globals.Factory.GetRibbonFactory. Этот подход следует применять за пределами класса ленты.

Примечание

Данный интерфейс реализован средствами 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.