ExtensionPoint-Element

Definiert, wo ein Add-In Funktionen in der Office-Benutzeroberfläche verfügbar macht. Das <ExtensionPoint-Element> ist ein untergeordnetes Element von AllFormFactors, DesktopFormFactor oder MobileFormFactor.

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0
• Mail 1.0
• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im reinen Add-In-Manifest.

Attribute

Erweiterungspunkte für Excel-, OneNote-, PowerPoint- und Word-Add-In-Befehle

Es gibt drei Arten von Erweiterungspunkten, die in einigen oder allen dieser Hosts verfügbar sind.

• PrimaryCommandSurface (Gültig für Word, Excel, PowerPoint und OneNote): Das Menüband in Office.
• ContextMenu (Gültig für Word, Excel, PowerPoint und OneNote): Das Kontextmenü, das angezeigt wird, wenn Sie mit der rechten Maustaste auf die Office-Benutzeroberfläche klicken (oder auswählen und halten).
• CustomFunctions (nur für Excel gültig): Eine benutzerdefinierte Funktion, die in JavaScript für Excel geschrieben wurde.

In den folgenden Unterabschnitten finden Sie die untergeordneten Elemente und Beispiele für diese Arten von Erweiterungspunkten.

PrimaryCommandSurface

Die primäre Befehlsoberfläche in Word, Excel, PowerPoint und OneNote ist das Menüband.

Untergeordnete Elemente

Beispiel

Das folgende Beispiel zeigt, wie das <ExtensionPoint-Element> mit PrimaryCommandSurface verwendet wird. Sie fügt dem Menüband eine benutzerdefinierte Registerkarte hinzu.

<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

Ein Kontextmenü ist ein Kontextmenü, das angezeigt wird, wenn Sie mit der rechten Maustaste auf die Office-Benutzeroberfläche klicken (oder auswählen und halten).

Untergeordnete Elemente

Beispiel

Im Folgenden wird das Kontextmenü angepasst, das für den ausgewählten Text in einer unterstützten Office-Anwendung geöffnet wird. Beachten Sie, dass das untergeordnete Steuerelement vom Typ Button sein muss.

<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

Eine benutzerdefinierte Funktion, die in JavaScript oder TypeScript für Excel geschrieben wurde.

Untergeordnete Elemente

Beispiel

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

Für Outlook verfügbare Erweiterungspunkte

• MessageReadCommandSurface
• MessageComposeCommandSurface
• AppointmentOrganizerCommandSurface
• AppointmentAttendeeCommandSurface
• Modul (kann nur in DesktopFormFactor verwendet werden)
• MobileMessageReadCommandSurface
• MobileOnlineMeetingCommandSurface
• MobileLogEventAppointmentAttendee
• LaunchEvent
• Events
• DetectedEntity
• ReportPhishingCommandSurface

MessageReadCommandSurface

Mit diesem Erweiterungspunkt werden Schaltflächen für die Ansicht gelesener Mails auf der Befehlsoberfläche platziert. In Outlook Desktop wird das Element im Menüband angezeigt.

Untergeordnete Elemente

OfficeTab-Beispiel

<ExtensionPoint xsi:type="MessageReadCommandSurface">
  <OfficeTab id="TabDefault">
        <-- OfficeTab Definition -->
  </OfficeTab>
</ExtensionPoint>

CustomTab-Beispiel

<ExtensionPoint xsi:type="MessageReadCommandSurface">
  <CustomTab id="Contoso.TabCustom2">
        <-- CustomTab Definition -->
  </CustomTab>
</ExtensionPoint>

MessageComposeCommandSurface

Dieser Erweiterungspunkt platziert Schaltflächen für Add-Ins, die Mailformulare zum Verfassen verwenden, im Menüband.

Untergeordnete Elemente

OfficeTab-Beispiel

<ExtensionPoint xsi:type="MessageComposeCommandSurface">
  <OfficeTab id="TabDefault">
        <-- OfficeTab Definition -->
  </OfficeTab>
</ExtensionPoint>

CustomTab-Beispiel

<ExtensionPoint xsi:type="MessageComposeCommandSurface">
  <CustomTab id="Contoso.TabCustom3">
        <-- CustomTab Definition -->
  </CustomTab>
