Elemento Action

Especifica a ação a executar quando o utilizador seleciona um controlo Botão ou Menu .

Válido apenas nestes esquemas VersionOverrides:

• Painel de tarefas 1.0
• Email 1.0
• Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• AddinCommands 1.1 quando versionOverrides principal< é o> tipo Taskpane 1.0.
• Caixa de correio 1.3 quando o VersionOverrides> principal< é do tipo Correio 1.0.
• Caixa de correio 1.5 quando o VersionOverrides> principal< é do tipo Correio 1.1.

Atributos

xsi:type

Este atributo especifica o tipo de ação realizada quando o usuário seleciona o botão. Pode ser uma das seguintes:

• ExecuteFunction
• ShowTaskpane

Quando o utilizador seleciona um botão que inicia a ação ExecuteFunction , o suplemento excede o tempo limite após 5 minutos, caso ainda não tenha sido concluído.

Elementos filho

Os elementos subordinados válidos dependem muito do valor do xsi:type parâmetro .

xsi:type é ExecuteFunction

FunctionName

Elemento necessário quando xsi:type é ExecuteFunction. Especifica o nome da função a ser executada. A função está contida no arquivo especificado no elemento FunctionFile.

<Action xsi:type="ExecuteFunction">
  <FunctionName>getSubject</FunctionName>
</Action>

xsi:type é ShowTaskpane

SourceLocation

Elemento necessário quando xsi:type é ShowTaskpane. Especifica o local do arquivo de origem para essa ação. O atributo resid não pode ter mais de 32 carateres e tem de ser definido para o valor do atributo ID de um <elemento url> no <elemento URLs> no elemento Resources .

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
</Action>

TaskpaneId

Elemento opcional quando xsi:type é ShowTaskpane. Especifica a ID do contêiner do painel de tarefas. Quando tiver várias ShowTaskpane ações, utilize um TaskpaneId> diferente< se quiser um painel independente para cada uma. Utilize o mesmo <TaskpaneId> para diferentes ações que partilham o mesmo painel. Quando os utilizadores escolherem comandos que partilham o mesmo <TaskpaneId>, o contentor do painel permanecerá aberto, mas os conteúdos do painel serão substituídos pela Ação SourceLocationcorrespondente.

Tipo de suplemento: Painel de tarefas

Válido apenas nestes esquemas VersionOverrides:

• Painel de tarefas 1.0

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• AddinCommands 1.1

O exemplo seguinte mostra duas ações que partilham o mesmo <TaskpaneId>.

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="aTaskPaneUrl" />
</Action>

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="anotherTaskPaneUrl" />
</Action>

Os exemplos seguintes mostram duas ações que utilizam um TaskpaneId> diferente<. Para ver estes exemplos em contexto, veja Simple Add-in Commands Sample (Exemplo de Comandos de Suplemento Simples).

<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>

Título

Elemento opcional quando xsi:type é ShowTaskpane. Especifica o título personalizado do painel de tarefas desta ação.

Tipo de suplemento: Painel de tarefas

Válido apenas nestes esquemas VersionOverrides:

• Painel de tarefas 1.0

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• AddinCommands 1.1

O exemplo seguinte mostra uma ação que utiliza o <elemento Título> . Tenha em atenção que não atribui o <Título> a uma cadeia diretamente. Em vez disso, atribua-lhe um ID de recurso (residir), que é definido na <secção Recursos> do manifesto e não pode ter mais de 32 carateres.

<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

Elemento opcional quando xsi:type é ShowTaskpane. Os elementos que contêm VersionOverrides têm de ter um valor de atributo xsi:type de VersionOverridesV1_1. Inclua esse elemento com um valor true a fim de fornecer suporte para fixação do painel de tarefas. O usuário pode "fixar" o painel de tarefas, fazendo com que ele permaneça aberto quando alterar a seleção. Para saber mais, consulte Implementar um painel de tarefas fixável no Outlook.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

• Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• Caixa de correio 1.5

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Elemento opcional nos suplementos do Outlook quando xsi:type é ShowTaskpane. Inclua um valor de true para permitir que um suplemento ative e execute operações específicas em várias mensagens selecionadas. Uma vez que a seleção múltipla do item só se aplica a mensagens, o valor do atributo xsi:type do elemento ExtensionPoint tem de ser definido como MessageReadCommandSurface ou MessageComposeCommandSurface. Para saber mais sobre a seleção múltipla de itens, consulte Ativar o seu suplemento do Outlook em várias mensagens.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

• Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• Caixa de correio 1.13

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskpaneUrl" />
    <SupportsMultiSelect>true</SupportsMultiSelect>
</Action>

SupportsNoItemContext

Elemento opcional nos suplementos do Outlook quando xsi:type é ShowTaskpane. Inclua um valor de para permitir a ativação de true um suplemento sem o Painel de Leitura ativado ou uma mensagem selecionada. Se <SupportsNoItemContext> estiver definido como true, o valor do atributo xsi:type do elemento ExtensionPoint tem de ser definido como MessageReadCommandSurface. Para saber mais, consulte Ativar o seu suplemento do Outlook sem o Painel de Leitura ativado ou uma mensagem selecionada.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

• Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

• Caixa de correio 1.13

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="Taskpane.Url"/>
    <SupportsNoItemContext>true</SupportsNoItemContext>
</Action>