Ajouter une action au menu de fichier

Pour ajouter une action au menu de fichier, copier un des nœuds de boutons existants dans la section précédente et l’ajouter où cela est désiré. Par exemple, copier le nœud de bouton pour iManage.BSWorkSiteSaveAsVersion et l’ajouter à la fin de la liste (mais avant le séparateur final). La section qui en résulte est la suivante :

<backstage onHide="OnBackStageHide" onShow="OnBackStageShow"> <button id="iManage.BSSep1" label="___________________" enabled="false" insertBeforeMso="FileSave"/> <button id="iManage.BSWorkSiteOpen" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="openWS32" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="K"/> <button id="iManage.BSWorkSiteSave" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="WSSaveAs32" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="B"/> <button id="iManage.BSWorkSiteSaveAsVersion" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="SaveAs_New_Version" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/> <button id="iManage.BSWorkSiteSaveAsVersion" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="SaveAs_New_Version" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/> <button id="iManage.BSSep2" label="___________________" enabled="false" insertBeforeMso="FileSave" />

NOTE :

Le nœud suivant a été ajouté au texte ci-dessus :

<button id="iManage.BSWorkSiteSaveAsVersion" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="SaveAs_New_Version" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/>

Pour identifier la nouvelle action devant être affichée sur le menu Fichier, changer l’id du bouton du nouveau nœud. Le fichier XML par défaut contient toutes les actions possible qui peuvent être ajoutées au menu Fichier. Pour ajouter l’action Enregistrer et Synchroniser dans le menu Fichier, par exemple, rechercher dans le fichier XML et identifier le nom de l’action pour Enregistrer & Synchroniser. Cette action apparaît sur le ruban iManage par défaut dans Microsoft Word, et apparaît dans le fichier comme :

<button idQ="im:iManage.WorkSiteSavenSync" getLabel="GetWControlLabel" getSupertip="GetWControlSupertip" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" onAction="OnWorkSiteAction" image="Save_and_Sync" size ="large" keytip="SS" />

Depuis la section précédent, copier la propriété idQ du bouton qui est im:iManage.WorkSiteSavenSync et en faire l’id du nœud de bouton que vous avez ajouté dans la section de menu Fichier. Le nœud résultant dans la liste de bouton pour ajouter au menu Fichier revêt l’aspect suivant :

<button id="im:iManage.WorkSiteSavenSync" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="Save_and_Sync" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/>

NOTE :

La propriété suivante a été modifiée dans le texte ci-dessus :

"im:iManage.WorkSiteSavenSync"

Deux autres changements doivent être effectués sur la valeur id :

  1. Supprimer le préfixe im:.

  2. Ajouter un numéro à la fin de la valeur id pour en faire une valeur id unique dans le fichier XML. Dans ce cas, ajouter un 2 à la fin pour arriver à :

<button id="iManage.WorkSiteSavenSync2" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="Save_and_Sync" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/>

NOTE :

La propriété d’id suivante a été modifiée dans le texte ci-dessus :

"iManage.WorkSiteSavenSync2"

La raison pour ajouter un 2 à la fin de l’id du bouton est que les ids de bouton dans le fichier XML peuvent être répétées, dans le cas contraire quand Microsoft Office tente d’analyser les contenus des fichiers, l’analyse échouera.

La section de menu Fichier finale du fichier CML revêt l’aspect suivant :

<backstage onHide="OnBackStageHide" onShow="OnBackStageShow"> <button id="iManage.BSSep1" label="___________________" enabled="false" insertBeforeMso="FileSave"/> <button id="iManage.BSWorkSiteOpen" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="openWS32" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="K"/> <button id="iManage.BSWorkSiteSave" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="WSSaveAs32" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="B"/> <button id="iManage.BSWorkSiteSaveAsVersion" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="SaveAs_New_Version" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/> <button id="iManage.WorkSiteSavenSync2" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="Save_and_Sync" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/> <button id="iManage.BSSep2" label="___________________" enabled="false" insertBeforeMso="FileSave" />

NOTE :

Le nœud suivant a été ajouté au texte ci-dessus :

<button id="iManage.WorkSiteSavenSync2" insertBeforeMso="FileSave" getLabel ="GetWControlLabel" image="Save_and_Sync" getEnabled ="GetWControlEnabled" getVisible ="GetWControlVisible" isDefinitive="true" onAction="OnWorkSiteAction" keytip="S2"/>