RibbonSplitButton Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Элемент управления ленты, объединяющий кнопку или выключатель и раскрывающееся меню.
public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl
- Атрибуты
- Реализации
Комментарии
Элемент RibbonSplitButton управления объединяет кнопку или переключатель и раскрывающееся меню. Чтобы выбрать между кнопкой и переключателем, используйте ButtonType свойство .
RibbonMenu В отличие от элемента управления, RibbonSplitButton элемент управления не имеет Dynamic свойства , поэтому содержимое Items коллекции не может быть изменено во время выполнения.
Можно создать RibbonSplitButton во время выполнения с помощью CreateRibbonSplitButton метода 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.
Свойства
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. |
SuperTip |
Возврат или установка текста многострочной подсказки, отображаемой при наведении указателя мыши на элемент управления RibbonSplitButton. |
Tag |
Получает или задает данные приложения, связанные с этим объектом RibbonComponent. (Унаследовано от RibbonComponent) |
Title |
Получает или задает заголовок, который отображается вверху элемента управления RibbonSplitButton, если элемент управления находится в меню Microsoft Office. |
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 |
Происходит при нажатии элемента управления RibbonSplitButton. |