在 JavaScript 中管理簡報超連結

本頁內容簡介

使用 Aspose.Slides for Node.js via Java，以 JavaScript 範例在 PowerPoint 與 OpenDocument 簡報中新增、格式化、更新與移除超連結。

簡介

超連結將簡報內容連接到網站或簡報內的某個位置。在 PowerPoint 中，超連結通常有兩個用途：

由文字、形狀或媒體框架開啟網站。
從目錄等處跳轉至另一張投影片。

Aspose.Slides for Node.js via Java 讓您能新增這些連結、控制其外觀與音效、更新其屬性，並將其移除。以下範例說明如何在個別元素上操作超連結，以及如何在簡報、投影片或文字框層級存取超連結。

注意

您也可以使用免費線上 Aspose PowerPoint 編輯器編輯簡報。

新增 URL 超連結

您可以將網站 URL 指派給文字、形狀或媒體框架。指派超連結的元素決定可點擊的區域：文字部分會連結所選文字，而形狀或框架則連結投影片物件本身。

將 URL 超連結加入文字

要將文字連結到網站，請將超連結傳遞給文字部分的setHyperlinkClick方法，如下所示。只有該文字部分會變成可點擊。

const aspose = { slides: require("aspose.slides.via.java") };

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

    presentation.save("presentation-out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

將 URL 超連結加入形狀和媒體框架

若要讓形狀或框架可點擊，請呼叫其setHyperlinkClick方法。超連結屬於該物件本身，而不是屬於其中的文字部分。

相同的做法也適用於圖片、音訊和影片框架：將超連結指派給框架並在需要時呼叫setTooltip。

以下範例會使矩形可點擊：

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 600, 50);

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

    presentation.save("presentation-out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

使用超連結建立目錄

內部超連結讓讀者能從目錄跳至特定投影片。以下範例使用setInternalHyperlinkClick將第一張投影片上的「Page 2」文字連結至第二張投影片。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const firstSlide = presentation.getSlides().get_Item(0);
    const secondSlide = presentation.getSlides().addEmptySlide(firstSlide.getLayoutSlide());

    const tableOfContents = firstSlide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 40, 40, 300, 100);
    tableOfContents.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    tableOfContents.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    tableOfContents.getTextFrame().getParagraphs().clear();

    const paragraph = new aspose.slides.Paragraph();
    paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    paragraph.setText("Title of slide 2 .......... ");

    const linkPortion = new aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

設定超連結格式

顏色

setColorSource 方法屬於Hyperlink，用以決定超連結是使用簡報的超連結顏色，還是使用文字部分的格式。若要套用自訂文字顏色，請選取HyperlinkColorSource.PortionFormat並設定該部分的填充顏色。此功能於 PowerPoint 2019 中首次推出；舊版不會套用此設定。

