Command-Element

Artikel
06/13/2023

Stellt eine Befehlsdefinition dar.

Verbrauch

<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

attribute	type	Erforderlich	BESCHREIBUNG
Comment	xs:string	Nein	Wird zum Kommentieren des Befehlselements verwendet. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen. Maximale Länge: 250 Zeichen.
Id	xs:positiveInteger union xs:string	Nein	Die eindeutige Ressourcen-ID. (Die Vereinigung von xs:positiveInteger und xs:string) Ein ganzzahliger Wert zwischen 2 und 59999, inklusive oder 0x2 und 0xea5f hexadezimal, inklusive. Die maximale Länge beträgt 10 Zeichen, einschließlich optionaler führende Nullen.
Keytip	xs:string	Nein	Eine Zeichenfolge, die die Tastenkombination eines Befehlselements darstellt. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen.
LabelDescription	xs:string	Nein	Eine Zeichenfolge, die den Text darstellt, der in einem Befehlselement angezeigt wird. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
LabelTitle	xs:string	Nein	Eine Zeichenfolge, die den Text darstellt, der in einem Befehlselement angezeigt wird. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
Name	xs:string	Nein	(xs:string) Eine Zeichenfolge, die aus einem Buchstaben oder Unterstrich besteht, gefolgt von einer beliebigen Sequenz von Ziffern, Buchstaben oder Unterstrichen. Maximale Länge: 100 Zeichen.
Symbol	xs:string	Nein	(xs:string) Eine Zeichenfolge, die aus einem Buchstaben oder Unterstrich besteht, gefolgt von einer beliebigen Sequenz von Ziffern, Buchstaben oder Unterstrichen. Maximale Länge: 100 Zeichen.
QuickInfoDescription	xs:string	Nein	Eine Zeichenfolge, die den Text darstellt, der in einem Befehlselement angezeigt wird. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
QuickInfoTitle	xs:string	Nein	Eine Zeichenfolge, die den Text darstellt, der in einem Befehlselement angezeigt wird. (xs:string) Eine Zeichenfolge, die aus einer beliebigen Sequenz von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.

Untergeordnete Elemente

Element	BESCHREIBUNG
Command.Comment	Kann höchstens einmal auftreten
Command.Id	Kann höchstens einmal auftreten
Command.Keytip	Kann höchstens einmal auftreten
Command.LabelDescription	Kann höchstens einmal auftreten
Command.LabelTitle	Kann höchstens einmal auftreten
Command.LargeHighContrastImages	Kann höchstens einmal auftreten
Command.LargeImages	Kann höchstens einmal auftreten
Command.Name	Kann höchstens einmal auftreten
Command.SmallHighContrastImages	Kann höchstens einmal auftreten
Command.SmallImages	Kann höchstens einmal auftreten
Command.Symbol	Kann höchstens einmal auftreten
Command.TooltipDescription	Kann höchstens einmal auftreten
Command.TooltipTitle	Kann höchstens einmal auftreten

Übergeordnete Elemente

Element
Application.Commands

Bemerkungen

Erforderlich.

Kann für jedes Application.Commands-Element ein oder mehrere Male auftreten.

Die untergeordneten Elemente des Command-Elements können in beliebiger Reihenfolge auftreten.

In der Regel werden Befehlsressourcen im Menübandmarkup deklariert, können aber auch zur Laufzeit mit einem Aufruf von SetUICommandProperty festgelegt werden. Beispielsweise ist es möglich, die UI_PKEY_Keytip-Eigenschaft für einen Command festzulegen, anstatt einen Wert im Markup mit dem Command.Keytip-Element zu deklarieren.

In Fällen, in denen Command-Eigenschaften wie Bezeichnungen und Bilder nicht mit SetUICommandProperty festgelegt werden können, können sie durch einen Aufruf von InvalidateUICommand ungültig gemacht werden. Nach der Ungültigheit fragt das Framework die Hostanwendung nach den Ressourcendetails ab.

Hinweis

Eine Ressource kann nicht aus der Markupressourcentabelle wiederhergestellt werden, nachdem sie ungültig wurde.

Für jeden Befehl , der im Markup deklariert wird, wird der Menüband-Markupheaderdatei eine Befehlsdefinition hinzugefügt.

Der Wert von Keytip fungiert als Tastaturbeschleunigung für einen Befehl, es sei denn, dieser Befehl wird über ein Menüelement verfügbar gemacht. In diesem Fall ignoriert das Framework den Keytip-Wert und verwendet stattdessen ein Zeichen, dem ein Ampersand vorangestellt ist, wie durch LabelTitle oder UI_PKEY_Label angegeben. Wenn kein Ampersand durch LabelTitle oder UI_PKEY_Label angegeben wird, wird keine Tasteninfo oder Tastaturbeschleunigung verfügbar gemacht.

Beispiele

Das folgende Beispiel zeigt ein Manifest von Befehlselementen für eine Registerkarte Start .

<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>

Elementinformationen

Unterstützte Mindestsystem: Windows 7
Kann leer sein: Nein

Freigeben über