</ExtensionPoint>

AppointmentOrganizerCommandSurface

Dieser Erweiterungspunkt platziert Schaltflächen für das Formular, das dem Organisator der Besprechung angezeigt wird, im Menüband.

Untergeordnete Elemente

OfficeTab-Beispiel

<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
  <OfficeTab id="TabDefault">
        <-- OfficeTab Definition -->
  </OfficeTab>
</ExtensionPoint>

CustomTab-Beispiel

<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
  <CustomTab id="Contoso.TabCustom4">
        <-- CustomTab Definition -->
  </CustomTab>
</ExtensionPoint>

AppointmentAttendeeCommandSurface

Dieser Erweiterungspunkt platziert Schaltflächen für das Formular, das dem Teilnehmer der Besprechung angezeigt wird, im Menüband.

Untergeordnete Elemente

OfficeTab-Beispiel

<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">
  <OfficeTab id="TabDefault">
        <-- OfficeTab Definition -->
  </OfficeTab>
</ExtensionPoint>

CustomTab-Beispiel

<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">
  <CustomTab id="Contoso.TabCustom5">
        <-- CustomTab Definition -->
  </CustomTab>
</ExtensionPoint>

Module

Dieser Erweiterungspunkt platziert Schaltflächen für die Modulerweiterung im Menüband.

Untergeordnete Elemente

MobileMessageReadCommandSurface

Mit diesem Erweiterungspunkt werden Schaltflächen für die Ansicht gelesener Mails auf der Befehlsoberfläche in dem mobilen Formfaktor platziert.

Untergeordnete Elemente

<ExtensionPoint-Elemente> dieses Typs können nur ein untergeordnetes Element aufweisen: ein <Group-Element> .

<Für Steuerelementelemente> , die in diesem Erweiterungspunkt enthalten sind, muss das xsi:type-Attribut auf MobileButtonfestgelegt sein.

Beispiel

<ExtensionPoint xsi:type="MobileMessageReadCommandSurface">
  <Group id="Contoso.mobileGroup1">
    <Label resid="residAppName"/>
    <Control xsi:type="MobileButton" id="Contoso.mobileButton1">
      <!-- Control definition -->
    </Control>
  </Group>
</ExtensionPoint>

MobileOnlineMeetingCommandSurface

Dieser Erweiterungspunkt platziert eine modusgerechte Umschaltfläche in der Befehlsoberfläche für einen Termin im mobilen Formfaktor. Ein Besprechungsorganisator kann eine Onlinebesprechung erstellen. Ein Teilnehmer kann anschließend an der Onlinebesprechung teilnehmen. Weitere Informationen zu diesem Szenario finden Sie unter Erstellen eines mobilen Outlook-Add-Ins für einen Onlinebesprechungsanbieter.

Untergeordnete Elemente

<ExtensionPoint-Elemente> dieses Typs können nur ein untergeordnetes Element aufweisen: ein <Control-Element> .

Für <das Control-Element> , das in diesem Erweiterungspunkt enthalten ist, muss das xsi:type-Attribut auf MobileButtonfestgelegt sein.

Die im <Icon-Element> angegebenen Bilder sollten unter Verwendung von Hexadenzcode #919191 oder ihrer Entsprechung in anderen Farbformaten in Graustufen vorliegen.

Beispiel

<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

Dieser Erweiterungspunkt platziert eine Schaltfläche " Aktion protokollieren " kontextabhängig in der Befehlsoberfläche für einen Termin im mobilen Formfaktor. Terminteilnehmer, bei denen das Add-In installiert ist, können ihre Terminnotizen mit einem Klick in einer externen App speichern. Dieser Erweiterungspunkt unterstützt Funktionen für Aufgabenbereichs- und Funktionsbefehle. Weitere Informationen zu diesem Szenario finden Sie unter Protokollieren von Terminnotizen für eine externe Anwendung in mobilen Outlook-Add-Ins.

Untergeordnete Elemente

<ExtensionPoint-Elemente> dieses Typs können nur ein untergeordnetes Element aufweisen: ein <Control-Element> .