以下範例在同一張投影片上新增兩個文字超連結。第一個使用紅色文字填充，而第二個保留預設的超連結顏色。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

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

    const defaultShape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.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 aspose.slides.Hyperlink("https://www.aspose.com/"));

    presentation.save("presentation-out-hyperlink.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

音效

超連結在被觸發時可以播放音效，或停止已在播放的音效。使用以下方法設定這些行為：

Hyperlink.setSound 指定與超連結關聯的音訊。
Hyperlink.setStopSoundOnClick 控制在觸發超連結時是否停止先前的音效。

新增超連結音效

以下範例載入 sampleaudio.wav，並將其關聯至第一張投影片上的按鈕。點擊按鈕會播放音效並跳轉至下一張投影片。該投影片上的第二個形狀在點擊時會停止先前的音效，且不執行任何導向動作。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const audioStream = java.newInstanceSync("java.io.FileInputStream", "sampleaudio.wav");
    let hyperlinkSound;
    try {
        hyperlinkSound = presentation.getAudios().addAudio(audioStream);
    } finally {
        audioStream.close();
    }

    const firstSlide = presentation.getSlides().get_Item(0);

    const playButton = firstSlide.getShapes().addAutoShape(aspose.slides.ShapeType.SoundButton, 100, 100, 100, 50);
    playButton.setHyperlinkClick(aspose.slides.Hyperlink.getNextSlide());

    if (!playButton.getHyperlinkClick().getStopSoundOnClick() && playButton.getHyperlinkClick().getSound() == null)
    {
        playButton.getHyperlinkClick().setSound(hyperlinkSound);
    }

    const secondSlide = presentation.getSlides().addEmptySlide(firstSlide.getLayoutSlide());

    const stopButton = secondSlide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 100, 50);
    stopButton.setHyperlinkClick(aspose.slides.Hyperlink.getNoAction());

    stopButton.getHyperlinkClick().setStopSoundOnClick(true);

    presentation.save("hyperlink-sound.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

擷取超連結音效

以下範例開啟上述建立的簡報，並透過 getSound 與 getBinaryData 讀取第一個形狀的超連結音訊至記憶體。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("hyperlink-sound.pptx");
try {
    if (presentation.getSlides().size() > 0 && presentation.getSlides().get_Item(0).getShapes().size() > 0) {
        const hyperlink = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getHyperlinkClick();
        const sound = hyperlink == null ? null : hyperlink.getSound();
        if (sound != null) {
            const audioData = sound.getBinaryData();
            console.log("Extracted " + audioData.length + " bytes of hyperlink audio.");
        } else {
            console.log("The first shape has no hyperlink sound.");
        }
    } else {
        console.log("The presentation has no first slide or shape to inspect.");
    }
} finally {
    presentation.dispose();
}

工具提示與互動設定

在將超連結指派給文字或形狀後，您可以呼叫以下 Hyperlink 方法：

setTooltip 設定觀眾可顯示的提示文字。
setTargetFrame（在適用時）指定父 HTML frameset 中的目標框架。
setHistory 控制在觸發連結時是否將其目的地加入已檢視的超連結清單。
setHighlightClick 控制點擊時是否將超連結標示為高亮。

從簡報中移除超連結

在變更之前，使用 getAnyHyperlinks 收集超連結容器（包括文字部分連結）。以下範例會從第一張投影片中移除兩種啟動方式。若只想移除單一類型，僅呼叫 removeHyperlinkClick 或 removeHyperlinkMouseOver；移除點擊動作不會移除其滑鼠懸停對應項。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    if (presentation.getSlides().size() > 0) {
        const found = presentation.getSlides().get_Item(0).getHyperlinkQueries().getAnyHyperlinks();
        const containers = [];
        for (let index = 0; index < found.size(); index++) {
            containers.push(found.get_Item(index));
        }
        for (const container of containers) {
            container.getHyperlinkManager().removeHyperlinkClick();
            container.getHyperlinkManager().removeHyperlinkMouseOver();
        }
        presentation.save("pres-removed-hyperlinks.pptx", aspose.slides.SaveFormat.Pptx);
    } else {
        console.log("The presentation has no slides to process.");
    }
} finally {
    presentation.dispose();
}

若需無條件移除，可使用 removeAllHyperlinks 在一次呼叫中移除選取範圍內的兩種啟動方式。若要進行選擇性清理並涵蓋母片、版面配置與備註，請參閱報告、清理與驗證超連結。

建立完整的超連結清單

在發佈簡報之前，請匯總其互動動作與網路連結。getAnyHyperlinks 會回傳超連結容器，而非純 URL 字串的平面清單。請檢查每個容器的 getHyperlinkClick 與 getHyperlinkMouseOver，它們是獨立的：同一容器可能同時具備兩種動作，因此完整報告每個容器最多需要兩列。

僅掃描形狀層級的超連結可能會遺漏附加於文字部分的連結。請改為查詢適當的範圍，並保留回傳的容器，以便日後更新或移除其動作。

查詢簡報、投影片與文字框範圍

HyperlinkQueries 類別可透過 Presentation.getHyperlinkQueries、BaseSlide.getHyperlinkQueries 以及 TextFrame.getHyperlinkQueries 取得。每個範圍支援相同的查詢：

getHyperlinkClicks 回傳具有點擊動作的容器。
getHyperlinkMouseOvers 回傳具有滑鼠懸停動作的容器。
getAnyHyperlinks 回傳包含任一或兩種動作的容器。

以下範例建立 hyperlink-audit-input.pptx，其中包含外部點擊連結、檔案滑鼠懸停連結、內部投影片導覽、文字滑鼠懸停連結以及巨集動作。此範例不會執行任何動作。相同的三種查詢在每個範圍皆可使用；計數描述的是容器數量，而非動作總數。文字框範圍會排除其所屬形狀自身的連結。

const aspose = { slides: require("aspose.slides.via.java") };

