Créer des compléments pour personnaliser le mode Backstage d’Office 2010

Article
09/24/2014

Bannière Office Quick Note

Prise en main de la personnalisation de l’interface utilisateur Office 2010 Fluent : Créer des onglets personnalisés sur l’interface utilisateur Mode Microsoft Office Backstage.

Dernière modification : vendredi 22 avril 2011

S’applique à : Excel 2010 | Office 2010 | PowerPoint 2010 | Word 2010

Dans cet article
Créer le projet de complément COM
Ajouter du code pour les fonctionnalités des contrôles
Ajouter du code XML au projet pour créer l’onglet et les contrôles
Installer le complément et tester la solution
Étapes suivantes

Dans cet exercice, vous créez un complément COM qui ajoute un onglet personnalisé, « group », et d’autres contrôles à l’interface utilisateur Mode Microsoft Office Backstage. Pour réaliser cette tâche, vous devez effectuer ce qui suit :

Créer le projet de complément COM
Ajouter du code pour les fonctionnalités des contrôles
Ajouter du code XML au projet pour créer l’onglet et les contrôles
Installer le complément et tester la solution

Créer le projet de complément COM

Dans cette tâche, vous créez le projet de complément COM partagé dans Microsoft Visual Studio 2010.

Pour créer le projet de complément

Démarrez Visual Studio 2010, cliquez sur Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans la section Modèles installés, cliquez sur Autres types de projets, cliquez sur Extensibilité, puis cliquez sur Complément partagé.
Dans la zone Nom, tapez BackstageCOMAddin, puis cliquez sur OK.
Dans l’Assistant Complément partagé, cliquez sur Suivant, cliquez sur Créer un complément à l’aide de Visual Basic, puis cliquez sur Suivant.
Dans l’écran Sélectionner une application hôte, désactivez toutes les cases à cocher sauf Microsoft Word puis cliquez sur Suivant.
Dans l’écran Quel est le nom de votre complément ?, tapez BackstageAddin, puis cliquez sur Suivant.
Dans l’écran Choisir les options du complément, sélectionnez Je souhaite que mon complément soit chargé en même temps que l’application hôte, cliquez sur Suivant puis cliquez sur Terminer.
Dans cette étape, vous ajoutez des références d’assembly au projet. Dans l’Explorateur de solutions, développez la section Références, puis supprimez le nœud Microsoft.Office.Core.
Ensuite, cliquez avec le bouton droit sur BackstageCOMAddin puis cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence, cliquez sur l’onglet .NET, cliquez sur Microsoft.Office.Interop.Word, puis cliquez sur OK.
Cliquez avec le bouton droit sur BackstageCOMAddin puis cliquez sur Ajouter une référence.
Cliquez sur l’onglet COM, cliquez sur Bibliothèque d’objets Microsoft Office 14, puis cliquez sur OK.

Ajouter du code pour les fonctionnalités des contrôles

Dans cette tâche, vous ajoutez du code Visual Basic au projet pour donner des fonctionnalités au bouton que vous ajoutez à la tâche suivante.

Pour ajouter du code Visual Basic au projet

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Connect.vb, puis cliquez sur Afficher le code.

En haut de l’écran, ajoutez les instructions suivantes.

Imports Office = Microsoft.Office.Core
Imports Word = Microsoft.Office.Interop.Word

Dans la classe Connect, remplacez l’instruction Implements par ceci :

Implements Extensibility.IDTExtensibility2, Office.IRibbonExtensibility

Après l’instruction Implements, remplacez la déclaration applicationObject par la déclaration suivante :
```
Private applicationObject As Word.Application
```
Ensuite, vous ajoutez le fichier XML qui contiendra le code XML que vous ajoutez dans la tâche suivante. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur BackstageCOMAddin, pointez sur Ajouter puis sur Nouvel élément.
Dans Modèles installés, cliquez sur Éléments communs, cliquez sur Fichier XML, nommez le fichier customUI.xml puis cliquez sur Ajouter.
Ajoutez le fichier XML en tant que ressource au projet. Cliquez avec le bouton droit sur BackstageCOMAddin puis cliquez sur Propriétés.
Cliquez sur l’onglet Ressources puis faites glisser le fichier customUI.xml sur l’onglet. Fermez l’écran des propriétés.

Cliquez sur Connect.vb et, dans le bas de l’écran, ajoutez le code suivant.

Public Function GetCustomUI(ByVal RibbonID As String) As String Implements Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI
   Return BackStageCOMAddin.My.Resources.customUI14
End Function

Sub OnAction(ByVal control As Office.IRibbonControl)
   MessageBox.Show("Today's date is " & Date.Now.ToShortDateString())
End Sub

La méthode GetCustomUI retourne le code XML du Mode Backstage à Microsoft Office lorsque Word 2010 démarre. La méthode OnAction est appelée lorsque vous cliquez sur le bouton que vous ajoutez à l’étape suivante.

Ajouter du code XML au projet pour créer l’onglet et les contrôles

Dans cette tâche, vous ajoutez du code XML au projet, qui ajoute l’onglet et les contrôles au Mode Backstage.

Pour ajouter du code XML au projet

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur customUI.xml puis cliquez sur Afficher le code.

Dans l’écran du code, ajoutez le code suivant.

<customUI xmlns="https://schemas.microsoft.com/office/2009/07/customui">
  <backstage>
    <tab id="customTab" label="Sample">
      <firstColumn>
        <group id="customGroup" label="Custom Group">
          <primaryItem>
            <button id="btnButton" label="Today's Date" imageMso="CalendarInsert" onAction="OnAction"/>
          </primaryItem>
          <topItems>
            <layoutContainer id="layoutTwo" layoutChildren="horizontal">
              <comboBox id="cboComboBox" label="Select an item" >
                <item id="item1" label="one"/>
                <item id="item2" label="two"/>
                <item id="item3" label="three"/>
              </comboBox>
              <editBox id="eboxPopulate" label="Text goes here" />
            </layoutContainer>
          </topItems>
        </group>
      </firstColumn>
    </tab>
  </backstage>
</customUI>

Ce code ajoute un onglet, un bouton, une zone de liste déroulante et une zone de texte au Mode Backstage. L’onglet est ajouté dans le bas du volet de l’interface utilisateur. Le bouton utilise une image intégrée, comme indiqué par l’attribut imageMso. Lorsque l’utilisateur clique sur le bouton, celui-ci exécute la procédure de rappel OnAction. Le code utilise aussi un élément layoutContainer pour spécifier que la zone de texte déroulante et la zone de texte doivent être alignées horizontalement.

Installer le complément et tester la solution

Dans cette tâche, vous testez la solution en installant le complément et en testant ses fonctionnalités.

Pour tester le complément

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur BackstageCOMAddin puis cliquez sur Générer.
Lorsque la génération s’est terminée correctement, cliquez avec le bouton droit sur BackstageCOMAddinSetup puis cliquez sur Générer.
Lorsque la génération s’est terminée correctement, cliquez avec le bouton droit sur BackstageCOMAddinSetup puis cliquez sur Installer.
Lorsque l’Assistant Installation de BackstageCOMAddinSetup démarre, suivez les instructions pour installer le complément.
Démarrez Word 2010 puis cliquez sur l’onglet Fichier.
Cliquez sur l’onglet Exemple puis sur Date du jour. Une boîte de dialogue avec la date du jour s’affiche, similaire à celle montrée dans la figure 1.

Figure 1. La date du jour est affichée