Freigeben über


Command-Element

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