Concepteur de ruban (MFC)

Article
10/12/2023

Le Concepteur de ruban permet de créer et de personnaliser des rubans dans les applications MFC. Un ruban est un élément d'interface utilisateur (IU) qui organise les commandes en groupes logiques. Ces groupes apparaissent sous des onglets distincts dans une bande transversale située dans la partie supérieure de la fenêtre. Le ruban remplace la barre de menus et les barres d'outils. Un ruban peut considérablement améliorer la convivialité d'une l'application. Pour plus d’informations, consultez Rubans. L'illustration suivante représente un ruban.

MFC Ribbon Resource Control.

Dans les versions antérieures de Visual Studio, les rubans devaient être créés en écrivant du code qui utilise les classes de ruban MFC telles que CMFCRibbonBar, classe. Dans Visual Studio 2010 et versions ultérieures, le concepteur de ruban fournit une autre méthode pour créer des rubans. Dans un premier temps, il convient de créer et de personnaliser un ruban en tant que ressource. Chargez ensuite la ressource de ruban à partir du code de l'application MFC. Vous pouvez même utiliser les ressources de ruban et les classes de ruban MFC conjointement. Par exemple, vous pouvez créer une ressource de ruban, puis ajouter par programme d’autres éléments à celui-ci au moment de l’exécution à l’aide du code.

Présentation du Concepteur de ruban

Le Concepteur de ruban crée et stocke le ruban en tant que ressource. Quand vous créez une ressource de ruban, le Concepteur de ruban effectue trois opérations :

Il ajoute une entrée dans le script de définition de ressources du projet (* .rc). Dans l’exemple suivant, IDR_RIBBON est le nom unique qui identifie la ressource du ruban, RT_RIBBON_XML est le type de ressource, et ribbon.mfcribbon-ms est le nom du fichier de ressources.

    IDR_RIBBON RT_RIBBON_XML      "res\\ribbon.mfcribbon-ms"

Ajoute les définitions des ID de commande à resource.h.

#define IDR_RIBBON            307

Crée un fichier de ressources de ruban (*.mfcribbon-ms) qui contient le code XML définissant les boutons, les contrôles et les attributs du ruban. Les modifications apportées au ruban dans le Concepteur de ruban sont stockées dans le fichier de ressources au format XML. L’exemple de code suivant montre une partie du contenu d’un fichier *.mfcribbon-ms :

<RIBBON_BAR>
<ELEMENT_NAME>RibbonBar</ELEMENT_NAME>
<IMAGE>
<ID>
<NAME>IDB_BUTTONS</NAME>
<VALUE>113</VALUE>
</ID>

Pour utiliser la ressource du ruban dans votre application MFC, chargez la ressource en appelant CMFCRibbonBar ::LoadFromResource.

Création d'un ruban à l'aide du Concepteur de ruban

Il existe deux façons d'ajouter une ressource de ruban à votre projet MFC :

Créez une application MFC et configurez l'Assistant de projet MFC pour créer le ruban. Pour plus d’informations, consultez Procédure pas à pas : création d’une application de ruban à l’aide de MFC.
Dans un projet MFC existant, créez une ressource de ruban et chargez-la. Pour plus d’informations, consultez Procédure pas à pas : mise à jour de l’application scribble MFC (partie 1).

Si votre projet contient déjà un ruban codé manuellement, vous pouvez utiliser les fonctions de MFC pour convertir le ruban existant en ressource de ruban. Pour plus d’informations, consultez Guide pratique pour convertir un ruban MFC existant en ressource de ruban.

Remarque

Il n'est pas possible de créer des rubans dans des applications à base de boîtes de dialogue. Pour plus d’informations, consultez l’Assistant Application MFC, type d’application MFC.

Personnalisation des rubans

Pour ouvrir un ruban dans le Concepteur de ruban, double-cliquez sur la ressource de ruban dans l'Affichage des ressources. Dans le concepteur, vous pouvez ajouter, supprimer et personnaliser les éléments du ruban, le bouton d'application ou la barre d'outils Accès rapide. Vous pouvez aussi lier des événements, par exemple, des événements de clic de bouton et des événements de menu, à une méthode dans votre application.

L'illustration suivante représente les différents composants du Concepteur de ruban.

MFC Ribbon Designer.

Boîte à outils : contient des contrôles qui peuvent être déplacés vers l’aire du concepteur.
Surface du concepteur : contient la représentation visuelle de la ressource du ruban.
Assistant Classe : répertorie les attributs de l’élément sélectionné sur l’aire du concepteur.
Fenêtre Vue des ressources : affiche les ressources qui incluent les ressources du ruban, dans votre projet.
Barre d’outils éditeur de ruban : contient des commandes qui vous permettent d’afficher un aperçu du ruban et de modifier son thème visuel.

Les rubriques suivantes expliquent comment utiliser les fonctionnalités du Concepteur de ruban :

Définition des éléments de ruban

MFC Ribbon.

Bouton Application : bouton qui s’affiche dans le coin supérieur gauche d’un ruban. Le bouton d'application remplace le menu Fichier et est visible même quand le ruban est réduit. Quand vous cliquez sur ce bouton, vous obtenez un menu qui contient une liste de commandes.
Barre d’outils Accès rapide : petite barre d’outils personnalisable qui affiche les commandes fréquemment utilisées.
Catégorie : regroupement logique qui représente le contenu d’un onglet du ruban.
Bouton Par défaut de catégorie : bouton qui apparaît sur le ruban lorsque le ruban est réduit. Quand vous cliquez sur ce bouton, la catégorie réapparaît sous forme de menu.
Panneau : zone de la barre de ruban qui affiche un groupe de contrôles associés. Chaque catégorie du ruban contient un ou plusieurs volets de ruban.
Éléments du ruban : contrôles dans les panneaux, par exemple, boutons et zones de liste modifiable. Pour afficher les différents contrôles qui peuvent être hébergés sur un ruban, consultez l’exemple RibbonGadgets : Application Gadgets du ruban.

Voir aussi

Éléments de l’interface utilisateur
Utilisation des fichiers de ressources

Share via