Gérer les hyperliens de présentation en Python via Java
Introduction
Un hyperlien relie le contenu d’une présentation à un site Web ou à un emplacement au sein de la présentation. Dans PowerPoint, les hyperliens servent généralement deux objectifs :
- Ouvrir un site Web à partir du texte, d’une forme ou d’un cadre multimédia.
- Naviguer vers une autre diapositive, par exemple depuis une table des matières.
Aspose.Slides for Python via Java vous permet d’ajouter ces liens, de contrôler leur apparence et leur son, de mettre à jour leurs propriétés et de les supprimer. Les exemples ci‑dessous montrent comment travailler avec les hyperliens sur des éléments individuels et comment accéder aux hyperliens au niveau de la présentation, de la diapositive ou du cadre de texte.
Note
Vous pouvez également modifier des présentations avec le éditeur en ligne gratuit Aspose PowerPoint.Ajouter des hyperliens URL
Vous pouvez affecter une URL de site Web à du texte, à une forme ou à un cadre multimédia. L’élément auquel vous affectez l’hyperlien détermine la zone cliquable : une portion de texte lie le texte sélectionné, tandis qu’une forme ou un cadre lie l’objet de la diapositive.
Pour les présentations contenant des hyperliens relatifs, consultez Gérer la base d’hyperlien pour lire, modifier ou effacer la base au niveau du document.
Ajouter des hyperliens URL au texte
Pour lier du texte à un site Web, transmettez un Hyperlink à la méthode setHyperlinkClick de la portion de texte, comme indiqué ci‑dessus. Seule cette portion de texte devient cliquable.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Hyperlink, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, False)
shape.addTextFrame("Aspose: File Format APIs")
portion_format = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
portion_format.setHyperlinkClick(Hyperlink("https://www.aspose.com/"))
portion_format.getHyperlinkClick().setTooltip("Explore Aspose file format APIs")
portion_format.setFontHeight(32)
presentation.save("presentation-out.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Ajouter des hyperliens URL aux formes et aux cadres multimédia
Appelez setHyperlinkClick sur le rectangle pour rendre toute sa zone cliquable. Utilisez setTooltip pour afficher aux lecteurs une indication sur la destination lorsqu’ils survolent le rectangle. Les deux méthodes s’appliquent également aux cadres d’image, d’audio et de vidéo.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Hyperlink, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50)
shape.setHyperlinkClick(Hyperlink("https://www.aspose.com/"))
shape.getHyperlinkClick().setTooltip("Explore Aspose file format APIs")
presentation.save("presentation-out.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Utiliser les hyperliens pour créer une table des matières
Les hyperliens internes permettent aux lecteurs de passer d’une table des matières à une diapositive spécifique. L’exemple suivant utilise setInternalHyperlinkClick pour lier le texte « Page 2 » de la première diapositive à la deuxième diapositive.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Paragraph, Portion, Presentation, SaveFormat, ShapeType
Color = jpype.JClass("java.awt.Color")
presentation = Presentation()
try:
first_slide = presentation.getSlides().get_Item(0)
second_slide = presentation.getSlides().addEmptySlide(first_slide.getLayoutSlide())
table_of_contents = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 300, 100)
table_of_contents.getFillFormat().setFillType(FillType.NoFill)
table_of_contents.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
table_of_contents.getTextFrame().getParagraphs().clear()
paragraph = Paragraph()
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph.setText("Title of slide 2 .......... ")
link_portion = Portion()
link_portion.setText("Page 2")
link_portion.getPortionFormat().getHyperlinkManager().setInternalHyperlinkClick(second_slide)
paragraph.getPortions().add(link_portion)
table_of_contents.getTextFrame().getParagraphs().add(paragraph)
presentation.save("link_to_slide.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Formater les hyperliens
Vous pouvez modifier la couleur du texte lié, jouer ou arrêter un son lorsque un lecteur active un lien, et définir l’infobulle qui apparaît au survol.
Couleur
La méthode setColorSource de Hyperlink détermine si un hyperlien utilise la couleur d’hyperlien de la présentation ou le formatage de la portion de texte. Pour appliquer une couleur de texte personnalisée, sélectionnez HyperlinkColorSource.PortionFormat et définissez la couleur de remplissage de la portion. Cette fonctionnalité a été introduite dans PowerPoint 2019 ; les versions antérieures n’appliquent pas ce paramètre.
Dans cet exemple, setColorSource fait que le premier lien utilise le remplissage rouge de la portion de texte. Le deuxième lien conserve la couleur d’hyperlien de la présentation.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Hyperlink, HyperlinkColorSource, Presentation, SaveFormat, ShapeType
Color = jpype.JClass("java.awt.Color")
presentation = Presentation()
try:
colored_link_shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 450, 50, False)
colored_link_shape.addTextFrame("This hyperlink uses a custom color.")
portion_format = colored_link_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
portion_format.setHyperlinkClick(Hyperlink("https://www.aspose.com/"))
portion_format.getHyperlinkClick().setColorSource(HyperlinkColorSource.PortionFormat)
portion_format.getFillFormat().setFillType(FillType.Solid)
portion_format.getFillFormat().getSolidFillColor().setColor(Color.RED)
default_link_shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 450, 50, False)
default_link_shape.addTextFrame("This hyperlink uses the default color.")
default_link_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().setHyperlinkClick(Hyperlink("https://www.aspose.com/"))
presentation.save("presentation-out-hyperlink.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Son
Un hyperlien peut jouer un son lorsqu’il est activé ou arrêter un son déjà en cours de lecture. Utilisez les méthodes suivantes pour configurer ces comportements :
- Hyperlink.setSound spécifie l’audio associé à l’hyperlien.
- Hyperlink.setStopSoundOnClick contrôle si l’activation de l’hyperlien arrête le son précédent.
Ajouter un son d’hyperlien
Le bouton de la première diapositive utilise Hyperlink.setSound pour lire l’audio depuis sampleaudio.wav lorsque le lecteur clique pour avancer. Sur la deuxième diapositive, un bouton distinct utilise Hyperlink.setStopSoundOnClick pour arrêter la lecture et laisser le lecteur sur cette diapositive.
from pathlib import Path
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Hyperlink, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
audio_data = Path("sampleaudio.wav").read_bytes()
java_audio_data = jpype.JArray(jpype.JByte)(audio_data)
hyperlink_sound = presentation.getAudios().addAudio(java_audio_data)
first_slide = presentation.getSlides().get_Item(0)
play_button = first_slide.getShapes().addAutoShape(ShapeType.SoundButton, 100, 100, 100, 50)
play_button.setHyperlinkClick(Hyperlink.getNextSlide())
if not play_button.getHyperlinkClick().getStopSoundOnClick() and play_button.getHyperlinkClick().getSound() is None:
play_button.getHyperlinkClick().setSound(hyperlink_sound)
second_slide = presentation.getSlides().addEmptySlide(first_slide.getLayoutSlide())
stop_button = second_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 100, 50)
stop_button.setHyperlinkClick(Hyperlink.getNoAction())
stop_button.getHyperlinkClick().setStopSoundOnClick(True)
presentation.save("hyperlink-sound.pptx", SaveFormat.Pptx)
except OSError as exception:
print(f"Unable to read the audio file: {exception}")
finally:
presentation.dispose()
Extraire un son d’hyperlien
L’exemple suivant ouvre la présentation créée ci‑dessus et lit l’audio de l’hyperlien de la première forme en mémoire via getSound et getBinaryData.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("hyperlink-sound.pptx")
try:
if presentation.getSlides().size() > 0 and presentation.getSlides().get_Item(0).getShapes().size() > 0:
hyperlink = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getHyperlinkClick()
sound = hyperlink.getSound() if hyperlink is not None else None
if sound is not None:
audio_data = bytes(sound.getBinaryData())
print(f"Extracted {len(audio_data)} bytes of hyperlink audio.")
else:
print("The first shape has no hyperlink sound.")
else:
print("The presentation has no first slide or shape to inspect.")
finally:
presentation.dispose()
Paramètres d’infobulle et d’interaction
Vous pouvez appeler les méthodes Hyperlink suivantes après avoir assigné un hyperlien à du texte ou à une forme :
- setTooltip définit le texte qu’un lecteur peut afficher comme indice pour le lien.
- setTargetFrame spécifie le cadre cible au sein d’un frameset HTML parent, le cas échéant.
- setHistory contrôle si l’activation du lien ajoute sa destination à la liste des hyperliens consultés.
- setHighlightClick contrôle si l’hyperlien est mis en évidence lorsqu’on le clique.
Supprimer les hyperliens des présentations
Utilisez getAnyHyperlinks pour collecter les conteneurs d’hyperliens, y compris les liens de portions de texte, avant de les modifier. L’exemple suivant supprime les deux types d’activation de la première diapositive. Pour supprimer seulement un type, appelez uniquement removeHyperlinkClick ou removeHyperlinkMouseOver ; la suppression d’une action de clic ne supprime pas son équivalent au survol.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("pres.pptx")
try:
if presentation.getSlides().size() > 0:
containers = list(presentation.getSlides().get_Item(0).getHyperlinkQueries().getAnyHyperlinks())
for container in containers:
container.getHyperlinkManager().removeHyperlinkClick()
container.getHyperlinkManager().removeHyperlinkMouseOver()
presentation.save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx)
else:
print("The presentation has no slides to process.")
finally:
presentation.dispose()
Pour une suppression inconditionnelle, removeAllHyperlinks supprime les deux types d’activation dans la portée sélectionnée en un seul appel. Pour un nettoyage sélectif et la prise en compte des maîtres, des dispositions et des notes, consultez Rapport, assainir et vérifier les hyperliens.
Effacer les hyperliens avant de remplacer le texte SmartArt
Lorsque vous remplacez un paragraphe dans un nœud SmartArt existant, le fait d’effacer ses portions de texte peut laisser un ancien hyperlien actif. Récupérez le paragraphe via SmartArtNode.getTextFrame. Avant d’effacer ses portions, appelez getHyperlinkQueries sur le cadre texte de la forme du nœud affichant le paragraphe, puis appelez removeAllHyperlinks sur l’objet retourné. Cela supprime chaque hyperlien dans ce cadre, y compris les liens de ses autres paragraphes.
L’exemple suppose que la troisième forme de la première diapositive de SmartArtHyperlink.pptx est un graphique SmartArt. Il remplace le premier paragraphe du quatrième nœud. Dans cette présentation, la première forme du nœud affiche ce paragraphe.
Après avoir ajouté les deux portions, l’exemple lit leur formatage effectif avec getEffective. Sur ce formatage, getHyperlinkClick renvoie le nouvel hyperlien pour la première portion et None pour la seconde.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Hyperlink, Portion, Presentation
presentation = Presentation("SmartArtHyperlink.pptx")
try:
slide = presentation.getSlides().get_Item(0)
smart_art = slide.getShapes().get_Item(2)
node = smart_art.getAllNodes().get_Item(3)
paragraph = node.getTextFrame().getParagraphs().get_Item(0)
node.getShapes().get_Item(0).getTextFrame().getHyperlinkQueries().removeAllHyperlinks()
paragraph.getPortions().clear()
link = Portion("New reference")
link.getPortionFormat().setHyperlinkClick(Hyperlink("https://example.com/new"))
paragraph.getPortions().add(link)
text = Portion(" (updated)")
paragraph.getPortions().add(text)
print(link.getPortionFormat().getEffective().getHyperlinkClick().getExternalUrl()) # https://example.com/new
print(text.getPortionFormat().getEffective().getHyperlinkClick()) # Aucun
finally:
presentation.dispose()
Construire un inventaire complet des hyperliens
Avant de distribuer une présentation, recensez ses actions interactives ainsi que ses liens web. getAnyHyperlinks renvoie des conteneurs d’hyperliens, tels que les objets Shape et PortionFormat, et non une liste plate de chaînes URL. Inspectez à la fois getHyperlinkClick et getHyperlinkMouseOver sur chaque conteneur. Ils sont indépendants : le même conteneur peut exposer les deux actions, ainsi un rapport complet nécessite jusqu’à deux lignes par conteneur.
Analyser uniquement les hyperliens au niveau des formes peut omettre les liens attachés aux portions de texte. Interrogez plutôt la portée appropriée et conservez les conteneurs retournés afin de pouvoir mettre à jour ou supprimer leurs actions ultérieurement.
Interroger les portées présentation, diapositive et cadre de texte
La classe HyperlinkQueries est disponible via Presentation.getHyperlinkQueries, BaseSlide.getHyperlinkQueries et TextFrame.getHyperlinkQueries. Chaque portée prend en charge les mêmes requêtes :
- getHyperlinkClicks renvoie les conteneurs avec une action de clic.
- getHyperlinkMouseOvers renvoie les conteneurs avec une action de survol.
- getAnyHyperlinks renvoie les conteneurs avec l’une ou les deux actions.
Cet exemple attribue des actions de clic et de survol à une forme et à son texte, et une action macro à un bouton séparé. Il compare le nombre de conteneurs retournés par getAnyHyperlinks avec les comptes pour chaque type d’activation. Une requête de cadre de texte ne compte que les liens dans le texte. Les propres actions de la forme conteneuse apparaissent dans les requêtes de diapositive et de présentation.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, ShapeType
def print_counts(scope, queries):
click_count = queries.getHyperlinkClicks().size()
mouse_over_count = queries.getHyperlinkMouseOvers().size()
any_count = queries.getAnyHyperlinks().size()
print(f"{scope}: click={click_count}, mouse-over={mouse_over_count}, any={any_count}")
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
destination = presentation.getSlides().addEmptySlide(slide.getLayoutSlide())
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 400, 60)
shape.getTextFrame().setText("Click the text to go to slide 2")
shape.getHyperlinkManager().setExternalHyperlinkClick("https://example.com/")
shape.getHyperlinkClick().setTooltip("Public website")
shape.getHyperlinkManager().setExternalHyperlinkMouseOver("file:///C:/private/report.xlsx")
portion_format = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
portion_format.getHyperlinkManager().setInternalHyperlinkClick(destination)
portion_format.getHyperlinkManager().setExternalHyperlinkMouseOver("https://example.com/help")
macro_button = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 120, 200, 60)
macro_button.getHyperlinkManager().setMacroHyperlinkClick("ReviewPresentation")
print_counts("Presentation", presentation.getHyperlinkQueries())
print_counts("Slide 1", slide.getHyperlinkQueries())
print_counts("Text frame", shape.getTextFrame().getHyperlinkQueries())
presentation.save("hyperlink-audit-input.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Pour cet exemple, les requêtes de présentation et de diapositive rapportent chacune trois conteneurs de clic, deux conteneurs de survol et trois conteneurs avec l’une ou l’autre action. La requête de cadre de texte rapporte un conteneur dans chaque catégorie.
Classer les actions et les destinations
Utilisez Hyperlink.getActionType pour interpréter une action avant d’interpréter sa destination. Les valeurs de HyperlinkActionType couvrent plus que la navigation web :
| Values | Signification pour un audit |
|---|---|
Hyperlink |
Hyperlien externe ; inspectez l’URL et son schéma. |
JumpSpecificSlide |
Navigation interne vers une diapositive particulière. |
JumpFirstSlide, JumpPreviousSlide, JumpNextSlide, JumpLastSlide, JumpLastViewedSlide |
Navigation de diaporama intégrée, résolue dans le contexte du diaporama. |
JumpEndShow, StartCustomSlideShow |
Termine le diaporama actuel ou démarre un diaporama personnalisé. |
StartMacro |
Exécute une macro. |
StartProgram |
Lance un programme. |
OpenFile, OpenPresentation |
Ouvre un fichier ou une autre présentation ; examinez séparément des URL web. |
StartStopMedia |
Démarre ou arrête la lecture multimédia. |
NoAction, Unknown |
Aucune action de navigation, ou une action non reconnue nécessitant une révision. |
Lire les destinations externes via getExternalUrl et les destinations internes spécifiques via getTargetSlide. Les actions internes et les commandes intégrées peuvent ne pas avoir d’URL externe ; une URL vide ne signifie pas que le conteneur n’a aucune action. Conservez la valeur renvoyée par getExternalUrlOriginal lorsqu’elle diffère de l’URL normalisée, et incluez l’infobulle renvoyée par getTooltip lorsqu’elle est disponible.
Rapport, assainir et vérifier les hyperliens
Cet exemple ouvre la présentation de l’exemple précédent et écrit un enregistrement JSON par action. Il utilise getAnyHyperlinks pour collecter les conteneurs sur les diapositives ordinaires, les maîtres, les dispositions et les notes, y compris les maîtres de notes et de supports lorsque présents. Il utilise l’égalité de référence pour compter chaque conteneur une seule fois, applique la politique décrite ci‑dessous, et rouvre la présentation enregistrée pour vérifier les actions de clic et de survol.
Le rapport enregistre un index de diapositive à base 1 et getSlideId lorsqu’il est disponible. getSlide fournit la diapositive propriétaire pour les conteneurs pris en charge. Les maîtres, dispositions et notes n’ont pas d’index de diapositive ordinaire et sont identifiés par leur portée. Les conteneurs de forme et les conteneurs de format de portion de texte sont étiquetés séparément ; les autres types de conteneurs conservent leur nom de type d’exécution. Chaque conteneur reçoit un ID local au rapport afin que ses deux actions puissent être corrélées. Le rapport stocke les types d’action sous forme de constantes entières définies par l’énumération Java.
Cette politique d’application délibérément restrictive n’autorise que les URL HTTPS absolues et les cibles de diapositive internes valides. Elle rejette les macros, programmes, actions de fichiers, autres actions de diaporama, actions inconnues et autres schémas d’URL. Ces rejets sont des décisions de politique, pas un verdict de sécurité d’Aspose.Slides. HTTPS seul n’établit pas la confiance : ajoutez des listes blanches d’hôtes et d’autres vérifications pour votre application. Les URL externes originales et normalisées sont toutes deux vérifiées. L’exemple audite les métadonnées sans suivre les liens ni exécuter les actions.
Pour la remédiation, le getHyperlinkManager du conteneur prend en charge setExternalHyperlinkClick, removeHyperlinkClick et removeHyperlinkMouseOver. Ici, les liens externes de clic interdits sont remplacés par une page d’atterrissage HTTPS fixe ; les autres clics interdits et les actions de survol interdites sont supprimés indépendamment. Réglez replace_external_clicks sur False pour supprimer toutes les violations de politique. Choisissez une page de remplacement appartenant à l’application avant le déploiement.
Le drapeau d’exportation du rapport utilise une politique de révision PDF conservatrice : signalez les actions de survol et tout ce qui n’est pas un lien externe ou un saut de diapositive spécifique comme potentiellement non pris en charge. Il s’agit d’une indication de révision, pas d’un test de capacité ou d’une garantie que les liens non signalés survivront à l’exportation. Les exportations PDF et HTML prises en charge (PDF, HTML) peuvent préserver les hyperliens, selon l’action, les options d’exportation et le lecteur. Les images raster et les vidéos ne peuvent pas conserver les hyperliens interactifs ; signalez chaque action lors de l’audit pour ces sorties.
import json
from pathlib import Path
from urllib.parse import urlsplit
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HyperlinkActionType, PortionFormat, Presentation, SaveFormat, Shape
IdentityHashMap = jpype.JClass("java.util.IdentityHashMap")
def slide_index(presentation, slide):
for index, candidate in enumerate(presentation.getSlides(), start=1):
if candidate == slide:
return index
return None
def is_https(value):
if not value:
return False
value = str(value)
if any(character.isspace() or ord(character) < 32 for character in value):
return False
try:
uri = urlsplit(value)
return uri.scheme.lower() == "https" and bool(uri.hostname)
except ValueError:
return False
def policy_violation(link):
if link is None:
return None
if link.getActionType() == HyperlinkActionType.JumpSpecificSlide:
return "Missing target slide" if link.getTargetSlide() is None else None
if link.getActionType() != HyperlinkActionType.Hyperlink:
return "Action is not allowed"
if not is_https(link.getExternalUrl()):
return "Normalized URL is not absolute HTTPS"
original = link.getExternalUrlOriginal()
if original and not is_https(original):
return "Original URL is not absolute HTTPS"
return None
def collect_containers(presentation):
found = list(presentation.getHyperlinkQueries().getAnyHyperlinks())
scopes = list(presentation.getMasters()) + list(presentation.getLayoutSlides())
for slide in presentation.getSlides():
scopes.append(slide.getNotesSlideManager().getNotesSlide())
scopes.append(presentation.getMasterNotesSlideManager().getMasterNotesSlide())
scopes.append(presentation.getMasterHandoutSlideManager().getMasterHandoutSlide())
for scope in scopes:
if scope is not None:
found.extend(scope.getHyperlinkQueries().getAnyHyperlinks())
seen = IdentityHashMap()
unique = []
for container in found:
if not seen.containsKey(container):
seen.put(container, True)
unique.append(container)
return unique
def text_or_none(value):
return str(value) if value is not None else None
def add_row(rows, presentation, link, activation, container, container_id):
if link is None:
return
owner_slide = container.getSlide() if hasattr(container, "getSlide") else None
target_slide = link.getTargetSlide()
violation = policy_violation(link)
if isinstance(container, Shape):
owner_type = "Shape"
elif isinstance(container, PortionFormat):
owner_type = "Text portion"
else:
owner_type = str(container.getClass().getSimpleName())
ordinary_action = link.getActionType() in (HyperlinkActionType.Hyperlink, HyperlinkActionType.JumpSpecificSlide)
original = link.getExternalUrlOriginal()
rows.append({
"ContainerId": container_id,
"SlideIndex": slide_index(presentation, owner_slide),
"SlideId": int(owner_slide.getSlideId()) if owner_slide is not None else None,
"Scope": str(owner_slide.getClass().getSimpleName()) if owner_slide is not None else None,
"OwnerType": owner_type,
"Activation": activation,
"ActionType": int(link.getActionType()),
"ExternalUrl": text_or_none(link.getExternalUrl()),
"TargetSlideIndex": slide_index(presentation, target_slide),
"TargetSlideId": int(target_slide.getSlideId()) if target_slide is not None else None,
"Tooltip": text_or_none(link.getTooltip()),
"OriginalExternalUrl": text_or_none(original) if original != link.getExternalUrl() else None,
"PotentiallyUnsafe": violation is not None,
"PolicyViolation": violation,
"TargetExport": "PDF",
"PotentiallyUnsupportedByExport": activation == "mouse-over" or not ordinary_action,
})
replace_external_clicks = True
replacement_url = "https://example.com/blocked-link"
presentation = Presentation("hyperlink-audit-input.pptx")
try:
containers = collect_containers(presentation)
rows = []
for container_id, container in enumerate(containers, start=1):
add_row(rows, presentation, container.getHyperlinkClick(), "click", container, container_id)
add_row(rows, presentation, container.getHyperlinkMouseOver(), "mouse-over", container, container_id)
report = json.dumps(rows, indent=2)
Path("hyperlink-audit.json").write_text(report, encoding="utf-8")
for container in containers:
click = container.getHyperlinkClick()
if policy_violation(click) is not None:
if replace_external_clicks and click.getActionType() == HyperlinkActionType.Hyperlink:
container.getHyperlinkManager().setExternalHyperlinkClick(replacement_url)
else:
container.getHyperlinkManager().removeHyperlinkClick()
if policy_violation(container.getHyperlinkMouseOver()) is not None:
container.getHyperlinkManager().removeHyperlinkMouseOver()
presentation.save("hyperlink-sanitized.pptx", SaveFormat.Pptx)
reopened = Presentation("hyperlink-sanitized.pptx")
try:
remaining_containers = collect_containers(reopened)
violations = 0
for container in remaining_containers:
if policy_violation(container.getHyperlinkClick()) is not None:
violations += 1
if policy_violation(container.getHyperlinkMouseOver()) is not None:
violations += 1
print(f"Audit rows: {len(rows)}; prohibited actions after reopening: {violations}")
if violations != 0:
print("Verification failed: do not distribute the saved presentation.")
finally:
reopened.dispose()
except OSError as exception:
print(f"Unable to write the audit report: {exception}")
finally:
presentation.dispose()
Avec l’entrée créée ci‑dessus, le rapport contient cinq lignes d’action. Le lien de survol de fichier et le clic de macro sont supprimés, tandis que les liens HTTPS et la navigation interne de diapositive restent. La vérification indique zéro action interdite. Une entrée contenant une URL de clic externe interdite active également la branche de remplacement. Un conteneur avec un clic autorisé et un survol interdit conserve son action de clic.
Ce nettoyage sélectif diffère de removeAllHyperlinks, qui supprime les deux types d’activation dans toute la portée sélectionnée, quel que soit la politique. La vérification ici ne contrôle que les actions d’hyperlien ; elle ne supprime pas les projets VBA intégrés, les objets OLE ou d’autres contenus actifs, et ne valide pas un fichier PDF ou HTML exporté.
FAQ
Comment puis‑je créer un lien vers une section ou sa première diapositive ?
Les sections dans PowerPoint regroupent les diapositives, mais un hyperlien interne vise une diapositive individuelle. Pour créer une navigation vers une section, liez‑vous à la première diapositive de cette section.
Puis‑je attacher un hyperlien aux éléments de la diapositive maître afin qu’il fonctionne sur toutes les diapositives ?
Oui. Les éléments de la diapositive maître et des dispositions prennent en charge les hyperliens. Les liens sur ces éléments sont disponibles pendant le diaporama sur les diapositives qui utilisent le maître ou la disposition correspondante.
Les hyperliens seront‑ils conservés lors de l’exportation vers PDF, HTML, images ou vidéo ?
Les exportations PDF et HTML prises en charge peuvent conserver les hyperliens ; les images raster et la vidéo ne le peuvent pas. Consultez les considérations d’exportation dans Rapport, assainir et vérifier les hyperliens.