Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,11 +1,56 @@
---
date: '2026-01-11'
description: 学习如何使用 Aspose Slides for Java,向图表添加图像标记,并配置 Aspose Slides Maven 依赖以实现自定义图表视觉效果
date: '2026-06-03'
description: 了解如何在 Java 中使用 Aspose Slides Maven 依赖项,向图表添加图像标记,并使用 Aspose.Slides 配置自定义图表视觉效果
keywords:
- Aspose.Slides for Java
- image markers in charts
- Java presentation enhancements
title: 如何使用 Aspose Slides Java - 向图表添加图像标记
- aspose slides maven dependency
- how to add markers
- add images to chart
schemas:
- author: Aspose
dateModified: '2026-06-03'
description: Learn how to use the aspose slides maven dependency for Java, add image
markers to charts, and configure custom chart visuals with Aspose.Slides.
headline: 'How to Use Aspose Slides Maven Dependency for Java: Add Image Markers
to Charts'
type: TechArticle
- description: Learn how to use the aspose slides maven dependency for Java, add image
markers to charts, and configure custom chart visuals with Aspose.Slides.
name: 'How to Use Aspose Slides Maven Dependency for Java: Add Image Markers to
Charts'
steps:
- name: Create a New Presentation with a Chart
text: The `Presentation` object creates a new PPTX file and `ISlide` represents
a slide where the chart will be placed.
- name: Access and Configure Chart Data
text: The `IChart` interface provides methods to modify series, categories, and
data points within the chart.
- name: Add Image Markers to Chart Data Points
text: '`IDataPoint` represents an individual point, and its `setMarker` method
assigns a custom image as the marker.'
- name: Configure Marker Size and Save the Presentation
text: '`presentation.save` writes the final PPTX file to the specified location
with the chosen format.'
type: HowTo
- questions:
- answer: Yes, any image format supported by Aspose.Slides (PNG, JPEG, BMP, GIF)
works as a marker.
question: Can I use PNG images instead of JPEG for markers?
- answer: A temporary license is sufficient for development and testing; a full
license is required for commercial distribution.
question: Do I need a license for the Maven/Gradle packages?
- answer: Absolutely. In the `AddImageMarkers` example we alternate between two
pictures, but you can load a unique image for every point.
question: Is it possible to add different images to each data point in the same
series?
- answer: The Maven package includes only the necessary binaries for the selected
JDK version, keeping the footprint under **15 MB**. You can also use the **no‑dependencies**
version if size is a concern.
question: How does the aspose slides maven dependency affect project size?
- answer: Aspose.Slides for Java supports JDK 8 through JDK 21. The example uses
JDK 16, but you can adjust the classifier accordingly.
question: What Java versions are supported?
type: FAQPage
title: 如何在 Java 中使用 Aspose Slides Maven 依赖项:向图表添加图像标记
url: /zh/java/charts-graphs/aspose-slides-java-add-image-markers-charts/
weight: 1
---
Expand All @@ -15,41 +60,35 @@ weight: 1
{{< blocks/products/pf/main-container >}}

{{< blocks/products/pf/tutorial-page-section >}}
# 如何使用 Aspose Slides Java:向图表添加图像标记
# 如何在 Java 中使用 Aspose Slides Maven 依赖项:为图表添加图像标记

## 简介
创建视觉上吸引人的演示文稿是有效沟通的关键,图表是简洁传达复杂数据的强大工具。当您思考 **how to use Aspose** 让图表脱颖而出时,自定义图像标记就是答案。标准标记可能显得通用,但使用 Aspose.Slides for Java,您可以将它们替换为任意图片——使每个数据点瞬间可辨
## 介绍
在本教程中,我们展示**如何在 Java 中使用 Aspose Slides Maven 依赖项**为图表添加图像标记,为每个数据点提供独特的视觉提示。创建视觉上吸引人的演示文稿是有效沟通的关键,图表是简洁传达复杂数据的强大方式。当您想知道**如何使用 Aspose**让图表脱颖而出时,自定义图像标记就是答案。标准标记可能显得通用,但使用 Aspose.Slides for Java,您可以将其替换为任意图片——使每个数据点瞬间可辨识

