Command, элемент

  • Статья

Представляет определение команды.

Использование

<Command
  Name = "xs:string"
  Symbol = "xs:string"
  Id = "xs:positiveInteger union xs:string"
  Comment = "xs:string"
  LabelTitle = "xs:string"
  LabelDescription = "xs:string"
  TooltipTitle = "xs:string"
  TooltipDescription = "xs:string"
  Keytip = "xs:string">
  child elements
</Command>

Атрибуты

attribute Тип Обязательно Описание
Комментарий
 xs:string
 Нет
 Используется для создания заметки к элементу команды.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы и символы разрыва строки.
Максимальная длина: 250 символов.
Id
 xs:positiveInteger union xs:string
 Нет
 Уникальный идентификатор ресурса.

(Объединение xs:positiveInteger и xs:string)
Целочисленное значение от 2 до 59999 включительно или 0x2 и 0xea5f в шестнадцатеричном формате.
Максимальная длина составляет 10 символов, включая необязательные начальные нули.
Подсказка клавиши
 xs:string
 Нет
 Строка, представляющая сочетание клавиш командного элемента.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы.
LabelDescription
 xs:string
 Нет
 Строка, представляющая текст, отображаемый в элементе команды.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы и символы разрыва строки.
LabelTitle
 xs:string
 Нет
 Строка, представляющая текст, отображаемый в элементе команды.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы и символы разрыва строки.
имя;
 xs:string
 Нет
(xs:string)
Строка, состоящая из буквы или подчеркивания, за которой следует любая последовательность цифр, букв или символов подчеркивания.
Максимальная длина: 100 символов.
Символ
 xs:string
 Нет
(xs:string)
Строка, состоящая из буквы или подчеркивания, за которой следует любая последовательность цифр, букв или символов подчеркивания.
Максимальная длина: 100 символов.
TooltipDescription
 xs:string
 Нет
 Строка, представляющая текст, отображаемый в элементе команды.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы и символы разрыва строки.
ПодсказкаTitle
 xs:string
 Нет
 Строка, представляющая текст, отображаемый в элементе команды.

(xs:string)
Строка, состоящая из любой последовательности символов, включая пробелы и символы разрыва строки.

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

Элемент Описание
Command.Comment
 Может возникать не более одного раза
Command.Id
 Может возникать не более одного раза
Command.Keytip
 Может возникать не более одного раза
Command.LabelDescription
 Может возникать не более одного раза
Command.LabelTitle
 Может возникать не более одного раза
Command.LargeHighContrastImages
 Может возникать не более одного раза
Command.LargeImages
 Может возникать не более одного раза
Command.Name
 Может возникать не более одного раза
Command.SmallHighContrastImages
 Может возникать не более одного раза
Command.SmallImages
 Может возникать не более одного раза
Command.Symbol
 Может возникать не более одного раза
Command.TooltipDescription
 Может возникать не более одного раза
Command.TooltipTitle
 Может возникать не более одного раза

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

Элемент
Application.Commands

Комментарии

Обязательный.

Может встречаться один или несколько раз для каждого элемента Application.Commands .

Дочерние элементы элемента Command могут находиться в любом порядке.

Как правило, ресурсы Command объявляются в разметке ленты, но их также можно задать во время выполнения с помощью вызова SetUICommandProperty. Например, можно задать свойство UI_PKEY_Keytip для command вместо объявления значения в разметке с помощью элемента Command.Keytip .

В случаях, когда свойства команд, такие как метки и изображения, нельзя задать с помощью SetUICommandProperty , их можно сделать недействительными с помощью вызова InvalidateUICommand. После аннулирования платформа запрашивает ведущее приложение сведения о ресурсе.

Примечание

Ресурс нельзя восстановить из таблицы ресурсов разметки после того, как он был признан недействительным.

Определение command добавляется в файл заголовка разметки ленты для каждой команды , объявленной в разметке.

Значение keytip выступает в качестве ускорителя клавиатуры для команды, если только эта команда не предоставляется через пункт меню. В этом случае платформа игнорирует значение подсказки ключей и вместо этого использует символ, перед которым стоит амперсанд, как указано в LabelTitle или UI_PKEY_Label. Если в LabelTitle или UI_PKEY_Label не указан амперсанд, подсказка клавиш или ускоритель клавиатуры не предоставляются.

Примеры

В следующем примере показан манифест элементов Command для вкладки Главная .

<Application.Commands>

<Command Name="cmdHomeTab"
         LabelTitle="Home"
         Keytip="H" />
<Command Name="cmdClipboardGroup"
         Symbol="IDR_CMD_CLIPBOARD"
         Id="10000"
         Comment="Command definition for clipboard group"
         LabelTitle="Clipboard"
         Keytip="CB" />
<Command Name="cmdCopy"
         Symbol="IDR_CMD_COPY"
         LabelTitle="Copy"
         LabelDescription="Copy"
         Keytip="C"
         TooltipTitle="Copy"
         TooltipDescription="Click to copy">
  <Command.SmallImages>
    <Image>res/copyS_16.bmp</Image>
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/copyL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdPaste"
         Symbol="IDR_CMD_PASTE" >
  <Command.LabelTitle>Paste</Command.LabelTitle>
  <Command.LabelDescription>
    <String Content="Paste contents of clipboard"
            Id="10001"
            Symbol="IDR_RES_LABELDESC_PASTE" />
  </Command.LabelDescription>
  <Command.Keytip>P</Command.Keytip>
  <Command.TooltipTitle>
    <String Content="Paste contents of clipboard"
            Id="10002"
            Symbol="IDR_RES_TOOLTIP_PASTE"/>
  </Command.TooltipTitle>
  <Command.TooltipDescription>
    <String Content="Click to paste contents of clipboard"/>
  </Command.TooltipDescription>
  <Command.SmallImages>
    <Image
      Id="10010"
      MinDPI="96"
      Symbol="IDR_RES_SMALL_IMAGE96">
      <Image.Source>res/pasteS_96bpp.bmp</Image.Source>
    </Image>
    <Image Source="res/pasteS_120bpp.bmp"
           Id="10011"
           MinDPI="120"
           Symbol="IDR_RES_SMALL_IMAGE120" />
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/pasteL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdMinimize"
         Symbol="IDR_CMD_MINIMIZE"
         Id="10001"
         LabelTitle="Minimize" />

</Application.Commands>

Сведения об элементе

  • Минимальная поддерживаемая система: Windows 7
  • Может быть пустым: Нет