RibbonCheckBox Интерфейс

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Ribbon

Сборка:: Microsoft.Office.Tools.Common.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public interface class RibbonCheckBox : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")]
public interface RibbonCheckBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")>]
type RibbonCheckBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonCheckBox
Implements IComponent, IDisposable, RibbonControl

Атрибуты: GuidAttribute

Реализации: RibbonComponent RibbonControl IComponent IDisposable

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

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

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

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

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

Примечание

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

Свойства

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

События

Click

Происходит, когда пользователь устанавливает флажок.

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

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