RibbonGroup - интерфейс

Статья
08/11/2011

Представляет группу элементов управления на вкладке ленты.

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

Синтаксис

'Декларация
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

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

Свойства

	Имя	Описание
	DialogLauncher	Возврат или установка кнопки вызова диалогового окна ленты, связанной с группой.
	Id	Возврат строки, определяющей текущую группу.
	Items	Возврат элементов управления группы.
	KeyTip	Возврат или установка сочетания клавиш для группы.
	Label	Возврат или установка текста, отображаемого в качестве метки группы.
	Name	Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	Parent	Возврат объекта RibbonComponent, который является родительским для этого объекта RibbonComponent. (Унаследовано от RibbonComponent.)
	Position	Возврат или установка положения группы на встроенной вкладке по отношению ко встроенной группе.
	Ribbon	Возврат объекта верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent.)
	RibbonUI	Инфраструктура. Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent.)
	Site	Получает или задает интерфейс ISite, связанный с интерфейсом IComponent. (Унаследовано от IComponent.)
	Tag	Возврат или установка данных приложения, связанных с этим объектом RibbonComponent. (Унаследовано от RibbonComponent.)
	Visible	Возврат или установка значения, определяющего видимость группы.

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

Методы

	Имя	Описание
	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.)

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

События

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

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

Заметки

Visual Studio создает объект RibbonGroup при перетаскивании элемента управления Группа из вкладки Элементы управления ленты Office в конструктор ленты Панель инструментов.

Общие задачи

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

Задача	Элемент
Обращение к элементам управления группы, их добавление или удаление.	Используйте свойство Items.
Добавление группы на вкладку ленты.	Добавьте RibbonGroup в коллекцию Groups вкладки.
Установка положения группы на встроенной вкладке по отношению ко встроенной группе.	Используйте свойство Position.

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