PowerPoint.Hyperlink class

Indique l’adresse du lien hypertexte (qui peut être une URL, un nom de fichier ou un chemin d’accès au fichier, ou une adresse e-mail avec le schéma de l’URI mailto ).

address: string;

Valeur de propriété

Remarques

Jeu d’API : PowerPointApi 1.6

Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office.

context: RequestContext;

Valeur de propriété

Spécifie la chaîne affichée lorsque vous pointez sur le lien hypertexte.

screenTip: string;

Valeur de propriété

Remarques

Jeu d’API : PowerPointApi 1.6

Renvoie le type d’objet auquel le lien hypertexte est appliqué. Pour plus d’informations , consultez PowerPoint.HyperlinkType .

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

Valeur de propriété

Remarques

Jeu d’API : PowerPointApi 1.10

Supprime le lien hypertexte.

delete(): void;

Retours

Remarques

Jeu d’API : PowerPointApi 1.10

Exemples

// 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}".`);
});

Renvoie l’objet PowerPoint.Shape auquel le lien hypertexte est appliqué. Si le lien hypertexte n’est pas de type shape, ou s’il se trouve dans un domaine qui ne prend pas en charge actuellement un PowerPoint.Shape, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez * Méthodes et propriétés d’OrNullObject.

getLinkedShapeOrNullObject(): PowerPoint.Shape;

Retours

Remarques

Jeu d’API : PowerPointApi 1.10

Renvoie l’objet PowerPoint.TextRange auquel le lien hypertexte est appliqué. Si le lien hypertexte n’est pas de type textRange, ou s’il se trouve dans un domaine qui ne prend pas en charge actuellement un PowerPoint.TextRange, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez * Méthodes et propriétés d’OrNullObject.

getLinkedTextRangeOrNullObject(): PowerPoint.TextRange;

Retours

Remarques

Jeu d’API : PowerPointApi 1.10

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine PowerPoint.Hyperlink est un objet API, la toJSON méthode renvoie un objet JavaScript simple (typé ) PowerPoint.Interfaces.HyperlinkDataqui contient des copies superficielles de toutes les propriétés enfants chargées à partir de l’objet d’origine.

toJSON(): PowerPoint.Interfaces.HyperlinkData;

Retours