function printQueryCounts(scope, queries) {
const clickCount = queries.getHyperlinkClicks().size();
const mouseOverCount = queries.getHyperlinkMouseOvers().size();
const anyCount = queries.getAnyHyperlinks().size();
console.log(scope + ": click=" + clickCount + ", mouse-over=" + mouseOverCount + ", any=" + anyCount);
}

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const destination = presentation.getSlides().addEmptySlide(slide.getLayoutSlide());
    const shape = slide.getShapes().addAutoShape(aspose.slides.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");

    const portionFormat = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
    portionFormat.getHyperlinkManager().setInternalHyperlinkClick(destination);
    portionFormat.getHyperlinkManager().setExternalHyperlinkMouseOver("https://example.com/help");
    const macroButton = slide.getShapes().addAutoShape(aspose.slides.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", aspose.slides.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 不代表容器沒有動作。若 getExternalUrlOriginal 回傳的值與正規化後的 URL 不同，請保留該值，且在有可用提示時加入由 getTooltip 回傳的工具提示。

報告、清理與驗證超連結

以下 JavaScript 範例讀取現有的簡報（使用上述建立的檔案），寫入 hyperlink-audit.json，套用政策，儲存為 hyperlink-sanitized.pptx，並重新開啟以再次檢查兩種啟動方式。它會在變更前收集容器，並利用參考相等性避免重複處理同一容器。簡報查詢涵蓋普通投影片；若要進行全套件的清單，亦會明確查詢母片、版面配置、備註，以及存在時的備註與講義母片。

報告會記錄以 1 為起始的投影片索引與可取得的 getSlideId。對於支援的容器，getSlide 會提供其所屬投影片。母片、版面配置與備註沒有普通投影片索引，會以其範圍辨識。形狀容器與文字部分格式容器會分別標記；其他容器類型保留其執行時類型名稱。每個容器取得報告本地的 ID，以便關聯其兩個動作。報告將動作類型以 HyperlinkActionType 列舉定義的整數常數儲存。

此刻意嚴格的應用政策僅允許絕對的 HTTPS URL 與有效的內部投影片目標。它會拒絕巨集、程式、檔案動作、其他投影片播放動作、未知動作以及其他 URL 協定。這些拒絕屬於政策決策，而非 Aspose.Slides 安全性的判斷。僅有 HTTPS 並不足以建立信任：請為您的應用程式加入主機白名單與其他檢查。會同時檢查原始與正規化後的外部 URL。此範例僅稽核中繼資料，未追蹤連結或執行動作。

若需修正，容器的 getHyperlinkManager 支援 setExternalHyperlinkClick、removeHyperlinkClick 與 removeHyperlinkMouseOver。此處會將被禁止的外部點擊連結取代為固定的 HTTPS 登陸頁面；其他被禁止的點擊與滑鼠懸停動作則分別移除。將 replaceExternalClicks 設為 false 即可改為移除所有政策違規。請於部署前選擇由應用程式提供的替代頁面。

報告的匯出旗標採用保守的 PDF 檢閱政策：將滑鼠懸停動作以及除外部連結或特定投影片跳轉之外的所有動作標記為可能不支援。這僅是檢閱提示，並非功能測試或保證未標記的連結在匯出後仍能存活。依動作、匯出選項與檢視器的不同，支援的PDF與HTML匯出可能會保留超連結。點陣圖像與影片則無法保留互動式超連結；在針對這些輸出進行稽核時，請為每個動作加上旗標。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");

function slideIndex(presentation, slide) {
    if (slide == null) return null;
    for (let index = 0; index < presentation.getSlides().size(); index++) {
        if (presentation.getSlides().get_Item(index).equals(slide)) return index + 1;
    }
    return null;
}

function isHttps(value) {
    if (value == null || value.length === 0) return false;
    try {
        const uri = java.newInstanceSync("java.net.URI", value);
        const scheme = uri.getScheme();
        return uri.isAbsolute() && scheme != null && scheme.toLowerCase() === "https" && uri.getHost() != null;
    } catch (exception) {
        return false;
    }
}

function policyViolation(link) {
    if (link == null) return null;
    if (link.getActionType() === aspose.slides.HyperlinkActionType.JumpSpecificSlide) {
        return link.getTargetSlide() == null ? "Missing target slide" : null;
    }
    if (link.getActionType() !== aspose.slides.HyperlinkActionType.Hyperlink) return "Action is not allowed";
    if (!isHttps(link.getExternalUrl())) return "Normalized URL is not absolute HTTPS";
    const original = link.getExternalUrlOriginal();
    if (original != null && original.length > 0 && !isHttps(original)) return "Original URL is not absolute HTTPS";
    return null;
}

function collectContainers(presentation) {
    const found = [];
    function addQueries(queries) {
        const containers = queries.getAnyHyperlinks();
        for (let index = 0; index < containers.size(); index++) {
            found.push(containers.get_Item(index));
        }
    }
    function addScope(slide) {
        if (slide != null) addQueries(slide.getHyperlinkQueries());
    }
    addQueries(presentation.getHyperlinkQueries());
    for (let index = 0; index < presentation.getMasters().size(); index++) {
        addScope(presentation.getMasters().get_Item(index));
    }
    for (let index = 0; index < presentation.getLayoutSlides().size(); index++) {
        addScope(presentation.getLayoutSlides().get_Item(index));
    }
    for (let index = 0; index < presentation.getSlides().size(); index++) {
        addScope(presentation.getSlides().get_Item(index).getNotesSlideManager().getNotesSlide());
    }
    addScope(presentation.getMasterNotesSlideManager().getMasterNotesSlide());
    addScope(presentation.getMasterHandoutSlideManager().getMasterHandoutSlide());
    const seen = java.newInstanceSync("java.util.IdentityHashMap");
    const unique = [];
    for (const container of found) {
        if (!seen.containsKey(container)) {
            seen.put(container, true);
            unique.push(container);
        }
    }
    return unique;
}

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

const replaceExternalClicks = true;
const replacementUrl = "https://example.com/blocked-link";
const presentation = new aspose.slides.Presentation("hyperlink-audit-input.pptx");
try {
    const containers = collectContainers(presentation);
    const rows = [];
    for (let index = 0; index < containers.length; index++) {
        const container = containers[index];
        addRow(rows, presentation, container.getHyperlinkClick(), "click", container, index + 1);
        addRow(rows, presentation, container.getHyperlinkMouseOver(), "mouse-over", container, index + 1);
    }
    const json = JSON.stringify(rows, null, 2);
    fs.writeFileSync("hyperlink-audit.json", json, "utf8");

    for (const container of containers) {
        const click = container.getHyperlinkClick();
        if (policyViolation(click) != null) {
            if (replaceExternalClicks && click.getActionType() === aspose.slides.HyperlinkActionType.Hyperlink) {
                container.getHyperlinkManager().setExternalHyperlinkClick(replacementUrl);
            } else {
                container.getHyperlinkManager().removeHyperlinkClick();
            }
        }
        if (policyViolation(container.getHyperlinkMouseOver()) != null) {
            container.getHyperlinkManager().removeHyperlinkMouseOver();
        }
    }
    presentation.save("hyperlink-sanitized.pptx", aspose.slides.SaveFormat.Pptx);

    const reopened = new aspose.slides.Presentation("hyperlink-sanitized.pptx");
    try {
        const remainingContainers = collectContainers(reopened);
        let violations = 0;
        for (const container of remainingContainers) {
            if (policyViolation(container.getHyperlinkClick()) != null) violations++;
            if (policyViolation(container.getHyperlinkMouseOver()) != null) violations++;
        }
        console.log("Audit rows: " + rows.length + "; prohibited actions after reopening: " + violations);
        if (violations !== 0) {
            console.log("Verification failed: do not distribute the saved presentation.");
        }
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

使用上述建立的輸入，報告包含五筆動作列。檔案滑鼠懸停連結與巨集點擊被移除，HTTPS 連結與內部投影片導覽則保留下來。驗證結果顯示零項違規動作。若輸入中包含被禁止的外部點擊 URL，亦會走到取代分支。具備允許點擊且被禁止滑鼠懸停的容器會保留其點擊動作。

此選擇性清理與 removeAllHyperlinks 不同，後者會在選取範圍內無條件移除兩種啟動方式。此處的驗證僅檢查超連結動作；不會移除嵌入的 VBA 專案、OLE 物件或其他動態內容，也不會驗證匯出的 PDF 或 HTML 檔案。

常見問題

如何將連結指向章節或其第一張投影片？

PowerPoint 中的章節會將投影片分組，但內部超連結僅能指向單一投影片。若要導向至章節，請將連結指向該章節的第一張投影片。

我可以將超連結附加到母片元素，使其在所有投影片上都有效嗎？

可以。母片與版面配置的元素支援超連結。這些元素上的連結會在使用相應母片或版面配置的投影片播放時可用。

匯出成 PDF、HTML、圖像或影片時，超連結會被保留嗎？

支援的 PDF 與 HTML 匯出可能會保留超連結；點陣圖像與影片則無法。請參閱報告、清理與驗證超連結中的匯出注意事項。

在 JavaScript 中管理簡報 BLOB 以提升記憶體使用效率在 JavaScript 中管理媒體檔案