在 PHP 中管理演示文稿超链接

本页内容简介

使用 Aspose.Slides for PHP via Java，通过 PHP 示例在 PowerPoint 和 OpenDocument 演示文稿中添加、格式化、更新和删除超链接。

介绍

超链接将演示文稿内容连接到网站或演示文稿中的位置。在 PowerPoint 中，超链接通常有两种用途：

从文本、形状或媒体框打开网站。
导航到另一张幻灯片，例如，从目录中跳转。

Aspose.Slides for PHP via Java 允许您添加这些链接，控制其外观和声音，更新其属性并将其删除。下面的示例展示了如何在单个元素上使用超链接以及如何在演示文稿、幻灯片或文本框级别访问超链接。示例假设已初始化 PHP/Java Bridge 和 Aspose.Slides PHP 包装器。没有 PHP 参考页面链接的 API 成员将链接到底层的 Java API。

Note

您还可以使用免费在线 Aspose PowerPoint 编辑器编辑演示文稿。

添加 URL 超链接

您可以将网站 URL 分配给文本、形状或媒体框。分配超链接的元素决定了可点击的区域：文本段落链接所选文本，而形状或框则链接整个幻灯片对象。对于包含相对超链接的演示文稿，请参阅管理超链接基址以读取、更改或清除文档级别的基址。

向文本添加 URL 超链接

要将文本链接到网站，请将Hyperlink传递给文本段落的setHyperlinkClick方法，如下所示。只有该段文本会变为可点击。

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $textShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50, false);
    $textShape->addTextFrame("Aspose: File Format APIs");
    $portionFormat = $textShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $portionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $portionFormat->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
    $portionFormat->setFontHeight(32);

    $presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

向形状和媒体框添加 URL 超链接

要使形状或框可点击，请调用其setHyperlinkClick方法。超链接属于对象本身，而不是其内部的文本段落。相同的方法适用于图片、音频和视频框：将超链接分配给框并在需要时调用setTooltip。下面的示例使一个矩形可点击：

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50);

    $shape->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $shape->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");

    $presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

使用超链接创建目录

内部超链接允许读者从目录跳转到特定幻灯片。下面的示例使用setInternalHyperlinkClick将第一张幻灯片上的“Page 2”文本链接到第二张幻灯片。

use aspose\slides\FillType;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $firstSlide = $presentation->getSlides()->get_Item(0);
    $secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());

    $tableOfContents = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 40, 40, 300, 100);
    $tableOfContents->getFillFormat()->setFillType(FillType::NoFill);
    $tableOfContents->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
    $tableOfContents->getTextFrame()->getParagraphs()->clear();

    $paragraph = new Paragraph();
    $paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $paragraph->setText("Title of slide 2 .......... ");

    $linkPortion = new Portion();
    $linkPortion->setText("Page 2");
    $linkPortion->getPortionFormat()->getHyperlinkManager()->setInternalHyperlinkClick($secondSlide);

    $paragraph->getPortions()->add($linkPortion);
    $tableOfContents->getTextFrame()->getParagraphs()->add($paragraph);

    $presentation->save("link_to_slide.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

格式化超链接

颜色

setColorSource 方法用于 Hyperlink 来确定超链接是使用演示文稿的超链接颜色还是文本段的格式。要应用自定义文本颜色，请选择HyperlinkColorSource::PortionFormat并设置段的填充颜色。此功能在 PowerPoint 2019 中引入；较早的版本不支持此设置。下面的示例向同一张幻灯片添加两个文本超链接。第一个使用红色文本填充，而第二个保留默认的超链接颜色。

use aspose\slides\FillType;
use aspose\slides\Hyperlink;
use aspose\slides\HyperlinkColorSource;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $coloredShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 450, 50, false);
    $coloredShape->addTextFrame("This hyperlink uses a custom color.");
    $coloredPortionFormat = $coloredShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $coloredPortionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
    $coloredPortionFormat->getHyperlinkClick()->setColorSource(HyperlinkColorSource::PortionFormat);
    $coloredPortionFormat->getFillFormat()->setFillType(FillType::Solid);
    $coloredPortionFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);

    $defaultShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 450, 50, false);
    $defaultShape->addTextFrame("This hyperlink uses the default color.");
    $defaultShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));

    $presentation->save("presentation-out-hyperlink.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

声音

超链接在激活时可以播放声音，或停止已经播放的声音。使用以下方法来配置这些行为：

Hyperlink::setSound 指定与超链接关联的音频。
Hyperlink::setStopSoundOnClick 控制激活超链接时是否停止先前的声音。

添加超链接声音

下面的示例加载 sampleaudio.wav 并将其关联到第一张幻灯片上的按钮。单击按钮会播放声音并跳转到下一张幻灯片。该幻灯片上的第二个形状在单击时会停止先前的声音，但不执行导航操作。

use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $audioFile = new Java("java.io.File", "sampleaudio.wav");
    $audioPath = $audioFile->toPath();
    $audioData = java("java.nio.file.Files")->readAllBytes($audioPath);
    $hyperlinkSound = $presentation->getAudios()->addAudio($audioData);

    $firstSlide = $presentation->getSlides()->get_Item(0);

    $playButton = $firstSlide->getShapes()->addAutoShape(ShapeType::SoundButton, 100, 100, 100, 50);
    $playButton->setHyperlinkClick(Hyperlink::getNextSlide());

    if (!java_values($playButton->getHyperlinkClick()->getStopSoundOnClick()) && java_is_null($playButton->getHyperlinkClick()->getSound()))
    {
        $playButton->getHyperlinkClick()->setSound($hyperlinkSound);
    }

    $secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());

    $stopButton = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 100, 50);
    $stopButton->setHyperlinkClick(Hyperlink::getNoAction());

    $stopButton->getHyperlinkClick()->setStopSoundOnClick(true);

    $presentation->save("hyperlink-sound.pptx", SaveFormat::Pptx);
} catch (JavaException $exception) {
    echo "Unable to read the audio file: " . $exception->getMessage() . PHP_EOL;
} finally {
    $presentation->dispose();
}

