RibbonCheckBox - интерфейс

Статья
05/19/2013

Представляет элемент управления "флажок" на ленте.

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

Синтаксис

'Декларация
<GuidAttribute("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")> _
Public Interface RibbonCheckBox _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")]
public interface RibbonCheckBox : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Свойства

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

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

Заметки

Можно создать экземпляр этого элемента управления во время выполнения и добавить его в динамическое меню.Динамическим называется меню, для свойства Dynamic которого установлено значение true.

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

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

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

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

Примечание
Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.