RibbonButton.ControlSize Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возврат или установка размера кнопки.

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

Синтаксис

'Декларация
Public Property ControlSize As RibbonControlSize
'Применение
Dim instance As RibbonButton
Dim value As RibbonControlSize

value = instance.ControlSize

instance.ControlSize = value

public RibbonControlSize ControlSize { get; set; }

Значение свойства

Тип: Microsoft.Office.Core.RibbonControlSize
Объект Microsoft.Office.Core.RibbonControlSize, представляющий размер кнопки.

Заметки

Если выключатель входит в состав меню, значение этого свойства игнорируется. При отображении кнопки меню значение ее свойства ControlSize принимается равным значению свойства ItemSize родительского меню. Чтобы отобразить крупные кнопки в меню, установите для свойства ItemSize объекта RibbonMenu значение Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.

Примеры

В следующем примере отображаются крупные кнопки. Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте группу на пользовательскую вкладку.
Добавьте кнопку в группу.

Private Sub SetButtonProperties()
    Button1.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    button1.Description = "My Ribbon Button"
End Sub

private void SetButtonProperties()
{
    button1.ControlSize = 
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    button1.Description = "My Ribbon Button";
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.