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
No
Wird verwendet, um das Befehlselement mit Anmerkungen zu kommentieren.

(xs:string)
Eine Zeichenfolge, die aus einer beliebigen Folge von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
Maximale Länge: 250 Zeichen.
Id
xs:positiveInteger union xs:string
No
Die eindeutige Ressourcen-ID.

(Die Vereinigung von xs:positiveInteger und xs:string)
Ein ganzzahliger Wert zwischen 2 und 59999, einschließlich oder 0x2 und 0xea5f hexadezimal, einschließlich.
Die maximale Länge beträgt 10 Zeichen, einschließlich optionaler führender Nullen.
Keytip
xs:string
No
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
No
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt.

(xs:string)
Eine Zeichenfolge, die aus einer beliebigen Folge von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
LabelTitle
xs:string
No
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt.

(xs:string)
Eine Zeichenfolge, die aus einer beliebigen Folge von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
Name
xs:string
No
(xs:string)
Eine Zeichenfolge, die aus einem Buchstaben oder Unterstrich gefolgt von einer beliebigen Sequenz von Ziffern, Buchstaben oder Unterstrichen besteht.
Maximale Länge: 100 Zeichen.
Symbol
xs:string
No
(xs:string)
Eine Zeichenfolge, die aus einem Buchstaben oder Unterstrich gefolgt von einer beliebigen Sequenz von Ziffern, Buchstaben oder Unterstrichen besteht.
Maximale Länge: 100 Zeichen.
QuickInfoDescription
xs:string
No
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt.

(xs:string)
Eine Zeichenfolge, die aus einer beliebigen Folge von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.
QuickInfoTitle
xs:string
No
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt.

(xs:string)
Eine Zeichenfolge, die aus einer beliebigen Folge von Zeichen besteht, einschließlich Leerzeichen und Zeilenumbruchzeichen.

Untergeordnete Elemente

Element Beschreibung
Command.Comment
Kann nur einmal auftreten.

Command.Id
Kann nur einmal auftreten.

Command.Keytip
Kann nur einmal auftreten.

Command.LabelDescription
Kann nur einmal auftreten.

Command.LabelTitle
Kann nur einmal auftreten.

Command.LargeHighContrastImages
Kann nur einmal auftreten.

Command.LargeImages
Kann nur einmal auftreten.

Command.Name
Kann nur einmal auftreten.

Command.SmallHighContrastImages
Kann nur einmal auftreten.

Command.SmallImages
Kann nur einmal auftreten.

Command.Symbol
Kann nur einmal auftreten.

Command.TooltipDescription
Kann nur einmal auftreten.

Command.TooltipTitle
Kann nur einmal auftreten.

Übergeordnete Elemente

Element
Application.Commands

Hinweise

Erforderlich.

Kann ein oder mehrere Male für jedes Application.Commands-Element 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 kann die _ PKEY _ Keytip-Eigenschaft der Benutzeroberfläche für einen Befehl festgelegt werden, anstatt einen Wert im Markup mit dem Command.Keytip-Element zu deklarieren.

In Fällen, in denen Befehlseigenschaften wie Bezeichnungen und Bilder nicht mit SetUICommandProperty festgelegt werden können, können sie mit einem Aufruf von InvalidateUICommand fürungültig erklärt werden. Nach der Ungültigkeit fragt das Framework die Hostanwendung nach den Ressourcendetails ab.

Hinweis

Eine Ressource kann nicht erneut aus der Markupressourcentabelle restatiert werden, nachdem sie für ungültig erklärt wurde.

Eine Befehlsdefinition wird der Menüband-Markupheaderdatei für jeden Befehl hinzugefügt, der im Markup deklariert ist.

Der Wert von Keytip fungiert als Zugriffstaste 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 vorangegangen ist, wie durch LabelTitle oder UI _ PKEY _ Label angegeben. Wenn kein ampersand durch LabelTitle oder UI PKEY Label angegeben wird, wird keine Tastenkombination oder _ _ Tastenkombination verfügbar gemacht.

Beispiele

Das folgende Beispiel zeigt ein Manifest von Command-Elementen 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ütztes Mindestsystem: Windows 7
  • Kann leer sein: Nein