Élément Action
Spécifie l’action à effectuer lorsque l’utilisateur sélectionne un contrôle Button ou Menu .
Valide uniquement dans les schémas VersionOverrides suivants :
- Volet De tâches 1.0
- Mail 1.0
- Courrier 1.1
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
- AddinCommands 1.1 lorsque le parent <VersionOverrides> est de type Taskpane 1.0.
- Boîte aux lettres 1.3 lorsque le parent <VersionOverrides> est de type Courrier 1.0.
- Boîte aux lettres 1.5 lorsque le parent <VersionOverrides> est de type Mail 1.1.
Attributs
Attribut | Obligatoire | Description |
---|---|---|
xsi:type | Oui | Type d’action à effectuer |
xsi:type
Cet attribut indique le type d’action réalisée lorsque l’utilisateur sélectionne le bouton. Il peut s’agir de l’une des actions suivantes :
ExecuteFunction
ShowTaskpane
Une fois que l’utilisateur sélectionne un bouton qui lance l’action ExecuteFunction
, le complément expire au bout de 5 minutes s’il n’est pas terminé avant cette date.
Importante
Outlook : l’inscription des événements de boîte aux lettres et d’élément n’est pas disponible lorsque xsi :type a la valeur ExecuteFunction
.
Éléments enfants
Éléments enfants valides très en fonction de la valeur du xsi:type
paramètre .
xsi :type est ExecuteFunction
Élément | Description |
---|---|
FunctionName | Spécifie le nom de la fonction à exécuter. |
FunctionName
Élément obligatoire lorsque xsi :type a la valeur ExecuteFunction
. Indique le nom de la fonction à exécuter. La fonction est contenue dans le fichier indiqué dans l’élément FunctionFile.
<Action xsi:type="ExecuteFunction">
<FunctionName>getSubject</FunctionName>
</Action>
xsi :type est ShowTaskpane
Élément | Description |
---|---|
SourceLocation | Spécifie l’emplacement du fichier source pour cette action. |
TaskpaneId | Spécifie l’ID du conteneur de volet des tâches. Non pris en charge dans les compléments Outlook. |
Titre | Indique le titre personnalisé du volet Office. Non pris en charge dans les compléments Outlook. |
SupportsPinning | Indique qu’un volet des tâches prend en charge l’épinglage, ce qui conserve le volet des tâches ouvert lorsque l’utilisateur modifie la sélection. Pris en charge dans Outlook uniquement. |
SupportsMultiselect | Spécifie qu’un complément Outlook peut s’activer sur plusieurs messages sélectionnés. Pris en charge dans Outlook uniquement. |
SupportsNoItemContext | Spécifie qu’un complément Outlook peut s’activer sans que le volet de lecture soit activé ou qu’un message soit sélectionné. Pris en charge dans les clients de bureau Outlook uniquement. |
SourceLocation
Élément obligatoire lorsque xsi :type a la valeur ShowTaskpane
. Spécifie l’emplacement du fichier source pour cette action. L’attribut resid ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément Url> dans l’élément <Urls> de l’élément Resources .
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskPaneUrl" />
</Action>
TaskpaneId
Élément facultatif lorsque xsi :type a la valeur ShowTaskpane
. Spécifie l’ID du conteneur de volet des tâches. Lorsque vous avez plusieurs ShowTaskpane
actions, utilisez un TaskpaneId> différent< si vous souhaitez un volet indépendant pour chacune d’elles. Utilisez le même <TaskpaneId> pour différentes actions qui partagent le même volet. Lorsque les utilisateurs choisissent des commandes qui partagent le même <TaskpaneId>, le conteneur de volet reste ouvert, mais le contenu du volet est remplacé par l’Action SourceLocation
correspondante.
Type de complément : volet Office
Valide uniquement dans les schémas VersionOverrides suivants :
- Volet De tâches 1.0
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
Remarque
Cet élément n’est pas pris en charge dans Outlook.
L’exemple suivant montre deux actions qui partagent le même <TaskpaneId>.
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyPane</TaskpaneId>
<SourceLocation resid="aTaskPaneUrl" />
</Action>
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyPane</TaskpaneId>
<SourceLocation resid="anotherTaskPaneUrl" />
</Action>
Les exemples suivants montrent deux actions qui utilisent un TaskpaneId> différent<. Pour voir ces exemples en contexte, consultez Exemple de commandes de complément simple.
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyTaskPaneID1</TaskpaneId>
<SourceLocation resid="Contoso.Taskpane1.Url" />
</Action>
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyTaskPaneID2</TaskpaneId>
<SourceLocation resid="Contoso.Taskpane2.Url" />
</Action>
<bt:Urls>
<bt:Url id="Contoso.Taskpane1.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane.html" />
<bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane2.html" />
</bt:Urls>
Titre
Élément facultatif lorsque xsi :type a la valeur ShowTaskpane
. Indique le titre personnalisé du volet Office pour cette action.
Type de complément : volet Office
Valide uniquement dans les schémas VersionOverrides suivants :
- Volet De tâches 1.0
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
Remarque
Cet élément enfant n’est pas pris en charge dans les compléments Outlook.
L’exemple suivant montre une action qui utilise l’élément <Title> . Notez que vous n’attribuez pas directement le <titre> à une chaîne. Au lieu de cela, vous lui affectez un ID de ressource (resid), qui est défini dans la <section Ressources> du manifeste et ne peut pas comporter plus de 32 caractères.
<Action xsi:type="ShowTaskpane">
<TaskpaneId>Office.AutoShowTaskpaneWithDocument</TaskpaneId>
<SourceLocation resid="PG.Code.Url" />
<Title resid="PG.CodeCommand.Title" />
</Action>
... Other markup omitted ...
<Resources>
<bt:Images> ...
</bt:Images>
<bt:Urls>
<bt:Url id="PG.Code.Url" DefaultValue="https://localhost:3000?commands=1" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="PG.CodeCommand.Title" DefaultValue="Code" />
</bt:ShortStrings>
... Other markup omitted ...
</Resources>
SupportsPinning
Élément facultatif lorsque xsi :type a la valeur ShowTaskpane
. Les éléments VersionOverrides contenant doivent avoir une valeur d’attribut xsi :type de VersionOverridesV1_1
. Incluez cet élément avec une valeur true
pour prendre en charge l’épinglage du volet Office. L’utilisateur pourra alors « épingler » le volet Office qui restera ouvert pendant que la sélection est modifiée. Pour en savoir plus, consultez l’article relatif à l’implémentation d’un volet Office épinglable dans Outlook.
Type de complément : messagerie
Valide uniquement dans les schémas VersionOverrides suivants :
- Courrier 1.1
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
Importante
Bien que l’élément SupportsPinning ait été introduit dans l’ensemble de conditions requises 1.5, il est actuellement pris en charge uniquement pour les abonnés Microsoft 365 à l’aide des éléments suivants :
- Outlook moderne sur le web
- nouvel Outlook sur Windows
- Outlook 2016 ou version ultérieure sur Windows (build 7628.1000 ou ultérieure)
- Outlook sur Mac (build 16.13.503 ou ultérieure)
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskPaneUrl" />
<SupportsPinning>true</SupportsPinning>
</Action>
SupportsMultiselect
Élément facultatif dans les compléments Outlook lorsque xsi :type a la valeur ShowTaskpane
. Incluez la valeur pour permettre à un complément d’activer true
et d’effectuer des opérations spécifiques sur plusieurs messages sélectionnés. Étant donné que la sélection multiple d’élément s’applique uniquement aux messages, la valeur de l’attribut xsi :type de l’élément ExtensionPoint doit être définie sur MessageReadCommandSurface
ou MessageComposeCommandSurface
. Pour en savoir plus sur la sélection multiple d’éléments, voir Activer votre complément Outlook sur plusieurs messages.
Type de complément : messagerie
Valide uniquement dans les schémas VersionOverrides suivants :
- Courrier 1.1
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskpaneUrl" />
<SupportsMultiSelect>true</SupportsMultiSelect>
</Action>
SupportsNoItemContext
Élément facultatif dans les compléments Outlook lorsque xsi :type a la valeur ShowTaskpane
. Incluez la valeur pour permettre à un complément de true
s’activer sans que le volet de lecture soit activé ou qu’un message soit sélectionné. Si <SupportsNoItemContext> a la valeur true
, la valeur de l’attribut xsi :type de l’élément ExtensionPoint doit être définie sur MessageReadCommandSurface
. Pour plus d’informations, voir Activer votre complément Outlook sans que le volet de lecture soit activé ou qu’un message soit sélectionné.
Type de complément : messagerie
Valide uniquement dans les schémas VersionOverrides suivants :
- Courrier 1.1
Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.
Associé à ces ensembles de conditions requises :
Remarque
Bien qu’Outlook sur le web et les nouveaux Outlook sur Windows prennent en charge l’ensemble de conditions requises pour les boîtes aux lettres 1.13, un complément ne s’active pas si le volet de lecture est masqué ou si un message n’est pas sélectionné pour la première fois. Pour plus d’informations, consultez Prise en charge des fonctionnalités dans Outlook sur le web et Nouvelle version d’Outlook sur Windows.
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="Taskpane.Url"/>
<SupportsNoItemContext>true</SupportsNoItemContext>
</Action>
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