提取超链接声音

下面的示例打开上述创建的演示文稿，并通过 getSound 和 getBinaryData 将第一个形状的超链接音频读取到内存中。

use aspose\slides\Presentation;

$presentation = new Presentation("hyperlink-sound.pptx");
try {
    if (java_values($presentation->getSlides()->size()) > 0 && java_values($presentation->getSlides()->get_Item(0)->getShapes()->size()) > 0) {
        $hyperlink = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getHyperlinkClick();
        $sound = java_is_null($hyperlink) ? null : $hyperlink->getSound();
        if (!java_is_null($sound)) {
            $audioData = $sound->getBinaryData();
            echo "Extracted " . strlen(java_values($audioData)) . " bytes of hyperlink audio." . PHP_EOL;
        } else {
            echo "The first shape has no hyperlink sound." . PHP_EOL;
        }
    } else {
        echo "The presentation has no first slide or shape to inspect." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

工具提示和交互设置

在为文本或形状分配超链接后，您可以调用以下 Hyperlink 方法：

setTooltip 设置观众可以显示为链接提示的文本。
setTargetFrame 指定父 HTML 框架集中（如适用）的目标框架。
setHistory 控制激活链接时是否将其目标添加到已查看超链接列表中。
setHighlightClick 控制点击时是否突出显示超链接。

从演示文稿中删除超链接

使用 getAnyHyperlinks 在更改之前收集超链接容器，包括文本段链接。下面的示例从第一张幻灯片中删除两种激活类型。若只想删除一种类型，只调用 removeHyperlinkClick 或 removeHyperlinkMouseOver；删除点击操作并不会删除其鼠标悬停对应操作。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("pres.pptx");
try {
    if (java_values($presentation->getSlides()->size()) > 0) {
        $containers = [];
        foreach ($presentation->getSlides()->get_Item(0)->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
            $containers[] = $container;
        }
        foreach ($containers as $container) {
            $container->getHyperlinkManager()->removeHyperlinkClick();
            $container->getHyperlinkManager()->removeHyperlinkMouseOver();
        }
        $presentation->save("pres-removed-hyperlinks.pptx", SaveFormat::Pptx);
    } else {
        echo "The presentation has no slides to process." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

若要无条件删除，使用 removeAllHyperlinks 可在一次调用中删除选定范围内的两种激活类型。有关选择性清理以及对母版、布局和备注的覆盖，请参阅报告、清理和验证超链接。

构建完整的超链接清单

在分发演示文稿之前，需清点其中的交互操作及网络链接。getAnyHyperlinks 返回 IHyperlinkContainer 对象，而不是 URL 字符串的平面列表。检查每个容器的 getHyperlinkClick 和 getHyperlinkMouseOver。它们相互独立：同一容器可以同时暴露两种操作，因此完整报告每个容器可能需要最多两行。仅扫描形状级别的超链接可能会漏掉附加在文本段的链接。应查询相应的范围，并保留返回的容器，以便稍后更新或删除其操作。

查询演示文稿、幻灯片和文本框范围

HyperlinkQueries 类可通过 Presentation::getHyperlinkQueries、IBaseSlide::getHyperlinkQueries 和 TextFrame::getHyperlinkQueries 使用。每个范围支持相同的查询：

getHyperlinkClicks 返回具有点击操作的容器。
getHyperlinkMouseOvers 返回具有鼠标悬停操作的容器。
getAnyHyperlinks 返回包含任一或两种操作的容器。

下面的示例创建了 hyperlink-audit-input.pptx，其中包含外部点击链接、文件鼠标悬停链接、内部幻灯片导航、文本鼠标悬停链接以及宏操作。它不会执行这些操作。相同的三个查询在每个范围内都可使用；计数描述的是容器数量，而非操作总数。文本框范围排除包含形状本身的链接。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

function printQueryCounts($scope, $queries) {
    $clickCount = java_values($queries->getHyperlinkClicks()->size());
    $mouseOverCount = java_values($queries->getHyperlinkMouseOvers()->size());
    $anyCount = java_values($queries->getAnyHyperlinks()->size());
    echo "$scope: click=$clickCount, mouse-over=$mouseOverCount, any=$anyCount" . PHP_EOL;
}

$presentation = new 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");

    $portionFormat = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
    $portionFormat->getHyperlinkManager()->setInternalHyperlinkClick($destination);
    $portionFormat->getHyperlinkManager()->setExternalHyperlinkMouseOver("https://example.com/help");
    $macroButton = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 120, 200, 60);
    $macroButton->getHyperlinkManager()->setMacroHyperlinkClick("ReviewPresentation");

    printQueryCounts("Presentation", $presentation->getHyperlinkQueries());
    printQueryCounts("Slide 1", $slide->getHyperlinkQueries());
    printQueryCounts("Text frame", $shape->getTextFrame()->getHyperlinkQueries());
    $presentation->save("hyperlink-audit-input.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

在本例中，演示文稿和幻灯片查询各报告三个点击容器、两个鼠标悬停容器以及三个任一操作的容器。文本框查询在每个类别中报告一个容器。

分类操作和目标

使用 Hyperlink::getActionType 在解释目标之前解释操作。HyperlinkActionType 的值涵盖了不仅仅是网页导航的情况：

值	审计意义
`Hyperlink`	外部超链接；检查 URL 及其协议。
`JumpSpecificSlide`	内部导航至特定幻灯片。
`JumpFirstSlide`, `JumpPreviousSlide`, `JumpNextSlide`, `JumpLastSlide`, `JumpLastViewedSlide`	内建幻灯片放映导航，在放映上下文中解析。
`JumpEndShow`, `StartCustomSlideShow`	结束当前放映或启动自定义放映。
`StartMacro`	执行宏。
`StartProgram`	启动程序。
`OpenFile`, `OpenPresentation`	打开文件或另一个演示文稿；需单独于网页 URL 审核。
`StartStopMedia`	开始或停止媒体播放。
`NoAction`, `Unknown`	无导航操作，或需审核的未识别操作。

从 getExternalUrl 读取外部目标，从 getTargetSlide 读取特定内部目标。内部操作和内建命令可能没有外部 URL；空 URL 并不表示容器没有操作。当返回的值与归一化 URL 不同时，请保留 getExternalUrlOriginal 的返回值，并在可用时包含 getTooltip 返回的工具提示。

报告、清理和验证超链接

下面的 PHP 示例读取现有演示文稿（使用上面创建的文件），写入 hyperlink-audit.json，应用策略，保存为 hyperlink-sanitized.pptx，并重新打开以再次检查两种激活类型。它在更改前收集容器，并使用引用相等性避免对同一容器进行两次处理。演示文稿查询覆盖普通幻灯片；若要进行全包清点，还会显式查询母版、布局、备注以及存在的备注和讲义母版。报告记录基于 1 的幻灯片索引和 getSlideId（如可用）。ISlideComponent::getSlide 为支持的容器提供所属幻灯片。母版、布局和备注没有普通幻灯片索引，使用其范围进行标识。形状容器和文本段格式容器分别标记；其他容器类型保留其运行时类型名称。每个容器获得报告本地 ID，以便关联其两个操作。报告将操作类型存储为 PHP 枚举定义的整数常量。此有意严格的应用策略仅允许绝对 HTTPS URL 和有效的内部幻灯片目标。它会拒绝宏、程序、文件操作、其他幻灯片操作、未知操作以及其他 URL 方案。此类拒绝是策略决定，而非 Aspose.Slides 的安全判定。仅有 HTTPS 并不能建立信任：请为您的应用添加主机白名单和其他检查。会检查原始和归一化的外部 URL。示例仅审计元数据，不会跟随链接或执行操作。若需修复，容器的 getHyperlinkManager 支持 setExternalHyperlinkClick、removeHyperlinkClick 和 removeHyperlinkMouseOver 。在此示例中，受禁止的外部点击链接被替换为固定的 HTTPS 登陆页面；其他受禁止的点击和受禁止的鼠标悬停操作则分别被删除。将 $replaceExternalClicks 设置为 false 可改为删除所有策略违规。请在部署前选择应用拥有的替代页面。报告的导出标记使用保守的 PDF 审核策略：将鼠标悬停操作以及除外部链接或特定幻灯片跳转之外的所有内容标记为可能不受支持。这仅是审查提示，而非功能测试，也不保证未标记的链接在导出后仍然有效。受支持的PDF 和 HTML 导出可能保留超链接，具体取决于操作、导出选项和查看器。光栅图像和视频无法保留交互式超链接；在针对这些输出进行审计时请标记每个操作。

use aspose\slides\HyperlinkActionType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

class HyperlinkAudit {
    public function slideIndex($presentation, $slide) {
        if (java_is_null($slide)) return null;
        for ($index = 0; $index < java_values($presentation->getSlides()->size()); $index++) {
            if (java_values($presentation->getSlides()->get_Item($index)->equals($slide))) return $index + 1;
        }
        return null;
    }

    public function isHttps($value) {
        if ($value === null || $value === '') return false;
        $parts = parse_url($value);
        return $parts !== false && isset($parts['scheme'], $parts['host']) && strcasecmp($parts['scheme'], 'https') === 0 && $parts['host'] !== '';
    }

    public function policyViolation($link) {
        if (java_is_null($link)) return null;
        $action = java_values($link->getActionType());
        if ($action === HyperlinkActionType::JumpSpecificSlide) {
            return java_is_null($link->getTargetSlide()) ? 'Missing target slide' : null;
        }
        if ($action !== HyperlinkActionType::Hyperlink) return 'Action is not allowed';
        if (!$this->isHttps(java_values($link->getExternalUrl()))) return 'Normalized URL is not absolute HTTPS';
        $original = java_values($link->getExternalUrlOriginal());
        if ($original !== null && $original !== '' && !$this->isHttps($original)) return 'Original URL is not absolute HTTPS';
        return null;
    }

    public function addScope(&$found, $slide) {
        if (!java_is_null($slide)) {
            foreach ($slide->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
                $found[] = $container;
            }
        }
    }

    public function collectContainers($presentation) {
        $found = [];
        foreach ($presentation->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
            $found[] = $container;
        }
        $masters = $presentation->getMasters();
        for ($index = 0; $index < java_values($masters->size()); $index++) {
            $this->addScope($found, $masters->get_Item($index));
        }
        $layouts = $presentation->getLayoutSlides();
        for ($index = 0; $index < java_values($layouts->size()); $index++) {
            $this->addScope($found, $layouts->get_Item($index));
        }
        $slides = $presentation->getSlides();
        for ($index = 0; $index < java_values($slides->size()); $index++) {
            $this->addScope($found, $slides->get_Item($index)->getNotesSlideManager()->getNotesSlide());
        }
        $this->addScope($found, $presentation->getMasterNotesSlideManager()->getMasterNotesSlide());
        $this->addScope($found, $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide());
        $seen = new Java('java.util.IdentityHashMap');
        $unique = [];
        foreach ($found as $container) {
            if (!java_values($seen->containsKey($container))) {
                $seen->put($container, true);
                $unique[] = $container;
            }
        }
        return $unique;
    }

    public function addRow(&$rows, $presentation, $link, $activation, $container, $containerId) {
        if (java_is_null($link)) return;
        $ownerSlide = java_instanceof($container, java('com.aspose.slides.ISlideComponent')) ? $container->getSlide() : null;
        $targetSlide = $link->getTargetSlide();
        $violation = $this->policyViolation($link);
        $ownerType = java_instanceof($container, java('com.aspose.slides.IShape')) ? 'Shape' : (java_instanceof($container, java('com.aspose.slides.IPortionFormat')) ? 'Text portion' : java_values($container->getClass()->getSimpleName()));
        $action = java_values($link->getActionType());
        $ordinaryAction = $action === HyperlinkActionType::Hyperlink || $action === HyperlinkActionType::JumpSpecificSlide;
        $externalUrl = java_values($link->getExternalUrl());
        $originalUrl = java_values($link->getExternalUrlOriginal());
        $rows[] = [
            'ContainerId' => $containerId,
            'SlideIndex' => $this->slideIndex($presentation, $ownerSlide),
            'SlideId' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getSlideId()),
            'Scope' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getClass()->getSimpleName()),
            'OwnerType' => $ownerType,
            'Activation' => $activation,
            'ActionType' => $action,
            'ExternalUrl' => $externalUrl,
            'TargetSlideIndex' => $this->slideIndex($presentation, $targetSlide),
            'TargetSlideId' => java_is_null($targetSlide) ? null : java_values($targetSlide->getSlideId()),
            'Tooltip' => java_values($link->getTooltip()),
            'OriginalExternalUrl' => $originalUrl === $externalUrl ? null : $originalUrl,
            'PotentiallyUnsafe' => $violation !== null,
            'PolicyViolation' => $violation,
            'TargetExport' => 'PDF',
            'PotentiallyUnsupportedByExport' => $activation === 'mouse-over' || !$ordinaryAction
        ];
    }
}

$replaceExternalClicks = true;
$replacementUrl = 'https://example.com/blocked-link';
$audit = new HyperlinkAudit();
$presentation = new Presentation('hyperlink-audit-input.pptx');
try {
    $containers = $audit->collectContainers($presentation);
    $rows = [];
    foreach ($containers as $index => $container) {
        $audit->addRow($rows, $presentation, $container->getHyperlinkClick(), 'click', $container, $index + 1);
        $audit->addRow($rows, $presentation, $container->getHyperlinkMouseOver(), 'mouse-over', $container, $index + 1);
    }
    $json = json_encode($rows, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
    if ($json === false) {
        echo 'Unable to encode the audit report: ' . json_last_error_msg() . PHP_EOL;
    } elseif (file_put_contents('hyperlink-audit.json', $json . PHP_EOL) === false) {
        echo 'Unable to write the audit report.' . PHP_EOL;
    } else {
        foreach ($containers as $container) {
            $click = $container->getHyperlinkClick();
            if ($audit->policyViolation($click) !== null) {
                if ($replaceExternalClicks && java_values($click->getActionType()) === HyperlinkActionType::Hyperlink) {
                    $container->getHyperlinkManager()->setExternalHyperlinkClick($replacementUrl);
                } else {
                    $container->getHyperlinkManager()->removeHyperlinkClick();
                }
            }
            if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) {
                $container->getHyperlinkManager()->removeHyperlinkMouseOver();
            }
        }
        $presentation->save('hyperlink-sanitized.pptx', SaveFormat::Pptx);

        $reopened = new Presentation('hyperlink-sanitized.pptx');
        try {
            $remainingContainers = $audit->collectContainers($reopened);
            $violations = 0;
            foreach ($remainingContainers as $container) {
                if ($audit->policyViolation($container->getHyperlinkClick()) !== null) $violations++;
                if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) $violations++;
            }
            echo 'Audit rows: ' . count($rows) . '; prohibited actions after reopening: ' . $violations . PHP_EOL;
            if ($violations !== 0) {
                echo 'Verification failed: do not distribute the saved presentation.' . PHP_EOL;
            }
        } finally {
            $reopened->dispose();
        }
    }
} finally {
    $presentation->dispose();
}

使用上述创建的输入，报告包含五行操作。文件鼠标悬停链接和宏点击被删除，而 HTTPS 链接和内部幻灯片导航保留。验证结果显示零个受禁止的操作。包含受禁止外部点击 URL 的输入也会触发替换分支。具有允许的点击和受禁止的鼠标悬停的容器保留其点击操作。此选择性清理不同于 removeAllHyperlinks，后者会在选定范围内无论策略如何都删除两种激活类型。此处的验证仅检查超链接操作；不会删除嵌入的 VBA 项目、OLE 对象或其他活动内容，也不会校验导出的 PDF 或 HTML 文件。

常见问题

如何链接到章节或其第一张幻灯片？

PowerPoint 中的章节用于对幻灯片进行分组，但内部超链接针对的是单个幻灯片。若要实现对章节的导航，请链接到该章节的第一张幻灯片。

是否可以将超链接附加到母版幻灯片元素，以便在所有幻灯片上生效？

可以。母版幻灯片和布局元素支持超链接。使用相应母版或布局的幻灯片在放映时可以使用这些元素上的链接。

导出为 PDF、HTML、图像或视频时，超链接会被保留吗？

受支持的 PDF 和 HTML 导出可能保留超链接；光栅图像和视频则无法保留。请参阅报告、清理和验证超链接中的导出注意事项。

在 PHP 中管理演示文稿 BLOB 以实现高效内存使用管理媒体文件