Kompilieren des Menübandmarkups
Damit das Windows-Menübandframework die Menübandmarkupdatei nutzen kann, muss die Markupdatei in eine Ressourcendatei im Binärformat kompiliert werden. Ein dedizierter Markupcompiler, der UI Command Compiler (UICC), ist zu diesem Zweck im Windows Software Development Kit (SDK) (7.0 oder höher) enthalten. Zusätzlich zur Kompilierung der binärversion des Markups generiert die UICC eine ID-Definitionsheaderdatei (.h), die alle Markupelemente für die Menübandhostanwendung verfügbar macht, und eine Ressourcendatei (.rc), die verwendet wird, um Bild- und Zeichenfolgenressourcen zur Buildzeit mit der Hostanwendung zu verknüpfen.
Compilerworkflow
Der Workflow des Menüband-Markupcompilers wird im folgenden Diagramm veranschaulicht.
Befehlszeilensyntax
Die Befehlszeilensyntax für den Menüband-Markupcompiler wird im folgenden Beispiel gezeigt.
UICC <ribbonFile> <binaryFile> [options]
Argumente und Optionen
Die Argumente und Optionen für dieses Tool werden in der folgenden Tabelle beschrieben.
Hinweis
Die aufgeführten Befehlszeilenoptionen müssen in der angegebenen Reihenfolge angegeben werden.
| Option | BESCHREIBUNG | ||||||
|---|---|---|---|---|---|---|---|
| /header:<headerFile> | Generieren Sie eine Headerdatei namens <headerFile> , die die Markupbefehls-ID-Ressourcensymbole enthält. Wenn sie nicht angegeben wird, wird keine Headerdatei generiert. | ||||||
| /res:<resourceFile> | Generieren Sie eine Ressourcendatei namens <resourceFile> , die alle Image- und Zeichenfolgenressourcen, die binäre Markupdatei und die Headerdatei zur Buildzeit mit der Hostanwendung verknüpft. Wenn nicht angegeben, wird keine Ressourcendatei generiert. | ||||||
| /name:<ribbonName> | Der Ressourcenname für die binäre Markupdatei, die in resourceFile <>protokolliert wird. Der Standardwert ist APPLICATION_RIBBON. | ||||||
| /W{0\1\2} | Filtern Sie die Ereignismeldungen basierend auf dem Schweregrad.
|
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie Sie den Menüband-Markupcompiler verwenden, um einen typischen Satz von Ressourcendateien für eine Menübandanwendung zu generieren.
UICC.exe RibbonMarkup.xml RibbonMarkup.bml /header:RibbonIds.h /res:RibbonUI.rc