在制作 PowerPoint 演示文稿时，有时需要通过超链接跳转到网页、打开相关资料，或者直接切换到指定的幻灯片。例如，在项目汇报中，可以给参考资料添加网页链接，也可以在目录页设置链接，方便放映时快速跳转到对应章节。
除了在 PowerPoint 中手动添加超链接，也可以使用 Java 完成这些操作。
本文介绍如何使用 Java 为 PPT 中的文本和图片添加超链接、创建幻灯片内部跳转，以及修改和删除已有超链接。
一、添加 Maven 依赖
首先，在 Java 项目的 pom.xml 文件中添加以下 Maven 仓库和依赖：
xml
<repositories>
<repository>
<id>com.e-iceblue</id>
<name>e-iceblue</name>
<url>https://repo.e-iceblue.cn/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>e-iceblue</groupId>
<artifactId>spire.presentation</artifactId>
<version>11.9.10</version>
</dependency>
</dependencies>下面的示例分别演示文本超链接、图片超链接、幻灯片内部链接，以及已有链接的修改和删除。每种操作都提供完整的 Java 代码。
二、在 PPT 文本中添加超链接
如果希望用户点击 PPT 中的某段文字后打开指定网页，可以通过 PortionEx 对象设置超链接。
PortionEx 表示文本段中的一部分文字。通过 getClickAction().setAddress()，可以为这部分文字设置链接地址。
下面创建一张幻灯片，添加"查看项目资料"文字，并为其设置网页超链接。
scss
import com.spire.presentation.*;
import com.spire.presentation.drawing.FillFormatType;
import java.awt.geom.Rectangle2D;
public class AddTextHyperlink {
public static void main(String[] args) throws Exception {
Presentation presentation = new Presentation();
try {
// 获取第一张幻灯片
ISlide slide = presentation.getSlides().get(0);
// 添加文本形状
Rectangle2D.Double rect =
new Rectangle2D.Double(60, 100, 400, 100);
IAutoShape shape = slide.getShapes()
.appendShape(ShapeType.RECTANGLE, rect);
// 去除形状填充和边框
shape.getFill().setFillType(FillFormatType.NONE);
shape.getLine().setWidth(0);
shape.getTextFrame().getParagraphs().clear();
// 创建文本段落
ParagraphEx paragraph = new ParagraphEx();
PortionEx text = new PortionEx();
// 设置显示文字
text.setText("查看项目资料");
text.setFontHeight(22);
// 设置超链接地址
text.getClickAction().setAddress(
"https://www.example.com/");
// 将文字添加到段落
paragraph.getTextRanges().append(text);
// 将段落添加到形状
shape.getTextFrame()
.getParagraphs().append(paragraph);
// 保存 PPT
presentation.saveToFile(
"text-hyperlink.pptx",
FileFormat.PPTX_2013);
} finally {
presentation.dispose();
}
}
}运行后，会生成 text-hyperlink.pptx。在 PowerPoint 放映模式下，点击"查看项目资料"即可打开指定网页。
这里的关键代码是：
scss
text.getClickAction().setAddress(
"https://www.example.com/");其中，getClickAction() 用于获取文本的单击动作，setAddress() 用于设置超链接目标地址。
除了网页，也可以根据需要设置 mailto: 邮件链接等地址。
示例中使用的是演示网址，实际使用时应替换为需要访问的有效链接。
三、给 PPT 图片添加超链接
超链接不仅可以添加到文字，也可以添加到图片上。
例如，在演示文稿中放置一个网站图标或资料封面，让用户点击图片后打开相关页面。
在 Java 中，可以通过 appendEmbedImage() 插入图片，再使用 setClick() 为图片设置超链接。
下面以 logo.png 为例：
java
import com.spire.presentation.*;
import com.spire.presentation.drawing.FillFormatType;
import java.awt.geom.Rectangle2D;
public class AddImageHyperlink {
public static void main(String[] args) throws Exception {
Presentation presentation = new Presentation();
try {
// 获取第一张幻灯片
ISlide slide = presentation.getSlides().get(0);
// 指定图片位置和大小
Rectangle2D.Double rect =
new Rectangle2D.Double(80, 100, 240, 120);
// 插入图片
IEmbedImage image = slide.getShapes()
.appendEmbedImage(
ShapeType.RECTANGLE,
"logo.png",
rect);
// 去除图片边框
image.getLine().setFillType(FillFormatType.NONE);
// 创建网页超链接
ClickHyperlink hyperlink =
new ClickHyperlink(
"https://www.example.com/");
// 将超链接添加到图片
image.setClick(hyperlink);
// 保存 PPT
presentation.saveToFile(
"image-hyperlink.pptx",
FileFormat.PPTX_2013);
} finally {
presentation.dispose();
}
}
}运行后生成 image-hyperlink.pptx。在幻灯片放映时，点击图片即可打开指定网页。
这个示例主要使用了两个方法：
appendEmbedImage()：将本地图片插入幻灯片。setClick()：为图片设置单击动作。
与文本超链接不同，这里通过 ClickHyperlink 对象设置链接，再将其绑定到图片上。
需要注意，logo.png 必须存在于指定路径。如果图片不在程序的工作目录中，可以将其替换为绝对路径。
四、添加跳转到指定幻灯片的超链接
除了打开外部网页，PowerPoint 还支持在同一份演示文稿中跳转到指定幻灯片。
例如，在 PPT 目录页中，可以把"项目详情"设置为超链接，点击后直接进入对应章节。
这种内部链接不需要提供网页地址，而是通过 ClickHyperlink(ISlide) 指定目标幻灯片。
下面创建两张幻灯片，并在第一页添加跳转到第二页的链接。
scss
import com.spire.presentation.*;
import com.spire.presentation.drawing.FillFormatType;
import java.awt.geom.Rectangle2D;
public class AddSlideHyperlink {
public static void main(String[] args) throws Exception {
Presentation presentation = new Presentation();
try {
// 获取第一张幻灯片
ISlide firstSlide =
presentation.getSlides().get(0);
// 添加第二张幻灯片
ISlide secondSlide =
presentation.getSlides().append();
// 在第二张幻灯片上添加文字
Rectangle2D.Double targetRect =
new Rectangle2D.Double(60, 100, 450, 100);
IAutoShape targetShape = secondSlide.getShapes()
.appendShape(ShapeType.RECTANGLE, targetRect);
targetShape.getFill()
.setFillType(FillFormatType.NONE);
targetShape.getLine().setWidth(0);
targetShape.appendTextFrame("项目详情");
// 在第一张幻灯片上添加文本形状
Rectangle2D.Double linkRect =
new Rectangle2D.Double(60, 100, 450, 100);
IAutoShape linkShape = firstSlide.getShapes()
.appendShape(ShapeType.RECTANGLE, linkRect);
linkShape.getFill()
.setFillType(FillFormatType.NONE);
linkShape.getLine().setWidth(0);
linkShape.getTextFrame().getParagraphs().clear();
// 创建链接文字
ParagraphEx paragraph = new ParagraphEx();
PortionEx text = new PortionEx();
text.setText("点击查看项目详情");
text.setFontHeight(22);
// 创建指向第二张幻灯片的超链接
ClickHyperlink hyperlink =
new ClickHyperlink(secondSlide);
// 设置文本的单击动作
text.setClickAction(hyperlink);
paragraph.getTextRanges().append(text);
linkShape.getTextFrame()
.getParagraphs().append(paragraph);
// 保存 PPT
presentation.saveToFile(
"slide-hyperlink.pptx",
FileFormat.PPTX_2013);
} finally {
presentation.dispose();
}
}
}运行后，生成的 slide-hyperlink.pptx 包含两张幻灯片。
第一页显示"点击查看项目详情"，第二页显示"项目详情"。进入放映模式后，点击第一页中的链接文字，即可跳转到第二页。
这里的核心操作是：
ini
ClickHyperlink hyperlink =
new ClickHyperlink(secondSlide);
text.setClickAction(hyperlink);ClickHyperlink 接收的是目标 ISlide 对象，而不是网页 URL。
如果需要跳转到已有 PPT 的指定页面，可以先通过 getSlides().get(index) 获取目标幻灯片，再创建内部超链接。
需要注意，幻灯片集合的索引从 0 开始 。例如，get(0) 对应第 1 页，get(2) 对应第 3 页。
五、修改 PPT 中已有的超链接
当网页地址发生变化时，不需要删除整个文本框后重新添加链接，可以直接修改已有超链接的目标地址。
例如，第二节创建的 text-hyperlink.pptx 中，"查看项目资料"链接到一个演示网址。现在希望同时修改显示文字和链接地址。
可以通过 getTextFrame().getTextRange() 获取文本范围，再修改其文字和单击动作。
完整代码如下：
scss
import com.spire.presentation.*;
public class ModifyPptHyperlink {
public static void main(String[] args) throws Exception {
Presentation presentation = new Presentation();
try {
// 加载包含超链接的 PPT
presentation.loadFromFile(
"text-hyperlink.pptx");
// 获取第一张幻灯片中的第一个形状
IAutoShape shape = (IAutoShape) presentation
.getSlides().get(0)
.getShapes().get(0);
// 修改超链接的显示文字
shape.getTextFrame()
.getTextRange()
.setText("查看更新后的项目资料");
// 修改超链接地址
shape.getTextFrame()
.getTextRange()
.getClickAction()
.setAddress("https://www.wikipedia.org/");
// 保存修改后的 PPT
presentation.saveToFile(
"modified-hyperlink.pptx",
FileFormat.PPTX_2013);
} finally {
presentation.dispose();
}
}
}运行后生成 modified-hyperlink.pptx，链接的显示文字和目标地址均已更新。
这段代码使用了两个方法：
setText()：修改超链接对应的显示文字。getClickAction().setAddress()：修改超链接的目标地址。
需要注意，上面的代码直接获取第一张幻灯片中的第一个形状，是因为第二节生成的文件结构已知，而且该形状只包含一段链接文字。
如果处理的是实际业务中的 PPT，某个文本框可能包含多段文字或多个超链接，此时应先定位需要修改的文本范围，避免误改其他内容。
六、删除 PPT 中的超链接
如果某个超链接已经不再需要，可以将文本的单击动作设置为 null，删除链接而保留原来的文字。
下面继续使用第二节生成的 text-hyperlink.pptx，删除其中的网页超链接。
java
import com.spire.presentation.*;
public class RemovePptHyperlink {
public static void main(String[] args) throws Exception {
Presentation presentation = new Presentation();
try {
// 加载包含超链接的 PPT
presentation.loadFromFile(
"text-hyperlink.pptx");
// 获取包含超链接的形状
IAutoShape shape = (IAutoShape) presentation
.getSlides().get(0)
.getShapes().get(0);
// 删除文本超链接
shape.getTextFrame()
.getTextRange()
.setClickAction(null);
// 保存 PPT
presentation.saveToFile(
"removed-hyperlink.pptx",
FileFormat.PPTX_2013);
} finally {
presentation.dispose();
}
}
}运行后会生成 removed-hyperlink.pptx。
其中，"查看项目资料"文字仍然保留，但不再具有原来的网页跳转功能。
这里使用的核心方法是：
scss
shape.getTextFrame()
.getTextRange()
.setClickAction(null);该操作删除的是文本范围上的单击动作，不会直接删除文字内容。
需要注意，删除超链接后，原来设置的字体颜色、下划线等格式不一定会自动恢复。如果还希望去掉链接样式，需要另外调整文本格式。
对于包含多个超链接的文本框，同样需要先确定目标文本范围，不能直接将整个文本框的单击动作清空，否则可能影响其他链接。
七、操作 PPT 超链接时需要注意的问题
1. 超链接通常需要在放映模式下测试
在 PowerPoint 编辑界面中，直接点击文字或图片通常是选中对象，不一定会打开超链接。
因此，添加或修改链接后，建议进入幻灯片放映模式，检查链接是否能够正常跳转。
2. 外部链接需要有效的目标地址
如果网页链接指向的地址已经失效，或者目标网站无法访问，即使超链接成功写入 PPT，也无法保证页面正常打开。
同样，如果链接指向本地文件，移动 PPT 或更换设备后，原来的文件路径可能不再有效。
3. 文本链接与形状链接的处理方式不同
文本超链接通常设置在 PortionEx 等文本范围对象上，而图片超链接则通过图片形状的 setClick() 方法设置。
修改或删除链接时，需要先确认超链接附加在哪种对象上，再选择对应的 API。
4. 处理已有 PPT 时不要直接假设形状索引
本文的修改和删除示例使用 getShapes().get(0)，是因为输入文件由前面的代码生成，形状位置可以确定。
对于已有的复杂 PPT，幻灯片中可能包含文本框、图片、图表等多个对象。实际开发时，应根据对象类型、名称或文本内容定位目标形状，避免修改错误的链接。