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. Maximale Länge: 250 Zeichen. |
| Id |
xs:positiveInteger union xs:string |
No |
Die eindeutige Ressourcen-ID. 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. |
| LabelDescription |
xs:string |
No |
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt. |
| LabelTitle |
xs:string |
No |
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt. |
| Name |
xs:string |
No |
Maximale Länge: 100 Zeichen. |
| Symbol |
xs:string |
No |
Maximale Länge: 100 Zeichen. |
| QuickInfoDescription |
xs:string |
No |
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt. |
| QuickInfoTitle |
xs:string |
No |
Eine Zeichenfolge, die den in einem Befehlselement angezeigten Text darstellt. |
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