Base modèle Ribbons

La base modèle Ribbons_Edit n'est pas un utilitaire au sens strict du mot mais permet de créer et modifier certains éléments de rubans. tout ce travail est réalisé par les formulaires.

Ce formulaire est utilisé par la fonction de rappel getImage pour charger les images pièces jointes, en mode caché et en lecture seule. Il sera également utilisé pour mettre à jour les images de la pièce jointe par ajout ou suppression.

Ce formulaire permet de vous faciliter le stockage des exemples de code XML et VBA pour vos contrôles les plus fréquemment utilisés.

Ce formulaire permet de visualiser les différents rubans stockés dans l'application.

Il peut modifier, créer, supprimer des rubans mais il ne contrôle pas la syntaxe du code XML. Il ne sera utilisé dans ce contexte que pour modifier des éléments mineurs.
Les rubans seront manipulés dans l'éditeur de rubans CustomUIEditor (Cliquer ici pour le télécharger), contrôlés et ensuite copiés/collés dans un enregistrement de ce formulaire ou directement dans la table USysRibbons.
Il permet également de lancer l'éditeur CustomUIEditor, d'ouvrir l'éditeur VBA et de dupliquer un ruban.

Création d'un ruban vierge. Vierge dans le sens que ce ruban ne peut rien encore exécuter mais il sera correct dans sa syntaxe. Par défaut, il va créer 2 groupes de 2 boutons. Vous pouvez modifier le nombre de groupes et de boutons à créer sur le formulaire. Le code XML obtenu sera copié/collé dans l'éditeur XML et modifié par le code réel. Ce ruban sera précieux dans le sens que vous ne pourrez pas oublier les lignes indispensables et qu'il est indenté correctement.
Vous pouvez choisir le caractère d'indentation qui est l'espace par défaut en le remplaçant par le caractère tabulation, en cochant ou décochant la case appropriée.

Création automatique du code XML d'un ruban "vierge"

<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui" onLoad="customUI_onLoad">
   <ribbon startFromScratch="false">
      <tabs>
         <tab idMso="TabHomeAccess" visible="true"/>
         <tab idMso="TabCreate" visible="true"/>
         <tab idMso="TabExternalData" visible="true"/>
         <tab idMso="TabDatabaseTools" visible="true"/>
         <tab id="tab_1" label="Onglet_1">
            <group id="grp_1" label="Groupe no 1">
               <button id="button_1"
                       imageMso = "RecordsRefreshRecords"
                       label="bouton no 1"
                       supertip = "Complément de description"
                       size = "large"
                       onAction = "button_onAction"
               />
               <button id="button_2"
                       imageMso = "RecordsRefreshRecords"
                       label="bouton no 2"
                       supertip = "Complément de description"
                       size = "large"
                       onAction = "button_onAction"
               />
            </group>
            <group id="grp_2" label="Groupe no 2">
               <button id="button_3"
                       imageMso = "RecordsRefreshRecords"
                       label="bouton no 3"
                       supertip = "Complément de description"
                       size = "large"
                       onAction = "button_onAction"
               />
               <button id="button_4"
                       imageMso = "RecordsRefreshRecords"
                       label="bouton no 4"
                       supertip = "Complément de description"
                       size = "large"
                       onAction = "button_onAction"
               />
            </group>
         </tab>
      </tabs>
   </ribbon>
</customUI>

Création du code XML d'un contrôle. Vous pourrez générer le code XML d'un contrôle grâce à ce formulaire qui vous indique tous les attributs utilisables pour le contrôle désiré.

Vous sélectionnez dans le ruban, le type de contrôle à préparer (bouton menu "préparer un contrôle") et tous les attributs sont affichés et cochés par défaut. Cochez la case sélect pour sélectionner les attributs que vous voulez voir apparaître dans votre code. Indiquez la valeur entre guillemets que vous voulez donner à vos attributs. N'indiquez pas de valeur pour les attributs avec fonctions de rappel, ce sera généré automatiquement.

Attribut imageMso: La valeur de cet attribut est l'identificateur du contrôle et de l'icône Mso correspondante. vous trouverez quatre comboBox dans le ruban vous permettant de sélectionner une icône.
Cliquez dans le champ valeur de l'attribut imageMso. Sélectionnez une icône dans une des quatre comboBox et cliquez. Le nom de l'icône s'affichera dans le champ imageMso.

Lorsque votre préparation est terminée, cliquez sur le bouton "générer XML du contrôle". le code généré sera affiché dans le champ texte du bas de formulaire. Faîtes un copier/coller ver l'éditeur XML.
Une case à cocher nommée saut de ligne vous permet de placer chaque attribut sur une ligne différente.
Un champ texte nommé retrait (valeur 15 par défaut) vous permet d'indiquer une indentation (retrait) à vos lignes de code.

Code XML généré automatiquement pour un bouton avec saut de ligne

<button  id = "button_001"
         imageMso = "RecordsRefreshRecords"
         label = "Bouton no 1"
         supertip = "Complément de description"
         size = "large"
         onAction = "button_onAction"
        />

Code XML généré automatiquement pour un bouton sans saut de ligne

<button  id = "button_001" imageMso = "RecordsRefreshRecords" label = "Bouton no 1"
         supertip = "Complément de description" size = "large" onAction = "button_onAction"
        />

Ce formulaire permet de créer un onglet complet de groupes et de boutons et seulement de boutons dans sa version actuelle.

Vous devez créer un onglet, décrire des groupes dans cet onglet et éventuellement des boutons dans les groupes. Les groupes et boutons pourront être créés en globalité et ensuite paramétrés ou au fur et à mesure de l'avancement du ruban.
Les tables USysBoutons, USysGroupes et USysOnglets sont obligatoires pour l'utilisation de ce formulaire.

Un onglet exemple présent dans les tables permet de réaliser des essais de rubans.

Lors de la génération du ruban, le code XML apparaît dans le formulaire ainsi que le code VBA des fonctions de rappel pour les événements Action des boutons personnels. Ces fonctions de rappel seront complétées manuellement par le code particulier nécessaire à chaque contrôle.