Command-Element

  • Artikel

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