Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Define onde um suplemento expõe a funcionalidade na interface de usuário do Office. O <elemento ExtensionPoint> é um elemento filho de AllFormFactors, DesktopFormFactor ou MobileFormFactor.
Tipo de suplemento: Documento, Email, Apresentação, Painel de tarefas, Pasta de trabalho
Válido somente nestes esquemas VersionOverrides:
- Painel de tarefas 1.0
- Email 1.0
- Email 1.1
Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.
Atributos
| Atributo | Obrigatório | Descrição |
|---|---|---|
| xsi:type | Sim | O tipo de ponto de extensão que está sendo definido. Os valores possíveis dependem do aplicativo host do Office definido no valor do elemento Host> avô<. |
Pontos de extensão para Excel, Outlook, PowerPoint e Word
- LaunchEvent - Ativa tarefas com base em eventos de aplicativo, como abrir.
LaunchEvent
Esse ponto de extensão permite que um suplemento seja ativado com base em eventos compatíveis nos formatos para desktop e celular. Para saber mais sobre a ativação baseada em eventos e para obter a lista completa de eventos com suporte, consulte Ativar suplementos com eventos.
Importante
Registro Mailbox e Itemeventos não estão disponíveis com este ponto de extensão.
Elementos filho
| Elemento | Descrição |
|---|---|
| LaunchEvents | Lista de LaunchEvent para ativação baseada em evento. |
| SourceLocation | O local do arquivo JavaScript de origem. Importante: o resid<valor do elemento SourceLocation> deve corresponder ao resid<valor do elemento Runtime> que representa o runtime do navegador. Por exemplo, se o seu tempo de execução for definido como <Runtime resid="WebViewRuntime.Url">, especifique <SourceLocation resid="WebViewRuntime.Url"/> |
Exemplo
<ExtensionPoint xsi:type="LaunchEvent">
<LaunchEvents>
<LaunchEvent Type="OnNewMessageCompose" FunctionName="onMessageComposeHandler"/>
<LaunchEvent Type="OnNewAppointmentOrganizer" FunctionName="onAppointmentComposeHandler"/>
</LaunchEvents>
<!-- Identifies the runtime to be used. The resid value must match the resid value of the Runtime element that represents the browser runtime. -->
<SourceLocation resid="WebViewRuntime.Url"/>
</ExtensionPoint>
Pontos de extensão para comandos de suplemento do Excel, OneNote, PowerPoint e Word
Há três tipos de pontos de extensão disponíveis em alguns ou todos esses hosts.
- PrimaryCommandSurface (válido para Word, Excel, PowerPoint e OneNote) - A faixa de opções no Office.
- ContextMenu (válido para Word, Excel, PowerPoint e OneNote) - O menu de atalho que aparece quando você clica com o botão direito do mouse (ou seleciona e segura) na interface do usuário do Office.
- CustomFunctions (Válido apenas para Excel) - Uma função personalizada escrita em JavaScript para Excel.
Consulte as seguintes subseções para os elementos filho e exemplos desses tipos de pontos de extensão.
PrimaryCommandSurface
A principal superfície de comando no Word, no Excel, no PowerPoint e no OneNote é a faixa de opções.
Elementos filho
| Elemento | Descrição |
|---|---|
| CustomTab | Obrigatório se você quiser adicionar uma guia personalizada à faixa de opções (usando PrimaryCommandSurface). Se você usar o <elemento CustomTab> , não poderá usar o <elemento OfficeTab> . O atributo id é obrigatório. Não pode haver mais de um <elemento filho CustomTab> . |
| OfficeTab | Necessário se você quiser estender uma guia de faixa de opções do aplicativo do Office padrão (usando PrimaryCommandSurface). Se você usar o <elemento OfficeTab> , não poderá usar o <elemento CustomTab> . |
Importante
Não pode haver mais de um <elemento ExtensionPoint> no suplemento que tenha um elemento CustomTab> filho<; e esse <elemento ExtensionPoint> pode ter apenas um <CustomTab>, portanto, há apenas um <elemento CustomTab> em todos os <elementos ExtensionPoint>.
Exemplo
O exemplo a seguir mostra como usar o <elemento ExtensionPoint> com PrimaryCommandSurface. Ele adiciona uma guia personalizada à faixa de opções.
Importante
Forneça uma ID exclusiva para os elementos que contêm um atributo ID.
<ExtensionPoint xsi:type="PrimaryCommandSurface">
<CustomTab id="Contoso.MyTab1">
<Label resid="residLabel4" />
<Group id="Contoso.Group1">
<Label resid="residLabel4" />
<Icon>
<bt:Image size="16" resid="icon1_32x32" />
<bt:Image size="32" resid="icon1_32x32" />
<bt:Image size="80" resid="icon1_32x32" />
</Icon>
<Control xsi:type="Button" id="Contoso.Button1">
<!-- information about the control -->
</Control>
<!-- other controls, as needed -->
</Group>
</CustomTab>
</ExtensionPoint>
ContextMenu
Um menu de contexto é um menu de atalho que aparece quando você clica com o botão direito do mouse (ou seleciona e segura) na interface do usuário do Office.
Elementos filho
| Elemento | Descrição |
|---|---|
| OfficeMenu | Obrigatório se você estiver adicionando comandos de suplemento a um menu de contexto padrão (usando ContextMenu). O atributo id deve ser definido como uma das cadeias de caracteres a seguir.
|
Exemplo
O seguinte personaliza o menu de contexto aberto no texto selecionado em um aplicativo do Office compatível. O controle do menu de contexto usado é do tipo Button.
<ExtensionPoint xsi:type="ContextMenu">
<OfficeMenu id="ContextMenuText"> <!-- OR, for Excel only: <OfficeMenu id="ContextMenuCell"> -->
<Control xsi:type="Button" id="ContextMenuButton">
<Label resid="TaskpaneButton.Label"/>
<Supertip>
<Title resid="TaskpaneButton.Label" />
<Description resid="TaskpaneButton.Tooltip" />
</Supertip>
<Icon>
<bt:Image size="16" resid="tpicon_16x16" />
<bt:Image size="32" resid="tpicon_32x32" />
<bt:Image size="80" resid="tpicon_80x80" />
</Icon>
<Action xsi:type="ExecuteFunction">
<FunctionName>action</FunctionName>
</Action>
</Control>
</OfficeMenu>
</ExtensionPoint>
CustomFunctions
Uma função personalizada escrita em JavaScript ou TypeScript para Excel.
Elementos filho
| Elemento | Descrição |
|---|---|
| Script | Obrigatório. Links para o arquivo JavaScript com a definição da função personalizada e o código de registro. |
| Page | Obrigatório. Links para a página HTML de suas funções personalizadas. |
| Metadados | Obrigatório. Define as configurações de metadados usados por uma função personalizada no Excel. |
| Namespace | Opcional. Define o namespace usado por uma função personalizada no Excel. |
Exemplo
<ExtensionPoint xsi:type="CustomFunctions">
<Script>
<SourceLocation resid="Functions.Script.Url"/>
</Script>
<Page>
<SourceLocation resid="Shared.Url"/>
</Page>
<Metadata>
<SourceLocation resid="Functions.Metadata.Url"/>
</Metadata>
<Namespace resid="Functions.Namespace"/>
</ExtensionPoint>
Pontos de extensão para Outlook
- MessageReadCommandSurface
- MessageComposeCommandSurface
- AppointmentOrganizerCommandSurface
- AppointmentAttendeeCommandSurface
- Módulo (só pode ser usado no DesktopFormFactor)
- MobileMessageReadCommandSurface
- MobileOnlineMeetingCommandSurface
- MobileLogEventAppointmentAttendee
- Eventos
- DetectedEntity
- ReportPhishingCommandSurface
MessageReadCommandSurface
Este ponto de extensão coloca os botões na superfície de comando para o modo de exibição de leitura de email. No Outlook para área de trabalho, isso aparece na faixa de opções.
Elementos filho
| Elemento | Descrição |
|---|---|
| OfficeTab | Adiciona os comandos à guia da faixa de opções padrão. |
| CustomTab | Adiciona os comandos à guia da faixa de opções personalizada. |
Exemplo de OfficeTab
<ExtensionPoint xsi:type="MessageReadCommandSurface">
<OfficeTab id="TabDefault">
<-- OfficeTab Definition -->
</OfficeTab>
</ExtensionPoint>
Exemplo de CustomTab
<ExtensionPoint xsi:type="MessageReadCommandSurface">
<CustomTab id="Contoso.TabCustom2">
<-- CustomTab Definition -->
</CustomTab>
</ExtensionPoint>
MessageComposeCommandSurface
Este ponto de extensão coloca botões na faixa de opções para suplementos que usam o formulário de composição de email.
Elementos filho
| Elemento | Descrição |
|---|---|
| OfficeTab | Adiciona os comandos à guia da faixa de opções padrão. |
| CustomTab | Adiciona os comandos à guia da faixa de opções personalizada. |
Exemplo de OfficeTab
<ExtensionPoint xsi:type="MessageComposeCommandSurface">
<OfficeTab id="TabDefault">
<-- OfficeTab Definition -->
</OfficeTab>
</ExtensionPoint>
Exemplo de CustomTab
<ExtensionPoint xsi:type="MessageComposeCommandSurface">
<CustomTab id="Contoso.TabCustom3">
<-- CustomTab Definition -->
</CustomTab>
</ExtensionPoint>
AppointmentOrganizerCommandSurface
Este ponto de extensão coloca botões na faixa de opções para o formulário exibido ao organizador da reunião.
Elementos filho
| Elemento | Descrição |
|---|---|
| OfficeTab | Adiciona os comandos à guia da faixa de opções padrão. |
| CustomTab | Adiciona os comandos à guia da faixa de opções personalizada. |
Exemplo de OfficeTab
<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
<OfficeTab id="TabDefault">
<-- OfficeTab Definition -->
</OfficeTab>
</ExtensionPoint>
Exemplo de CustomTab
<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
<CustomTab id="Contoso.TabCustom4">
<-- CustomTab Definition -->
</CustomTab>
</ExtensionPoint>
AppointmentAttendeeCommandSurface
Este ponto de extensão coloca botões na faixa de opções para o formulário exibido ao participante da reunião.
Elementos filho
| Elemento | Descrição |
|---|---|
| OfficeTab | Adiciona os comandos à guia da faixa de opções padrão. |
| CustomTab | Adiciona os comandos à guia da faixa de opções personalizada. |
Exemplo de OfficeTab
<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">
<OfficeTab id="TabDefault">
<-- OfficeTab Definition -->
</OfficeTab>
</ExtensionPoint>
Exemplo de CustomTab
<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">
<CustomTab id="Contoso.TabCustom5">
<-- CustomTab Definition -->
</CustomTab>
</ExtensionPoint>
Module
Esse ponto de extensão adiciona um suplemento de extensão de módulo à barra de navegação do Outlook. Ele também adiciona botões a uma guia personalizada na faixa de opções para a extensão do módulo. Para saber como criar extensões de módulo, consulte Extensão de módulo Suplementos do Outlook.
Importante
Registro Mailbox e Itemeventos não estão disponíveis com este ponto de extensão.
Elementos filho
| Elemento | Descrição |
|---|---|
| SourceLocation | Especifica o local do arquivo HTML que configura a interface do usuário principal do suplemento. |
| Rótulo | Especifica o rótulo da extensão do módulo. Seu atributo resid não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> no elemento ShortStrings . |
| CommandSurface | Adiciona um grupo de botões de suplemento a uma guia personalizada na faixa de opções. |
Exemplo
<ExtensionPoint xsi:type="Module">
<SourceLocation resid="residExtensionPointUrl"/>
<Label resid="residExtensionPointLabel"/>
<CommandSurface>
<CustomTab id="idTab">
<Group id="idGroup">
<Label resid="residGroupLabel"/>
<Control xsi:type="Button" id="group.changeToAssociate">
<Label resid="residChangeToAssociateLabel"/>
<Supertip>
<Title resid="residChangeToAssociateLabel"/>
<Description resid="residChangeToAssociateDesc"/>
</Supertip>
<Icon>
<bt:Image size="16" resid="residAssociateIcon16"/>
<bt:Image size="32" resid="residAssociateIcon32"/>
<bt:Image size="80" resid="residAssociateIcon80"/>
</Icon>
<Action xsi:type="ExecuteFunction">
<FunctionName>changeToAssociateRate</FunctionName>
</Action>
</Control>
</Group>
<Label resid="residCustomTabLabel"/>
</CustomTab>
</CommandSurface>
</ExtensionPoint>
MobileMessageReadCommandSurface
Este ponto de extensão coloca os botões na superfície de comando para o modo de exibição de leitura de email no fator forma móvel.
Elementos filho
| Elemento | Descrição |
|---|---|
| Group | Adiciona um grupo de botões à superfície de comando. |
<Elementos ExtensionPoint> desse tipo só podem ter um elemento filho: um <elemento Group> .
<Os elementos de controle> contidos neste ponto de extensão devem ter o atributo xsi:type definido como MobileButton.
Exemplo
<ExtensionPoint xsi:type="MobileMessageReadCommandSurface">
<Group id="Contoso.mobileGroup1">
<Label resid="residAppName"/>
<Control xsi:type="MobileButton" id="Contoso.mobileButton1">
<!-- Control definition -->
</Control>
</Group>
</ExtensionPoint>
MobileOnlineMeetingCommandSurface
Esse ponto de extensão coloca uma alternância apropriada ao modo na superfície de comando para um compromisso no formato móvel. O organizador de uma reunião pode criar uma reunião online. Um participante pode ingressar na reunião online posteriormente. Para saber mais sobre esse cenário, confira Criar um suplemento móvel do Outlook para um provedor de reuniões online.
Observação
Esse ponto de extensão só é compatível com Android e iOS com uma assinatura do Microsoft 365.
Registro Mailbox e Itemeventos não estão disponíveis com este ponto de extensão.
Elementos filho
| Elemento | Descrição |
|---|---|
| Control | Adiciona um botão à superfície de comando. |
<Elementos ExtensionPoint> desse tipo só podem ter um elemento filho: um <elemento Control> .
O <elemento Control> contido nesse ponto de extensão deve ter o atributo xsi:type definido como MobileButton.
As imagens especificadas no elemento Icon> devem estar em escala de cinza usando código< hexadecimal #919191 ou seu equivalente em outros formatos de cor.
Exemplo
<ExtensionPoint xsi:type="MobileOnlineMeetingCommandSurface">
<Control xsi:type="MobileButton" id="Contoso.onlineMeetingFunctionButton1">
<Label resid="residUILessButton0Name" />
<Icon>
<bt:Image resid="UiLessIcon" size="25" scale="1" />
<bt:Image resid="UiLessIcon" size="25" scale="2" />
<bt:Image resid="UiLessIcon" size="25" scale="3" />
<bt:Image resid="UiLessIcon" size="32" scale="1" />
<bt:Image resid="UiLessIcon" size="32" scale="2" />
<bt:Image resid="UiLessIcon" size="32" scale="3" />
<bt:Image resid="UiLessIcon" size="48" scale="1" />
<bt:Image resid="UiLessIcon" size="48" scale="2" />
<bt:Image resid="UiLessIcon" size="48" scale="3" />
</Icon>
<Action xsi:type="ExecuteFunction">
<FunctionName>insertContosoMeeting</FunctionName>
</Action>
</Control>
</ExtensionPoint>
MobileLogEventAppointmentAttendee
Esse ponto de extensão coloca um botão de ação Registrar contextualmente na superfície de comando para um compromisso no formato móvel. Os participantes do compromisso que têm o suplemento instalado podem salvar suas anotações de compromisso em um aplicativo externo com um clique. Esse ponto de extensão oferece suporte à funcionalidade do painel de tarefas e comandos de função. Para saber mais sobre esse cenário, consulte Registrar anotações de compromisso em um aplicativo externo nos suplementos móveis do Outlook.
Observação
Esse ponto de extensão só é compatível com Android e iOS com uma assinatura do Microsoft 365.
Registro Mailbox e Itemeventos não estão disponíveis com este ponto de extensão.
Elementos filho
| Elemento | Descrição |
|---|---|
| Control | Adiciona um botão à superfície de comando. |
<Elementos ExtensionPoint> desse tipo só podem ter um elemento filho: um <elemento Control> .
O <elemento Control> contido nesse ponto de extensão deve ter o atributo xsi:type definido como MobileButton.
As imagens especificadas no elemento Icon> devem estar em escala de cinza usando código< hexadecimal #919191 ou seu equivalente em outros formatos de cor.
Exemplo
<ExtensionPoint xsi:type="MobileLogEventAppointmentAttendee">
<Control xsi:type="MobileButton" id="appointmentReadFunctionButton">
<Label resid="LogButtonLabel" />
<Icon>
<bt:Image resid="Icon.16x16" size="25" scale="1" />
<bt:Image resid="Icon.16x16" size="25" scale="2" />
<bt:Image resid="Icon.16x16" size="25" scale="3" />
<bt:Image resid="Icon.32x32" size="32" scale="1" />
<bt:Image resid="Icon.32x32" size="32" scale="2" />
<bt:Image resid="Icon.32x32" size="32" scale="3" />
<bt:Image resid="Icon.80x80" size="48" scale="1" />
<bt:Image resid="Icon.80x80" size="48" scale="2" />
<bt:Image resid="Icon.80x80" size="48" scale="3" />
</Icon>
<Action xsi:type="ExecuteFunction">
<FunctionName>logToCRM</FunctionName>
</Action>
</Control>
</ExtensionPoint>
Eventos
Este ponto de extensão adiciona um manipulador de eventos para um evento especificado. Para obter mais informações sobre como usar esse ponto de extensão, consulte Recurso de envio para suplementos do Outlook.
Importante
Registro Mailbox e Itemeventos não estão disponíveis com este ponto de extensão.
Observação
Os Alertas Inteligentes, que é uma versão mais recente do recurso de envio, usam o ponto de extensão LaunchEvent para habilitar a ativação de eventos em um suplemento. Para saber mais sobre as principais diferenças entre os Alertas inteligentes e o recurso de envio, consulte Diferenças entre os Alertas inteligentes e o recurso de envio. Convidamos você a experimentar os Alertas Inteligentes preenchendo o passo a passo.
| Elemento | Descrição |
|---|---|
| Event | Especifica o evento e a função de manipulador de eventos. |
Exemplo do evento ItemSend
<ExtensionPoint xsi:type="Events">
<Event Type="ItemSend" FunctionExecution="synchronous" FunctionName="itemSendHandler" />
</ExtensionPoint>
DetectedEntity
Este ponto extensão adiciona uma ativação do suplemento contextual em um tipo de entidade especificada. Para obter mais informações sobre como usar esse ponto de extensão, consulte Suplementos contextuais do Outlook.
Importante
Os suplementos contextuais do Outlook baseados em entidades foram desativados. Como solução alternativa, implemente regras de expressão regular no suplemento contextual. Para obter orientação sobre como implementar essas regras, consulte Suplementos contextuais do Outlook.
O elemento VersionOverrides que contém deve ter um valor de atributo xsi:type de VersionOverridesV1_1.
Observação
- Este tipo de elemento está disponível para clientes do Outlook que ofereçam suporte a conjuntos de requisitos 1.6 e posteriores.
- Registro
MailboxeItemeventos não estão disponíveis com este ponto de extensão.
| Elemento | Descrição |
|---|---|
| Label | Especifica o rótulo para o suplemento na janela contextual. |
| SourceLocation | Especifica a URL para a janela contextual. |
| Rule | Especifica a regra ou regras que determinam quando um suplemento é ativado. |
Label
Obrigatório. O rótulo do grupo. O atributo resid não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> no <elemento ShortStrings> no elemento Resources .
Requisitos de realce
A única maneira que um usuário pode ativar um suplemento contextual é interagir com uma entidade realçada. Os desenvolvedores podem controlar quais entidades são destacadas usando o atributo Highlight do elemento Rule> para o tipo de< regra.ItemHasRegularExpressionMatch
No entanto, há algumas limitações que devem ser consideradas. Essas limitações são para garantir que sempre haverá uma entidade realçada em compromissos ou mensagens aplicáveis para oferecer ao usuário uma maneira de ativar o suplemento.
- Se estiver usando uma única regra, o atributo Realce DEVE ser definido como
all. - Se estiver usando um
RuleCollectiontipo de regra paraMode="And"combinar várias regras, pelo menos uma das regras DEVE ter o atributo Highlight definido comoall. - Se estiver usando um
RuleCollectiontipo de regra paraMode="Or"combinar várias regras, todas as regras DEVEM ter o atributo Highlight definido comoall.
Exemplo do evento DetectedEntity
<ExtensionPoint xsi:type="DetectedEntity">
<Label resid="Context.Label"/>
<SourceLocation resid="DetectedEntity.URL" />
<Rule xsi:type="RuleCollection" Mode="And">
<Rule xsi:type="ItemIs" ItemType="Message"/>
<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="videoURL" RegExValue="http://www\.youtube\.com/watch\?v=[a-zA-Z0-9_-]{11}" PropertyName="BodyAsPlaintext"/>
</Rule>
</ExtensionPoint>
ReportPhishingCommandSurface
Esse ponto de extensão ativa o suplemento de relatório de spam na faixa de opções do Outlook e impede que ele apareça no final da faixa de opções ou no menu estouro.
Para saber mais sobre como implementar o recurso de relatório de spam em seu suplemento, consulte Implementar um suplemento integrado de relatório de spam.
Elementos filho
| Elemento | Descrição |
|---|---|
| Elemento ReportPhishingCustomization | Configura o botão da faixa de opções e a caixa de diálogo de pré-processamento de um suplemento de relatório de spam. |
Exemplo
<ExtensionPoint xsi:type="ReportPhishingCommandSurface">
<ReportPhishingCustomization>
<!-- Configures the ribbon button. -->
<Control xsi:type="Button" id="ReportingButton">
<Label resid="ReportingButton.Label"/>
<Supertip>
<Title resid="ReportingButton.Label"/>
<Description resid="ReportingButton.Description"/>
</Supertip>
<Icon>
<bt:Image size="16" resid="Icon.16x16"/>
<bt:Image size="32" resid="Icon.32x32"/>
<bt:Image size="64" resid="Icon.64x64"/>
<bt:Image size="80" resid="Icon.80x80"/>
</Icon>
<Action xsi:type="ExecuteFunction">
<FunctionName>onMessageReport</FunctionName>
</Action>
</Control>
<!-- Configures the preprocessing dialog. -->
<PreProcessingDialog>
<Title resid="PreProcessingDialog.Label"/>
<Description resid="PreProcessingDialog.Description"/>
<ReportingOptions>
<Title resid="OptionsTitle.Label"/>
<Option resid="Option1.Label"/>
<Option resid="Option2.Label"/>
<Option resid="Option3.Label"/>
<Option resid="Option4.Label"/>
</ReportingOptions>
<FreeTextLabel resid="FreeText.Label"/>
<MoreInfo>
<MoreInfoText resid="MoreInfo.Label"/>
<MoreInfoUrl resid="MoreInfo.Url"/>
</MoreInfo>
</PreProcessingDialog>
<SourceLocation resid="Commands.Url"/>
</ReportPhishingCustomization>
</ExtensionPoint>