Contrôles de ruban, exemple

Mise à jour : novembre 2007

Remarque :

Cet exemple s'exécute uniquement dans Microsoft Office Excel 2007.

Cet exemple explique comment créer un onglet personnalisé qui s'affiche sur le ruban d'une feuille de calcul Microsoft Office Excel. Ce ruban personnalisé montre la plupart des contrôles disponibles dans le groupe Contrôles de ruban Office de la Boîte à outils de Visual Studio. Pour plus d'informations sur l'utilisation de ces contrôles, consultez Concepteur de ruban.

Note de sécurité :

Cet exemple de code est destiné à illustrer un concept et affiche uniquement le code correspondant. Il peut ne pas répondre aux exigences de sécurité d'un environnement spécifique et ne doit pas être utilisé tel quel. Nous vous conseillons d'ajouter un code de gestion des erreurs et de sécurité afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT », sans garantie d'aucune sorte.

Pour plus d'informations sur l'installation de l'exemple de projet sur votre ordinateur, consultez Comment : installer et utiliser des fichiers d'exemple figurant dans l'aide.

Download sample

Pour exécuter cet exemple

  1. Appuyez sur F5.

  2. Une feuille de calcul Excel s'affiche. Le ruban de la feuille de calcul affiche un onglet personnalisé nommé Ribbon Control Sample.

    Le ruban n'affiche pas d'autres onglets car la propriété StartFromScratch du ruban personnalisé a la valeur true.

Configuration requise

Cet exemple requiert les applications suivantes :

  • Visual Studio Tools pour Office.

  • Microsoft Office Excel 2007.

Démonstrations

Cet exemple illustre les concepts suivants :

  • Personnalisation d'un onglet à l'aide d'un modèle d'élément Ruban (Concepteur visuel).

  • Masquage de tous les onglets intégrés et de la plupart des commandes du menu Office et affichage des personnalisations définies uniquement dans cet élément Ruban.

  • Ajout de groupes et de contrôles personnalisés au Concepteur de ruban.

  • Gestion des événements de contrôles sur le ruban.

  • Modification des propriétés de contrôles au moment de l'exécution.

  • Ajout dynamique de contrôles à un menu au moment de l'exécution.

  • Ajout dynamique d'éléments à une galerie au moment de l'exécution.

  • Affichage et masquage de contrôles du volet Actions à l'aide de boutons sur le ruban.

Groupe Working with Sheets

Le tableau suivant décrit les contrôles qui s'affichent dans le groupe Working with Sheets du ruban personnalisé.

Contrôle

Description

Action/Résultat

Afficher le volet des actions

Bouton bascule affiché comme étant activé ou non activé.

Cliquez sur Afficher le volet des actions.

Un volet Actions s'affiche en regard de la feuille de calcul.

Cliquez une deuxième fois sur Afficher le volet des actions pour masquer celui-ci.

Boutons de face

Trois boutons contenus dans un groupe de boutons. Ces boutons sont ajoutés au groupe car ils sont liés les uns aux autres. Les boutons d'un groupe de boutons ont une apparence brillante.

Cliquez sur un bouton de face.

La cellule A1 affiche l'image correspondante.

Alignement

Bouton partagé. Un bouton partagé est un bouton auquel est associé un menu. Le menu de bouton partagé Alignement contient trois boutons. La propriété OfficeImageId du bouton partagé Alignement a pour valeur l'ID d'un contrôle intégré d'alignement Office.

Cliquez sur Alignement à droite, Alignement à gauche ou Alignement au centre dans le menu de bouton partagé Alignement.

Le texte qui s'affiche dans la cellule A3 est aligné à droite, aligné à gauche ou centré.

Couleur

Galerie qui présente un tableau de sphères colorées parmi lesquelles vous pouvez faire votre choix.

Cliquez sur Couleur, puis sélectionnez une couleur de la galerie.

Une sphère de la couleur sélectionnée s'affiche dans la cellule A6.

Format de graphique

Contrôle déroulant qui contient une liste des formats de graphique. Contrairement à une zone de liste déroulante, un contrôle déroulant n'accepte pas la saisie de sélections.

Cliquez sur Format de graphique, puis sélectionnez un format dans la liste.

Le format du graphique qui s'affiche sur la feuille de calcul est adapté au format sélectionné.

MRU Find

Zone de liste déroulante. Vous pouvez entrer votre choix ou le sélectionner.

Cliquez sur la zone de liste déroulante MRU Find, puis sélectionnez le texte dans la liste.

- ou -

Entrez votre texte dans la zone de liste déroulante MRU Find, puis appuyez sur ENTRÉE.

Un message identifiant l'emplacement du texte sur la feuille de calcul s'affiche.

Groupe Building Dynamic Menu

Le tableau suivant décrit les contrôles qui s'affichent dans le groupe Building a Dynamic Menu du ruban personnalisé.

Contrôle

Description

Action/Résultat

Menu dynamique

Menu. Un menu est une liste déroulante qui peut contenir d'autres contrôles de ruban.

La propriété Dynamic de ce menu a la valeur true. Cela permet la mise à jour dynamique du menu au moment de l'exécution.

Cliquez sur Menu dynamique pour afficher un menu de contrôles.

Case à cocher, Liste déroulante, Sous-menu, Galerie, Bouton, Séparateur

Jeu de cases à cocher. Vous pouvez activer ou désactiver une case à cocher pour activer ou désactiver une option.

Chaque case à cocher représente un contrôle de ruban que vous pouvez ajouter à Menu dynamique.

Cliquez sur une case à cocher pour ajouter un contrôle de ruban à Dynamic Menu dynamique.

Voir aussi

Tâches

Procédure pas à pas : création d'un onglet personnalisé à l'aide du Concepteur de ruban

Procédure pas à pas : mise à niveau des contrôles sur un ruban au moment de l'exécution

Comment : démarrer avec la personnalisation du ruban

Concepts

Vue d'ensemble du ruban

Autres ressources

Exemples et procédures pas à pas relatifs au développement Office