Office.Actions interface
Gère les actions et les raccourcis clavier.
Propriétés
associate | Associe l’ID ou le nom d’une action à une fonction. |
Méthodes
are |
Vérifie si un ensemble de combinaisons de raccourcis est actuellement utilisé pour l’utilisateur, tel que défini par un autre complément ou par l’application Office. |
get |
Obtient les raccourcis existants pour le complément. L’ensemble inclut toujours (1) les raccourcis définis dans le manifeste étendu du complément pour les raccourcis clavier et (2) les raccourcis personnalisés de l’utilisateur actuel s’ils existent. Le raccourci peut être |
replace |
Remplace les raccourcis de complément existants par des raccourcis personnalisés pour l’utilisateur. |
Détails de la propriété
associate
Associe l’ID ou le nom d’une action à une fonction.
associate: (actionId: string, actionFunction: (arg?: any) => void) => void;
Valeur de propriété
(actionId: string, actionFunction: (arg?: any) => void) => void
Détails de la méthode
areShortcutsInUse(shortcuts)
Vérifie si un ensemble de combinaisons de raccourcis est actuellement utilisé pour l’utilisateur, tel que défini par un autre complément ou par l’application Office.
areShortcutsInUse(shortcuts: string[]): Promise<Array<{shortcut: string, inUse: boolean}>>;
Paramètres
- shortcuts
-
string[]
Tableau de combinaisons de raccourcis. Par exemple, ["Ctrl+1", "Ctrl+2"]
.
Retours
Promise<Array<{shortcut: string, inUse: boolean}>>
Promesse qui se résout en tableau d’objets. Chaque objet se compose d’une combinaison de raccourcis et d’une valeur booléenne. La valeur est si la combinaison de raccourcis est true
en conflit avec un raccourci d’un autre complément ou avec un raccourci de l’application Office ; sinon, false
. Par exemple, [{shortcut:"Ctrl+1", inUse:true},{shortcut:"Ctrl+2", inUse:false}]
.
Remarques
Ensembles de conditions requises :
getShortcuts()
Obtient les raccourcis existants pour le complément. L’ensemble inclut toujours (1) les raccourcis définis dans le manifeste étendu du complément pour les raccourcis clavier et (2) les raccourcis personnalisés de l’utilisateur actuel s’ils existent. Le raccourci peut être null
s’il est en conflit avec le raccourci d’un autre complément ou avec l’application Office. Plus précisément, ce serait null
si, quand il est invité à choisir le raccourci à utiliser, l’utilisateur n’a pas choisi l’action du complément actuel. Pour plus d’informations sur les conflits avec les raccourcis, consultez Éviter les combinaisons de touches utilisées par d’autres compléments.
getShortcuts(): Promise<{[actionId: string]: string|null}>;
Retours
Promise<{[actionId: string]: string|null}>
Promesse qui se résout en un objet de raccourcis, les touches étant les ID des actions (telles que définies dans un manifeste étendu) et les valeurs étant les combinaisons de raccourcis. Par exemple, {"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2", "SetUnderline": null}
.
Remarques
Ensembles de conditions requises :
replaceShortcuts(shortcuts)
Remplace les raccourcis de complément existants par des raccourcis personnalisés pour l’utilisateur.
replaceShortcuts(shortcuts: {[actionId: string]: string}): Promise<void>;
Paramètres
- shortcuts
-
{[actionId: string]: string}
Objet de raccourcis personnalisés avec les touches étant les ID des actions (telles que définies dans un manifeste étendu) et les valeurs étant les combinaisons de raccourcis. Par exemple, {"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2"}
. Pour savoir comment spécifier un ID d’action valide et une combinaison de touches, voir Ajouter des raccourcis clavier personnalisés à vos compléments Office. (Notez qu’une combinaison de touches peut être null
, auquel cas, l’action conserve la combinaison de touches spécifiée dans le fichier JSON.)
Retours
Promise<void>
Promesse qui se résout lorsque chaque affectation de raccourci personnalisé dans shortcuts
a été inscrite. Même en cas de conflit avec les raccourcis existants, le raccourci personnalisé est inscrit. Sinon, la promesse est rejetée avec le code d’erreur et le message d’erreur. Un code d’erreur « InvalidOperation » est retourné si aucun ID d’action dans shortcuts
n’existe, ou si la combinaison de raccourcis n’est pas valide.
Remarques
Ensembles de conditions requises :
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour