RibbonBox Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Упорядочивает и выравнивает элементы управления на пользовательской ленте.
public interface class RibbonBox : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("e351eac0-961f-458a-8811-58090e3198ef")]
public interface RibbonBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("e351eac0-961f-458a-8811-58090e3198ef")>]
type RibbonBox = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonBox
Implements IComponent, IDisposable, RibbonControl
- Атрибуты
- Реализации
Комментарии
Автоматически RibbonBox выравнивает элементы управления ленты по мере их перетаскивания на него.
Используйте свойство для BoxStyle размещения дочерних элементов управления по горизонтали (по умолчанию) или по вертикали. Если для элементов управления задано вертикальное расположение и недостаточно места, они располагаются в нескольких столбцах.
Некоторые свойства этого элемента управления можно задать только перед загрузкой ленты в приложение Office. Сведения о настройке этих свойств см. в разделе Общие сведения об объектной модели ленты.
Можно создать RibbonBox во время выполнения с помощью CreateRibbonBox метода 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.
Свойства
BoxStyle |
Получает значение RibbonBoxStyle, указывающее, будут ли элементы управления, размещенные в этом объекте RibbonBox, размещаться горизонтально или вертикально. |
Enabled |
Получает или задает значение, указывающее, включен ли этот объект RibbonControl. (Унаследовано от RibbonControl) |
Id |
Получает строку, используемую Microsoft Office для идентификации этого объекта RibbonControl. (Унаследовано от RibbonControl) |
Items |
Получает коллекцию элементов управления, расположенных в этом объекте RibbonBox. |
Name |
Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent) |
Parent |
Получает объект RibbonComponent, представляющий родительский объект этого объекта RibbonComponent. (Унаследовано от RibbonComponent) |
Ribbon |
Получает объект верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent) |
RibbonUI |
Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent) |
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) |