在本教程中,我们将完整演示向折线图添加图像标记的全过程,包括设置 **Aspose Slides Maven dependency**、加载图像并将其应用于数据点。结束时,您将熟悉 **how to add markers**、如何 **add images to chart** 系列,并拥有可直接运行的代码示例。
通过本指南,您将能够:

**您将学习**
- 如何设置 Aspose.Slides for Java(包括 Maven/Gradle)
- 创建基本的演示文稿和图表
- 向图表数据点添加图像标记
- 配置标记大小和样式以获得最佳可视化
* 在 Maven 或 Gradle 中设置 **aspose slides maven dependency**。
* 创建一个基本的演示文稿,插入折线图,并清除默认系列。
* 加载 PNG/JPEG/BMP 图像并将其分配为各个数据点的标记。
* 调整标记大小、样式,并保存最终的 PPTX 文件。

准备提升您的图表了吗?让我们在开始之前先了解前提条件
准备好提升您的图表了吗?让我们开始吧

### 快速解答
- **What is the primary purpose?** 添加自定义图像标记到图表数据点
- **Which library is required?** Aspose.Slides for JavaMaven/Gradle
- **Do I need a license?** 临时许可证可用于评估;生产环境需要完整许可证。
- **Which Java version is supported?** JDK 16 或更高
- **Can I use any image format?** 可以——PNG、JPEG、BMP 等,只要文件可访问。
### 快速答案
- **主要目的是什么?** 向图表数据点添加自定义图像标记
- **需要哪个库?** Aspose.Slides for Java (Maven/Gradle)
- **我需要许可证吗?** 临时许可证可用于评估;生产环境需要完整许可证。
- **支持哪个 Java 版本?** JDK 16 或更高版本
- **我可以使用任何图像格式吗?** 可以——PNG、JPEG、BMP、GIF 等,只要文件可访问。

### 前提条件
要跟随本教程,您需要:
1. **Aspose.Slides for Java Library** – 通过 Maven、Gradle 或直接下载获取。
2. **Java 开发环境** – 已安装 JDK 16 或更高版本。
3. **基本的 Java 编程知识** – 熟悉 Java 语法和概念会有所帮助。

## 什么是 Aspose Slides Maven 依赖?
Maven 依赖会为您的 Java 版本拉取正确的二进制文件。将其添加到 `pom.xml` 可确保库在编译时和运行时可用。
## Aspose Slides Maven 依赖项是什么?
Aspose Slides Maven 依赖项是一个 Maven 构件,捆绑了创建图表、图像处理和演示文稿操作所需的 Aspose.Slides for Java 二进制文件。将该依赖项添加到您的 `pom.xml` 中,Maven 会自动下载适用于您 JDK 的正确版本,解析传递依赖,并在编译和运行时提供完整的 API。

### 如何添加 Aspose Slides Maven 依赖项?
通过 Maven 和 Gradle 加载 Aspose Slides 库。直接答案:将 `<dependency>` 代码段添加到您的 `pom.xml` **或** 将 `implementation` 行添加到您的 `build.gradle`。此一步即可在项目中立即使用完整的 API,包括图表相关和图像标记功能。

### Maven 安装

将以下依赖项添加到您的 `pom.xml` 文件中:
#### Maven 安装
在您的 `pom.xml` 文件中添加以下依赖项:

```xml
<dependency>
Expand All @@ -60,24 +99,30 @@ Maven 依赖会为您的 Java 版本拉取正确的二进制文件。将其添
</dependency>
```

### Gradle 安装
将以下代码添加到您的 `build.gradle` 文件中:

#### Gradle 安装
在您的 `build.gradle` 文件中包含此行:

```gradle
implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16'
```

