Compilation du balisage du ruban

Pour que l’infrastructure du ruban Windows utilise le fichier de balisage du ruban , le fichier de balisage doit être compilé dans un fichier de ressources au format binaire. Un compilateur de balisage dédié, le compilateur de commandes d’interface utilisateur (UICC), est inclus dans le Kit de développement logiciel (SDK) Windows (7.0 ou version ultérieure) à cet effet. En plus de compiler la version binaire du balisage, l’UICC génère un fichier d’en-tête de définition d’ID (.h) qui expose tous les éléments de balisage à l’application hôte du ruban et un fichier de ressource (.rc) utilisé pour lier des ressources d’image et de chaîne à l’application hôte au moment de la génération.

Flux de travail du compilateur

Le flux de travail du compilateur de balisage du ruban est illustré dans le diagramme suivant.

diagramme montrant le flux de travail du compilateur de balisage de ruban.

Syntaxe de ligne de commande

La syntaxe de ligne de commande du compilateur de balisage du ruban est illustrée dans l’exemple suivant.

UICC <ribbonFile> <binaryFile> [options]

Arguments et options

Les arguments et les options de cet outil sont décrits dans le tableau suivant.

Notes

Les options de ligne de commande répertoriées doivent être spécifiées dans l’ordre donné.

Option Description
/header:<headerFile> Générez un fichier d’en-tête appelé <headerFile> qui contient les symboles de ressource ID de commande de balisage. En cas d’omission, aucun fichier d’en-tête n’est généré.
/res:<resourceFile> Générez un fichier de ressources appelé <resourceFile> qui lie toutes les ressources d’image et de chaîne, le fichier de balisage binaire et le fichier d’en-tête à l’application hôte au moment de la génération. En cas d’omission, aucun fichier de ressources n’est généré.
/name:<ribbonName> Nom de la ressource pour le fichier de balisage binaire enregistré dans le <resourceFile>. La valeur par défaut est APPLICATION_RIBBON.
/W{0\1\2} Filtrez les messages d’événement en fonction de la gravité.
0
Messages d'erreur uniquement.
1
Messages d’erreur et d’avertissement uniquement.
2
Par défaut.
Messages d’erreur, d’avertissement et d’information.

Exemple

L’exemple suivant montre comment utiliser le compilateur de balisage du ruban pour générer un ensemble classique de fichiers de ressources pour une application ruban.

UICC.exe RibbonMarkup.xml RibbonMarkup.bml /header:RibbonIds.h /res:RibbonUI.rc

Déclaration de commandes et de contrôles avec le balisage du ruban

Création d’une application ruban