Управление гиперссылками презентации в Java
Введение
Гиперссылка соединяет содержимое презентации с веб‑сайтом или расположением внутри презентации. В PowerPoint гиперссылки обычно служат двум целям:
- Открыть веб‑сайт из текста, фигуры или мультимедийного кадра.
- Перейти к другому слайду, например, из оглавления.
Aspose.Slides for Java позволяет добавлять такие ссылки, управлять их внешним видом и звуком, обновлять их свойства и удалять их. Приведённые ниже примеры показывают, как работать с гиперссылками на отдельных элементах и как получать доступ к гиперссылкам на уровне презентации, слайда или текстового кадра.
Note
Вы можете также редактировать презентации с помощью бесплатный онлайн-редактор Aspose PowerPoint.Добавить URL‑гиперссылки
Вы можете присвоить URL‑адрес веб‑сайта тексту, фигуре или мультимедийному кадру. Элемент, к которому вы назначаете гиперссылку, определяет область щелчка: часть текста связывает выделенный текст, тогда как фигура или кадр связывают объект слайда.
Для презентаций, содержащих относительные гиперссылки, см. Управление базой гиперссылок, чтобы прочитать, изменить или очистить базу уровня документа.
Добавить URL‑гиперссылки к тексту
Чтобы связать текст с веб‑сайтом, передайте объект Hyperlink в метод setHyperlinkClick части текста, как показано ниже. Только эта часть текста станет кликабельной.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
IAutoShape textShape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);
textShape.addTextFrame("Aspose: File Format APIs");
IPortionFormat 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, чтобы показать читателям подсказку о назначении при наведении курсора на прямоугольник. Оба метода также применимы к кадрам изображений, аудио и видео.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
IAutoShape 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” на первом слайде со вторым слайдом.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide firstSlide = presentation.getSlides().get_Item(0);
ISlide secondSlide = presentation.getSlides().addEmptySlide(firstSlide.getLayoutSlide());
IAutoShape 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 paragraph = new Paragraph();
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
paragraph.setText("Title of slide 2 .......... ");
Portion 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 интерфейса IHyperlink определяет, будет ли гиперссылка использовать цвет гиперссылок презентации или форматирование части текста. Чтобы задать пользовательский цвет текста, выберите HyperlinkColorSource.PortionFormat и задайте цвет заливки части. Эта возможность была введена в PowerPoint 2019; в более ранних версиях этот параметр не применяется.
В этом примере setColorSource заставляет первую ссылку использовать красный залив части текста. Вторая ссылка сохраняет цвет гиперссылок презентации.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
IAutoShape coloredShape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 450, 50, false);
coloredShape.addTextFrame("This hyperlink uses a custom color.");
IPortionFormat 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(Color.RED);
IAutoShape 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();
}
Звук
Гиперссылка может воспроизводить звук при активации или останавливать уже воспроизводящийся звук. Используйте следующие методы для настройки этих поведений:
- IHyperlink.setSound задаёт аудио, связанное с гиперссылкой.
- IHyperlink.setStopSoundOnClick контролирует, останавливается ли предыдущий звук при активации гиперссылки.
Добавить звук к гиперссылке
Кнопка на первом слайде использует IHyperlink.setSound для воспроизведения аудио из sampleaudio.wav, когда читатель нажимает для перехода вперёд. На втором слайде отдельная кнопка использует IHyperlink.setStopSoundOnClick для остановки воспроизведения и удержания читателя на этом слайде.
import com.aspose.slides.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
Presentation presentation = new Presentation();
try {
byte[] audioData = Files.readAllBytes(Paths.get("sampleaudio.wav"));
IAudio hyperlinkSound = presentation.getAudios().addAudio(audioData);
ISlide firstSlide = presentation.getSlides().get_Item(0);
IAutoShape playButton = firstSlide.getShapes().addAutoShape(ShapeType.SoundButton, 100, 100, 100, 50);
playButton.setHyperlinkClick(Hyperlink.getNextSlide());
if (!playButton.getHyperlinkClick().getStopSoundOnClick() && playButton.getHyperlinkClick().getSound() == null)
{
playButton.getHyperlinkClick().setSound(hyperlinkSound);
}
ISlide secondSlide = presentation.getSlides().addEmptySlide(firstSlide.getLayoutSlide());
IAutoShape 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 (IOException exception) {
System.out.println("Unable to read the audio file: " + exception.getMessage());
} finally {
presentation.dispose();
}
Извлечь звук из гиперссылки
Следующий пример открывает созданную выше презентацию и считывает аудио гиперссылки первой фигуры в память через getSound и getBinaryData.
import com.aspose.slides.*;
Presentation presentation = new Presentation("hyperlink-sound.pptx");
try {
if (presentation.getSlides().size() > 0 && presentation.getSlides().get_Item(0).getShapes().size() > 0) {
IHyperlink hyperlink = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getHyperlinkClick();
IAudio sound = hyperlink == null ? null : hyperlink.getSound();
if (sound != null) {
byte[] audioData = sound.getBinaryData();
System.out.println("Extracted " + audioData.length + " bytes of hyperlink audio.");
} else {
System.out.println("The first shape has no hyperlink sound.");
}
} else {
System.out.println("The presentation has no first slide or shape to inspect.");
}
} finally {
presentation.dispose();
}
Настройки подсказок и взаимодействия
Вы можете вызвать следующие методы IHyperlink после назначения гиперссылки тексту или фигуре:
- setTooltip задаёт текст, который пользователь может отобразить как подсказку для ссылки.
- setTargetFrame указывает целевой кадр внутри родительского HTML‑фреймсета, если применимо.
- setHistory контролирует, будет ли активация ссылки добавлять её назначение в список просмотренных гиперссылок.
- setHighlightClick контролирует, будет ли гиперссылка подсвечиваться при щелчке.
Удалить гиперссылки из презентаций
Используйте getAnyHyperlinks , чтобы собрать контейнеры гиперссылок, включая ссылки частей текста, перед их изменением. Приведённый пример удаляет оба типа активации с первого слайда. Чтобы удалить только один тип, вызовите только removeHyperlinkClick или removeHyperlinkMouseOver; удаление действия щелчка не удаляет его аналог при наведении.
import com.aspose.slides.*;
import java.util.ArrayList;
import java.util.List;
Presentation presentation = new Presentation("pres.pptx");
try {
if (presentation.getSlides().size() > 0) {
List<IHyperlinkContainer> containers = new ArrayList<>();
for (IHyperlinkContainer container : presentation.getSlides().get_Item(0).getHyperlinkQueries().getAnyHyperlinks()) {
containers.add(container);
}
for (IHyperlinkContainer container : containers) {
container.getHyperlinkManager().removeHyperlinkClick();
container.getHyperlinkManager().removeHyperlinkMouseOver();
}
presentation.save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx);
} else {
System.out.println("The presentation has no slides to process.");
}
} finally {
presentation.dispose();
}
Для безусловного удаления removeAllHyperlinks удаляет оба типа активации в выбранной области одним вызовом. Для выборочной очистки и охвата мастеров, макетов и заметок см. Отчёт, очистка и проверка гиперссылок.
Очистить гиперссылки перед заменой текста SmartArt
При замене абзаца в существующей вершине SmartArt очистка её частей текста может оставить старую гиперссылку в действии. Получите абзац через ISmartArtNode.getTextFrame. Перед очисткой его частей вызовите getHyperlinkQueries у текстового кадра формы вершины, отображающей абзац, затем вызовите removeAllHyperlinks у полученного объекта. Это удалит каждую гиперссылку в этом кадре, включая ссылки в других абзацах.
Пример предполагает, что третья фигура на первом слайде SmartArtHyperlink.pptx является графикой SmartArt. Он заменяет первый абзац четвёртой вершины. В этой презентации первая форма вершины отображает этот абзац.
После добавления обеих частей пример считывает их эффективное форматирование через getEffective. Для этого форматирования getHyperlinkClick возвращает новую гиперссылку для первой части и null для второй.
import com.aspose.slides.*;
Presentation presentation = new Presentation("SmartArtHyperlink.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = (ISmartArt) slide.getShapes().get_Item(2);
ISmartArtNode node = smartArt.getAllNodes().get_Item(3);
IParagraph paragraph = node.getTextFrame().getParagraphs().get_Item(0);
node.getShapes().get_Item(0).getTextFrame().getHyperlinkQueries().removeAllHyperlinks();
paragraph.getPortions().clear();
IPortion link = new Portion("New reference");
link.getPortionFormat().setHyperlinkClick(new Hyperlink("https://example.com/new"));
paragraph.getPortions().add(link);
IPortion text = new Portion(" (updated)");
paragraph.getPortions().add(text);
System.out.println(link.getPortionFormat().getEffective().getHyperlinkClick().getExternalUrl()); // https://example.com/new
System.out.println(text.getPortionFormat().getEffective().getHyperlinkClick()); // null
} finally {
presentation.dispose();
}
Создать полный перечень гиперссылок
Перед распространением презентации составьте перечень её интерактивных действий, а также веб‑ссылок. getAnyHyperlinks возвращает объекты IHyperlinkContainer, а не плоский список URL‑строк. Проверьте как getHyperlinkClick , так и getHyperlinkMouseOver у каждого контейнера. Они независимы: один контейнер может предоставлять обе операции, поэтому для полного отчёта требуется до двух строк на контейнер.
Сканирование только гиперссылок уровня фигур может пропустить ссылки, прикреплённые к частям текста. Запрашивайте соответствующую область вместо этого и сохраняйте полученные контейнеры, чтобы позже обновлять или удалять их действия.
Запрос областей Презентация, Слайд и Текстовый кадр
Интерфейс IHyperlinkQueries доступен через IPresentation.getHyperlinkQueries, IBaseSlide.getHyperlinkQueries и ITextFrame.getHyperlinkQueries. Каждая область поддерживает одинаковые запросы:
- getHyperlinkClicks возвращает контейнеры с действием щелчка.
- getHyperlinkMouseOvers возвращает контейнеры с действием наведения.
- getAnyHyperlinks возвращает контейнеры с любым из этих действий или с обоими.
Этот пример назначает действия щелчка и наведения фигуре и её тексту, а действие макроса – отдельной кнопке. Он сравнивает количество контейнеров, возвращённых getAnyHyperlinks, с числами для каждого типа активации. Запрос текстового кадра считает только ссылки в тексте. Действия самой охватывающей фигуры появляются в запросах слайда и презентации.
import com.aspose.slides.*;
class QueryCounts {
void print(String scope, IHyperlinkQueries queries) {
int clickCount = queries.getHyperlinkClicks().size();
int mouseOverCount = queries.getHyperlinkMouseOvers().size();
int anyCount = queries.getAnyHyperlinks().size();
System.out.println(scope + ": click=" + clickCount + ", mouse-over=" + mouseOverCount + ", any=" + anyCount);
}
}
QueryCounts counts = new QueryCounts();
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISlide destination = presentation.getSlides().addEmptySlide(slide.getLayoutSlide());
IAutoShape 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");
IPortionFormat portionFormat = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
portionFormat.getHyperlinkManager().setInternalHyperlinkClick(destination);
portionFormat.getHyperlinkManager().setExternalHyperlinkMouseOver("https://example.com/help");
IAutoShape macroButton = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 120, 200, 60);
macroButton.getHyperlinkManager().setMacroHyperlinkClick("ReviewPresentation");
counts.print("Presentation", presentation.getHyperlinkQueries());
counts.print("Slide 1", slide.getHyperlinkQueries());
counts.print("Text frame", shape.getTextFrame().getHyperlinkQueries());
presentation.save("hyperlink-audit-input.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Для этого примера запросы презентации и слайда каждый возвращают три контейнера щелчка, два контейнера наведения и три контейнера с любым действием. Запрос текстового кадра возвращает по одному контейнеру в каждой категории.
Классифицировать действия и назначения
Используйте IHyperlink.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, если она доступна.
Отчёт, очистка и проверка гиперссылок
Этот пример открывает презентацию из предыдущего примера и записывает одну запись JSON на каждое действие. Он использует getAnyHyperlinks для сбора контейнеров на обычных слайдах, мастерах, макетах и заметках, включая мастеры заметок и раздаточных материалов, если они присутствуют. Он использует проверку равенства ссылок, чтобы посчитать каждый контейнер один раз, применяет описанную ниже политику и повторно открывает сохранённую презентацию для проверки действий щелчка и наведения.
Отчёт фиксирует однорядный индекс слайда (начиная с 1) и getSlideId при наличии. ISlideComponent.getSlide предоставляет слайд‑владельца для поддерживаемых контейнеров. У мастеров, макетов и заметок нет обычного индекса слайда и они идентифицируются по своей области. Контейнеры фигур и контейнеры форматирования частей текста помечаются отдельно; остальные типы сохраняют своё имя типа во время выполнения. Каждый контейнер получает локальный ID отчёта, чтобы его два действия можно было сопоставить. В отчёте типы действий сохраняются как целочисленные константы, определённые перечислением Java.
Эта преднамеренно строгая политика приложения допускает только абсолютные HTTPS‑URL и допустимые внутренние цели слайдов. Она отклоняет макросы, программы, файловые действия, остальные действия слайд‑шоу, неизвестные действия и прочие схемы URL. Эти отклонения – решения политики, а не оценка безопасности Aspose.Slides. Один лишь HTTPS не гарантирует доверие: добавьте списки разрешённых хостов и другие проверки для вашего приложения. Проверяются как оригинальные, так и нормализованные внешние URL. Пример проверяет метаданные без перехода по ссылкам или выполнения действий.
Для исправления контейнерный getHyperlinkManager поддерживает setExternalHyperlinkClick, removeHyperlinkClick и removeHyperlinkMouseOver. Здесь запрещённые внешние ссылки‑клики заменяются фиксированной HTTPS‑страницей; остальные запрещённые клики и действия наведения удаляются независимо. Установите replaceExternalClicks в false, чтобы удалить все нарушения политики. Выберите страницу‑заменитель, принадлежащую приложению, перед развертыванием.
Флаг экспорта отчёта использует консервативную политику проверки PDF: помечать действия наведения и всё, кроме внешних ссылок или переходов к конкретному слайду, как потенциально неподдерживаемые. Это лишь рекомендация для проверки, а не тест возможностей или гарантия, что непомеченные ссылки сохранятся при экспорте. Поддерживаемые PDF и HTML экспорты могут сохранять гиперссылки, в зависимости от действия, параметров экспорта и просмотрщика. Растровые images и video не могут сохранять интерактивные гиперссылки; помечайте каждое действие при аудите для этих форматов вывода.
import com.aspose.slides.*;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.Collections;
import java.util.IdentityHashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
class HyperlinkAudit {
Integer slideIndex(IPresentation presentation, IBaseSlide slide) {
for (int index = 0; index < presentation.getSlides().size(); index++) {
if (presentation.getSlides().get_Item(index) == slide) return index + 1;
}
return null;
}
boolean isHttps(String value) {
if (value == null || value.isEmpty()) return false;
try {
URI uri = new URI(value);
return uri.isAbsolute() && "https".equalsIgnoreCase(uri.getScheme()) && uri.getHost() != null;
} catch (URISyntaxException exception) {
return false;
}
}
String policyViolation(IHyperlink link) {
if (link == null) return null;
if (link.getActionType() == HyperlinkActionType.JumpSpecificSlide) {
return link.getTargetSlide() == null ? "Missing target slide" : null;
}
if (link.getActionType() != HyperlinkActionType.Hyperlink) return "Action is not allowed";
if (!isHttps(link.getExternalUrl())) return "Normalized URL is not absolute HTTPS";
String original = link.getExternalUrlOriginal();
if (original != null && !original.isEmpty() && !isHttps(original)) return "Original URL is not absolute HTTPS";
return null;
}
void addScope(List<IHyperlinkContainer> found, IBaseSlide slide) {
if (slide != null) {
for (IHyperlinkContainer container : slide.getHyperlinkQueries().getAnyHyperlinks()) {
found.add(container);
}
}
}
List<IHyperlinkContainer> collectContainers(IPresentation presentation) {
List<IHyperlinkContainer> found = new ArrayList<>();
for (IHyperlinkContainer container : presentation.getHyperlinkQueries().getAnyHyperlinks()) {
found.add(container);
}
for (IMasterSlide master : presentation.getMasters()) addScope(found, master);
for (ILayoutSlide layout : presentation.getLayoutSlides()) addScope(found, layout);
for (ISlide slide : presentation.getSlides()) addScope(found, slide.getNotesSlideManager().getNotesSlide());
addScope(found, presentation.getMasterNotesSlideManager().getMasterNotesSlide());
addScope(found, presentation.getMasterHandoutSlideManager().getMasterHandoutSlide());
Set<IHyperlinkContainer> seen = Collections.newSetFromMap(new IdentityHashMap<IHyperlinkContainer, Boolean>());
List<IHyperlinkContainer> unique = new ArrayList<>();
for (IHyperlinkContainer container : found) {
if (seen.add(container)) unique.add(container);
}
return unique;
}
void addRow(List<Map<String, Object>> rows, IPresentation presentation, IHyperlink link, String activation, IHyperlinkContainer container, int containerId) {
if (link == null) return;
IBaseSlide ownerSlide = container instanceof ISlideComponent ? ((ISlideComponent) container).getSlide() : null;
ISlide targetSlide = link.getTargetSlide();
String violation = policyViolation(link);
String ownerType = container instanceof IShape ? "Shape" : container instanceof IPortionFormat ? "Text portion" : container.getClass().getSimpleName();
boolean ordinaryAction = link.getActionType() == HyperlinkActionType.Hyperlink || link.getActionType() == HyperlinkActionType.JumpSpecificSlide;
Map<String, Object> row = new LinkedHashMap<>();
row.put("ContainerId", containerId);
row.put("SlideIndex", slideIndex(presentation, ownerSlide));
row.put("SlideId", ownerSlide == null ? null : ownerSlide.getSlideId());
row.put("Scope", ownerSlide == null ? null : ownerSlide.getClass().getSimpleName());
row.put("OwnerType", ownerType);
row.put("Activation", activation);
row.put("ActionType", link.getActionType());
row.put("ExternalUrl", link.getExternalUrl());
row.put("TargetSlideIndex", slideIndex(presentation, targetSlide));
row.put("TargetSlideId", targetSlide == null ? null : targetSlide.getSlideId());
row.put("Tooltip", link.getTooltip());
row.put("OriginalExternalUrl", Objects.equals(link.getExternalUrlOriginal(), link.getExternalUrl()) ? null : link.getExternalUrlOriginal());
row.put("PotentiallyUnsafe", violation != null);
row.put("PolicyViolation", violation);
row.put("TargetExport", "PDF");
row.put("PotentiallyUnsupportedByExport", "mouse-over".equals(activation) || !ordinaryAction);
rows.add(row);
}
// Сериализовать плоские строки этого отчёта без дополнительной зависимости JSON.
String jsonValue(Object value) {
if (value == null) return "null";
if (value instanceof Number || value instanceof Boolean) return value.toString();
StringBuilder escaped = new StringBuilder("\"");
for (char character : value.toString().toCharArray()) {
if (character == '"' || character == '\\') {
escaped.append('\\').append(character);
} else if (character < 0x20 || Character.isSurrogate(character)) {
escaped.append(String.format("\\u%04x", (int) character));
} else {
escaped.append(character);
}
}
return escaped.append('"').toString();
}
String toJson(List<Map<String, Object>> rows) {
List<String> objects = new ArrayList<>();
for (Map<String, Object> row : rows) {
List<String> fields = new ArrayList<>();
for (Map.Entry<String, Object> field : row.entrySet()) {
fields.add(" " + jsonValue(field.getKey()) + ": " + jsonValue(field.getValue()));
}
objects.add(" {\n" + String.join(",\n", fields) + "\n }");
}
return "[\n" + String.join(",\n", objects) + "\n]\n";
}
}
boolean replaceExternalClicks = true;
String replacementUrl = "https://example.com/blocked-link";
HyperlinkAudit audit = new HyperlinkAudit();
Presentation presentation = new Presentation("hyperlink-audit-input.pptx");
try {
List<IHyperlinkContainer> containers = audit.collectContainers(presentation);
List<Map<String, Object>> rows = new ArrayList<>();
for (int index = 0; index < containers.size(); index++) {
IHyperlinkContainer container = containers.get(index);
audit.addRow(rows, presentation, container.getHyperlinkClick(), "click", container, index + 1);
audit.addRow(rows, presentation, container.getHyperlinkMouseOver(), "mouse-over", container, index + 1);
}
String json = audit.toJson(rows);
byte[] jsonData = json.getBytes(StandardCharsets.UTF_8);
Files.write(Paths.get("hyperlink-audit.json"), jsonData);
for (IHyperlinkContainer container : containers) {
IHyperlink click = container.getHyperlinkClick();
if (audit.policyViolation(click) != null) {
if (replaceExternalClicks && 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);
Presentation reopened = new Presentation("hyperlink-sanitized.pptx");
try {
List<IHyperlinkContainer> remainingContainers = audit.collectContainers(reopened);
int violations = 0;
for (IHyperlinkContainer container : remainingContainers) {
if (audit.policyViolation(container.getHyperlinkClick()) != null) violations++;
if (audit.policyViolation(container.getHyperlinkMouseOver()) != null) violations++;
}
System.out.println("Audit rows: " + rows.size() + "; prohibited actions after reopening: " + violations);
if (violations != 0) {
System.out.println("Verification failed: do not distribute the saved presentation.");
}
} finally {
reopened.dispose();
}
} catch (IOException exception) {
System.out.println("Unable to write the audit report: " + exception.getMessage());
} finally {
presentation.dispose();
}
С созданным выше вводом отчёт содержит пять строк действий. Ссылка‑наведение файла и клик макроса удаляются, тогда как HTTPS‑ссылки и внутренняя навигация по слайдам остаются. Проверка выводит ноль запрещённых действий. Ввод, содержащий запрещённый внешний URL‑клик, также демонстрирует ветку замены. Контейнер с разрешённым кликом и запрещённым наведением сохраняет своё действие‑клик.
Эта выборочная очистка отличается от removeAllHyperlinks, который удаляет оба типа активации во всей выбранной области независимо от политики. Проверка здесь проверяет только действия гиперссылок; она не удаляет встроенные VBA‑проекты, OLE‑объекты или другой активный контент и не проверяет экспортированный PDF или HTML файл.
FAQ
Как можно создать ссылку на раздел или его первый слайд?
Разделы в PowerPoint группируют слайды, но внутренняя гиперссылка указывает на отдельный слайд. Чтобы создать навигацию к разделу, свяжите её с первым слайдом этого раздела.
Могу ли я прикрепить гиперссылку к элементам мастер‑слайда, чтобы она работала на всех слайдах?
Да. Элементы мастер‑слайда и макета поддерживают гиперссылки. Ссылки на этих элементах доступны во время показа слайдов на тех слайдах, которые используют соответствующий мастер или макет.
Будут ли гиперссылки сохраняться при экспорте в PDF, HTML, изображения или видео?
Поддерживаемые PDF и HTML экспорты могут сохранять гиперссылки; растровые изображения и видео – нет. См. соображения по экспорту в Отчёт, очистка и проверка гиперссылок.