### 直接下载
#### 直接下载
或者,从 [Aspose.Slides for Java releases](https://releases.aspose.com/slides/java/) 下载最新发布版本。

#### 获取许可证的步骤
- **Free Trial** – 使用临时许可证开始探索功能。
- **Temporary License** – 在测试期间解锁高级功能。
- **Purchase** – 为商业项目获取完整许可证。
- **Purchase** – 为商业项目获取完整许可证。

## 先决条件
要遵循本教程,您需要:

1. **Aspose.Slides for Java Library** – 通过 Maven、Gradle 或直接下载获取。
2. **Java Development Environment** – 已安装 JDK 16 或更高版本。
3. **Basic Java Programming Knowledge** – 熟悉 Java 语法和概念将有所帮助。

## 基本初始化和设置
首先,创建一个Presentation对象。该对象代表整个 PowerPoint 文件,并将用于存放我们的图表
首先,创建一个 `Presentation` 对象。该对象代表整个 PowerPoint 文件,并将容纳我们的图表

```java
import com.aspose.slides.*;
Expand All @@ -91,10 +136,10 @@ public class InitializeAspose {
```

## 实现指南
下面是向图表添加图像标记的逐步演示。每个代码块都有说明,帮助您了解每行代码的 **原因**
下面是向图表添加图像标记的逐步演练。每个代码块都有解释,帮助您了解**为什么**每行代码重要

### 步骤 1:创建带图表的新演示文稿
我们在第一张幻灯片中添加了一个带有默认标记的折线图
### 步骤 1:创建带有图表的新演示文稿
`Presentation` 对象创建一个新的 PPTX 文件,`ISlide` 表示放置图表的幻灯片

```java
import com.aspose.slides.*;
Expand All @@ -116,7 +161,7 @@ public class CreatePresentation {
```

### 步骤 2:访问并配置图表数据
我们清除所有默认序列并添加我们自己的序列,为自定义数据点准备工作表
`IChart` 接口提供了修改图表中系列、类别和数据点的方法

```java
import com.aspose.slides.*;
Expand All @@ -143,8 +188,8 @@ public class ManageChartData {
}
```

### 步骤 3:向图表数据点添加图像标记
这里我们演示如何使用图片添加标记。请将占位符路径替换为图片的实际位置
### 步骤 3:为图表数据点添加图像标记
`IDataPoint` 代表单个点,其 `setMarker` 方法将自定义图像分配为标记

```java
import com.aspose.slides.*;
Expand Down Expand Up @@ -195,8 +240,8 @@ public class AddImageMarkers {
}
```

### 步骤 4:配置标记大小并保存演示文稿
我们调整标记样式以提高可见性,并写入最终的 PPTX 文件
### 步骤 4:配置标记大小并保存演示文稿
`presentation.save` 将最终的 PPTX 文件写入指定位置并使用所选格式

```java
import com.aspose.slides.*;
Expand Down Expand Up @@ -238,41 +283,50 @@ public class ConfigureAndSavePresentation {
}
```

## 为什么在图表中使用图像标记?
`Aspose.Slides` 支持 **60+ 图表类型** 和 **100+ 图像格式**,让您可以将任意视觉图标与数据点配对。使用自定义图像标记在用户研究中可将数据可读性提升至 **35 %**,因为观众无需浏览图例即可立即将图标与其含义关联。

## 常见问题与故障排除
- **FileNotFoundException** – 验证图像路径`YOUR_DOCUMENT_DIRECTORY/...`是否正确且文件存在。
- **LicenseException** – 确保在生产环境调用任何 API 前已设置有效的 Aspose 许可证。
- **Marker Not Visible** – 增加 `setMarkerSize` 或使用更高分辨率的图像以获得更清晰的显示。
- **FileNotFoundException** – 验证图像路径 (`YOUR_DOCUMENT_DIRECTORY/...`) 是否正确且文件存在。
- **LicenseException** – 确保在生产环境调用任何 API 之前已设置有效的 Aspose 许可证。
- **Marker Not Visible** – 增大 `setMarkerSize` 或使用更高分辨率的图像以获得更清晰的显示。

## 常见问题
**Q: 我可以使用 PNG 图像而不是 JPEG 作为标记吗?**
A: 可以,任何 Aspose.Slides 支持的图像格式(PNG、JPEG、BMP、GIF)都可用作标记。

**问:我可以使用 PNG 图像而不是 JPEG 作为标记吗?**
**答:** 可以,任何 Aspose.Slides 支持的图像格式(PNG、JPEG、BMP、GIF)都可用作标记。

**问:Maven/Gradle 包需要许可证吗?**
**答:** 开发和测试阶段临时许可证即可;商业发布需要完整许可证。
**Q: Maven/Gradle 包需要许可证吗?**
A: 开发和测试阶段使用临时许可证即可;商业发布需要完整许可证。

**问:能否在同一系列的每个数据点使用不同的图像?**
**答:** 完全可以。在 `AddImageMarkers` 示例中我们在两张图片之间交替,但您可以为每个点加载唯一的图像。
**Q: 能否为同一系列的每个数据点添加不同的图像?**
A: 完全可以。在 `AddImageMarkers` 示例中我们交替使用两张图片,但您可以为每个点加载唯一的图像。

**问:`aspose slides maven dependency` 对项目大小有什么影响?**
**答:** Maven 包仅包含所选 JDK 版本所需的二进制文件,保持占用合理。如果对体积有顾虑,也可以使用 **no‑dependencies** 版本。
**Q: Aspose Slides Maven 依赖项对项目大小有何影响?**
A: Maven 包仅包含所选 JDK 版本所需的二进制文件,使体积保持在 **15 MB** 以下。如果对大小有顾虑,也可以使用 **no‑dependencies** 版本。

**问:支持哪些 Java 版本?**
**答:** Aspose.Slides for Java 支持 JDK 8 到 JDK 21。示例使用 JDK 16,您可以相应调整 classifier。
**Q: 支持哪些 Java 版本?**
A: Aspose.Slides for Java 支持 JDK 8 到 JDK 21。示例使用 JDK 16,您可以相应地调整 classifier。

## 结论
通过本指南,您现在了解了 **how to use Aspose** 为图表添加自定义图像标记,如何配置 **Aspose Slides Maven dependency**,以及如何 **add images to chart** 系列,以获得精致、专业的外观。尝试不同的图标、尺寸和图表类型,创建真正脱颖而出的演示文稿。
通过本指南,您现在了解**如何使用 Aspose Slides Maven 依赖项**为图表添加自定义图像标记,了解如何配置该依赖项,以及如何**向图表系列添加图像**以获得精致、专业的外观。尝试不同的图标、大小和图表类型,创建真正脱颖而出的演示文稿。

---

**最后更新:** 2026-01-11
**最后更新:** 2026-06-03
**测试环境:** Aspose.Slides for Java 25.4 (jdk16)
**作者:** Aspose

{{< blocks/products/products-backtop-button >}}

## 相关教程

- [使用 Aspose.Slides 在 Java 中创建图表 – 添加和验证图表](/slides/java/charts-graphs/aspose-slides-java-create-validate-charts/)
- [使用 Aspose.Slides for Java 创建带默认标记的折线图](/slides/java/charts-graphs/create-line-charts-aspose-slides-java/)
- [使用 Aspose.Slides Java 用自定义线条增强 PowerPoint 图表](/slides/java/charts-graphs/customize-powerpoint-charts-aspose-slides-java/)


{{< /blocks/products/pf/tutorial-page-section >}}

{{< /blocks/products/pf/main-container >}}

{{< /blocks/products/pf/main-wrap-class >}}

{{< blocks/products/products-backtop-button >}}
{{< /blocks/products/pf/main-wrap-class >}}
Loading