Für <das Control-Element> , das in diesem Erweiterungspunkt enthalten ist, muss das xsi:type-Attribut auf MobileButtonfestgelegt sein.

Die im <Icon-Element> angegebenen Bilder sollten unter Verwendung von Hexadenzcode #919191 oder ihrer Entsprechung in anderen Farbformaten in Graustufen vorliegen.

Beispiel

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

LaunchEvent

Dieser Erweiterungspunkt ermöglicht die Aktivierung eines Add-Ins basierend auf unterstützten Ereignissen sowohl im Desktop- als auch im mobilen Formfaktor. Weitere Informationen zur ereignisbasierten Aktivierung und eine vollständige Liste der unterstützten Ereignisse finden Sie unter Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung.

Untergeordnete Elemente

Beispiel

<ExtensionPoint xsi:type="LaunchEvent">
  <LaunchEvents>
    <LaunchEvent Type="OnNewMessageCompose" FunctionName="onMessageComposeHandler"/>
    <LaunchEvent Type="OnNewAppointmentOrganizer" FunctionName="onAppointmentComposeHandler"/>
  </LaunchEvents>
  <!-- Identifies the runtime to be used (also referenced by the Runtime element). -->
  <SourceLocation resid="WebViewRuntime.Url"/>
</ExtensionPoint>

Ereignisse

Dieser Erweiterungspunkt fügt einen Ereignishandler für ein spezifisches Ereignis hinzu. Weitere Informationen zur Verwendung dieses Erweiterungspunkts finden Sie unter On-Send-Feature für Outlook-Add-Ins.

Beispiel für ein ItemSend-Ereignis

<ExtensionPoint xsi:type="Events">
  <Event Type="ItemSend" FunctionExecution="synchronous" FunctionName="itemSendHandler" />
</ExtensionPoint>

DetectedEntity

Dieser Erweiterungspunkt fügt eine Kontext-Add-In-Aktivierung für einen angegebenen Entitätstyp hinzu. Weitere Informationen zur Verwendung dieses Erweiterungspunkts finden Sie unter Kontextbezogene Outlook-Add-Ins.

Das enthaltende VersionOverrides-Element muss den xsi:type-Attributwert aufweisen VersionOverridesV1_1.

Label

Erforderlich. Die Beschriftung der Gruppe. Das resid-Attribut darf nicht mehr als 32 Zeichen umfassen und muss auf den Wert des id-Attributs eines <String-Elements> im <ShortStrings-Element> im Resources-Element festgelegt werden.

Hervorhebungsanforderungen

Ein Benutzer kann ein Kontext-Add-In nur durch Interaktion mit einer hervorgehobenen Entität aktivieren. Entwickler können steuern, welche Entitäten hervorgehoben werden, indem sie das Highlight-Attribut des <Rule-Elements> für den ItemHasRegularExpressionMatch Regeltyp verwenden.

Sie müssen jedoch einige Einschränkungen beachten. Mit diesen Einschränkungen soll sichergestellt werden, dass in anwendbaren Nachrichten oder Terminen immer eine hervorgehobene Entität vorhanden ist, damit der Benutzer das Add-In aktivieren kann.

• Bei Verwendung einer einzelnen Regel MUSS das Highlight-Attribut auf allfestgelegt werden.
• Wenn Sie einen RuleCollection Regeltyp mit Mode="And" verwenden, um mehrere Regeln zu kombinieren, MUSS mindestens für eine der Regeln das Highlight-Attribut auf allfestgelegt sein.
• Wenn Sie einen RuleCollection Regeltyp mit Mode="Or" verwenden, um mehrere Regeln zu kombinieren, MUSS für alle Regeln das Highlight-Attribut auf allfestgelegt sein.

Beispiel für DetectedEntity-Ereignis

<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

Dieser Erweiterungspunkt aktiviert Ihr Add-In für die Spamberichterstattung im Outlook-Menüband und verhindert, dass es am Ende des Menübands oder im Überlaufmenü angezeigt wird.

Weitere Informationen zum Implementieren der Spamberichterstattungsfunktion in Ihrem Add-In finden Sie unter Implementieren eines integrierten Spamberichts-Add-Ins.

Untergeordnete Elemente

Beispiel

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