Command, элемент

Статья
06/13/2023

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

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

<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

Как правило, ресурсы 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
Может быть пустым: Нет

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