PowerPoint.Hyperlink class

Gibt die Adresse des Links an, bei der es sich um eine URL, einen Dateinamen, einen Dateipfad oder eine E-Mail-Adresse mit dem mailto URI-Schema handeln kann.

address: string;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.6

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Gibt die Zeichenfolge an, die angezeigt wird, wenn der Mauszeiger über den Link bewegt wird.

screenTip: string;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.6

Gibt den Objekttyp zurück, auf den der Link angewendet wird. Weitere Informationen finden Sie unter PowerPoint.HyperlinkType .

readonly type: PowerPoint.HyperlinkType | "TextRange" | "Shape";

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.10

Löscht den Hyperlink.

delete(): void;

Gibt zurück

Hinweise

API-Satz: PowerPointApi 1.10

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/hyperlinks/manage-hyperlinks.yaml

// Deletes the first hyperlink found in the selected text on the current slide.
await PowerPoint.run(async (context) => {
  const textRange: PowerPoint.TextRange = context.presentation.getSelectedTextRange().load("text");
  let hyperlink: PowerPoint.Hyperlink = textRange.hyperlinks.getItemAt(0).load("address,screenTip");
  try {
    await context.sync();
  } catch {
    console.warn(
      "Confirm that you have at least one slide and you've selected a contiguous range of text containing at least one hyperlink on the active slide.",
    );
    return;
  }

  console.log(
    `About to delete first link "${hyperlink.address}" (screen tip: "${hyperlink.screenTip}") found in the selected text "${textRange.text}".`,
  );

  hyperlink.delete();

  console.log(`Deleted first link found in the selected text "${textRange.text}".`);
});

Gibt das PowerPoint.Shape-Objekt zurück, auf das der Link angewendet wird. Wenn der Hyperlink nicht vom Typ shapeist oder sich in einer Domäne befindet, die PowerPoint.Shape derzeit nicht unterstützt, gibt diese Methode ein Objekt mit seiner isNullObject Eigenschaft auf truezurück. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getLinkedShapeOrNullObject(): PowerPoint.Shape;

Gibt zurück

Hinweise

API-Satz: PowerPointApi 1.10

Gibt das PowerPoint.TextRange-Objekt zurück, auf das der Link angewendet wird. Wenn der Hyperlink nicht vom Typ textRangeist oder sich in einer Domäne befindet, die derzeit keine PowerPoint.TextRange unterstützt, dann gibt diese Methode ein Objekt zurück, dessen isNullObject Eigenschaft auf festgelegt ist true. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getLinkedTextRangeOrNullObject(): PowerPoint.TextRange;

Gibt zurück

Hinweise

API-Satz: PowerPointApi 1.10

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: PowerPoint.Interfaces.HyperlinkLoadOptions): PowerPoint.Hyperlink;

Parameter

Gibt zurück

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): PowerPoint.Hyperlink;

Parameter

Gibt zurück

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.Hyperlink;

Parameter

Gibt zurück

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche PowerPoint.Hyperlink Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als PowerPoint.Interfaces.HyperlinkData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): PowerPoint.Interfaces.HyperlinkData;

Gibt zurück