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

Элемент кнопки

  • Статья

Определяет элемент, с которым пользователь может взаимодействовать. Кнопки могут быть различных типов: Button, MenuButton и SplitDropDown.

Синтаксис

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
  <Parent>... </Parent>
  <Icon>... </Icon>
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</Button>

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Description
guid Обязательно. GUID идентификатора команды GUID/ID.
id Обязательно. Идентификатор идентификатора команды GUID/ID.
priority Необязательно. Числовое значение, указывающее приоритет.
type Необязательно. Перечисленное значение, указывающее тип кнопки.

Если это не задано, использует кнопку.

Кнопка
Стандартная команда, которая отображается на панелях инструментов (обычно как знаковая кнопка), меню и контекстные меню.

MenuButton
Элемент меню, который не выполняет команду, но создает другое меню.

SplitDropDown
Элементы управления, такие как кнопки отмены и повтора на стандартной панели инструментов в Microsoft Word.
Condition Необязательно. См . условные атрибуты.

Дочерние элементы

Элемент Description
Родительский элемент Необязательно. Родительский элемент кнопки.
Элемент Icon Необязательно. Значок, связанный с кнопкой.
Элемент флага команды Обязательно. Допустимые значения CommandFlag для кнопки приведены ниже.

— AllowParams

— CommandWellOnly

— DefaultDisabled

— DefaultInvisible

- DontCache

— DynamicItemStart

— DynamicVisibility

— FixMenuController

- IconAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferedCmd

- RouteToDocs

— TextCascadeUseBtn

— TextMenuUseButton

— TextChanges

— TextChangesButton

— TextContextUseButton

— TextMenuCtrlUseMenu

— TextMenuUseButton

— TextOnly
Элемент Strings Обязательно. Необходимо определить дочерний элемент ButtonText.
Номер Необязательный комментарий.

Родительские элементы

Элемент Description
Элемент Button Элементы "Группы кнопок".

Пример

В следующем примере определяется кнопка в VSCT-файле .

<Button guid="guidMenuTextCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
   <Parent guid="guidMenuTextCmdSet" id="MyMenuGroup" />
   <Icon guid="guidImages" id="bmpPic1" />
   <CommandFlag>TextChanges</CommandFlag>
   <Strings>
         <CommandName>cmdidMyCommand</CommandName>
         <ButtonText>My Command name</ButtonText>
   </Strings>
</Button>

См. также