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: Dokument, E-Mail, Präsentation, Aufgabenbereich, Arbeitsmappe

Nur in diesen VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0
• Mail 1.0
• Mail 1.1

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

Attribute

Erweiterungspunkte für Excel, Outlook, PowerPoint und Word

• LaunchEvent : Aktiviert Aufgaben basierend auf Anwendungsereignissen, z. B. Öffnen.

LaunchEvent

Mit diesem Erweiterungspunkt kann ein Add-In basierend auf unterstützten Ereignissen sowohl im Desktop- als auch im mobilen Formfaktor aktiviert werden. Weitere Informationen zur ereignisbasierten Aktivierung sowie die vollständige Liste der unterstützten Ereignisse finden Sie unter Aktivieren von Add-Ins mit Ereignissen.

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. The resid value must match the resid value of the Runtime element that represents the browser runtime. -->
  <SourceLocation resid="WebViewRuntime.Url"/>
</ExtensionPoint>

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

Auf einigen oder allen dieser Hosts stehen drei Arten von Erweiterungspunkten zur Verfügung.

• PrimaryCommandSurface (gültig für Word, Excel, PowerPoint und OneNote) – Das Menüband in Office.
• Kontextmenü (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

Im folgenden Beispiel wird gezeigt, wie das <ExtensionPoint-Element> mit PrimaryCommandSurface verwendet wird. Er 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>

Kontextmenü

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

Mit den folgenden Schritten wird das Kontextmenü angepasst, das in einer unterstützten Office-Anwendung für den markierten Text geöffnet wird. Das verwendete Kontextmenü-Steuerelement ist vom Typ Schaltfläche.

<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 im DesktopFormFactor verwendet werden)
• MobileMessageReadCommandSurface
• MobileOnlineMeetingCommandSurface
• MobileLogEventAppointmentAttendee
• 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 fügt der Navigationsleiste von Outlook ein Modulerweiterungs-Add-In hinzu. Außerdem werden einer benutzerdefinierten Registerkarte im Menüband Schaltflächen für die Modulerweiterung hinzugefügt. Informationen zum Erstellen von Modulerweiterungen finden Sie unter Outlook-Add-Ins für Modulerweiterungen.

Untergeordnete Elemente

Beispiel

<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

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 haben: ein <Group-Element> .

<Für Steuerelementelemente> , die in diesem Erweiterungspunkt enthalten sind, muss das xsi:type-Attribut auf MobileButtongesetzt 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 fügt in der Befehlsoberfläche eine modusgerechte Umschaltmöglichkeit für einen Termin im mobilen Formfaktor hinzu. 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 Outlook Mobile-Add-Ins für einen Anbieter von Onlinebesprechungen.

Untergeordnete Elemente

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

Für das <in diesem Erweiterungspunkt enthaltene Control-Element> muss das Attribut xsi:type auf MobileButtongesetzt sein.

Die im <Icon-Element> angegebenen Bilder sollten in Graustufen mit Hex-Code #919191 oder einem Äquivalent in anderen Farbformaten 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 fügt kontextbezogen eine Protokoll-Aktionsschaltfläche in die Befehlsoberfläche für einen Termin im mobilen Formfaktor ein. Terminteilnehmer, die das Add-in installiert haben, können ihre Terminnotizen mit nur 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 in einer externen Anwendung in Outlook Mobile-Add-Ins.

Untergeordnete Elemente

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

Für das <in diesem Erweiterungspunkt enthaltene Control-Element> muss das Attribut xsi:type auf MobileButtongesetzt sein.

Die im <Icon-Element> angegebenen Bilder sollten in Graustufen mit Hex-Code #919191 oder einem Äquivalent in anderen Farbformaten 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>

Ereignisse

Dieser Erweiterungspunkt fügt einen Ereignishandler für ein spezifisches Ereignis hinzu. Weitere Informationen zur Verwendung dieses Erweiterungspunkts finden Sie unter "Beim-Senden"-Funktion 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 einen xsi:type-Attributwert von haben.VersionOverridesV1_1

Label

Erforderlich. Die Beschriftung der Gruppe. Das resid-Attribut darf nicht länger als 32 Zeichen sein und muss auf den Wert des id-Attributs eines <String-Elements im ShortStrings-Element>>des Resources-Elements 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.

• Wenn Sie eine einzelne Regel verwenden, MUSS das Hervorhebungsattribut auf allgesetzt sein.
• Wenn Sie einen RuleCollection Regeltyp mit Mode="And" verwenden, um mehrere Regeln zu kombinieren, MUSS bei mindestens einer der Regeln das Highlight-Attribut auf allgesetzt sein.
• Wenn Sie einen RuleCollection Regeltyp zum Mode="Or" Kombinieren mehrerer Regeln verwenden, MUSS das Attribut "Hervorheben" für alle Regeln 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 zur Spamberichterstattung im Outlook-Menüband und verhindert, dass es am Ende des Menübands oder im Überlaufmenü angezeigt wird.

Weitere Informationen zum Implementieren der Spamberichtsfunktion in Ihrem Add-In finden Sie unter Implementieren eines integrierten Add-In für die Spamberichterstattung.

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>