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


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
  • Может быть пустым: Нет