# ハイパーリンク

> Aspose.Slides for Java でハイパーリンクを追加および管理します。テキスト、シェイプ、画像にリンクし、PPT、PPTX、ODP のターゲットやアクションを Java のサンプルで設定します。

Source: https://docs.aspose.com/slides/ja/java/examples/elements/hyperlink/
Updated: 2026-02-19

この記事では、**Aspose.Slides for Java** を使用して、シェイプ上のハイパーリンクの追加、取得、削除、および更新方法を示します。

## **ハイパーリンクの追加**

外部サイトへリンクするハイパーリンクを持つ長方形シェイプを作成します。

```java
static void addHyperlink() {
    Presentation presentation = new Presentation();
    try {
        ISlide slide = presentation.getSlides().get_Item(0);

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
        shape.getTextFrame().setText("Aspose");

        IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
        IPortion textPortion = paragraph.getPortions().get_Item(0);
        textPortion.getPortionFormat().setHyperlinkClick(new Hyperlink("https://www.aspose.com"));
    } finally {
        presentation.dispose();
    }
}
```

## **ハイパーリンクの取得**

シェイプのテキスト部分からハイパーリンク情報を読み取ります。

```java
static void accessHyperlink() {
    Presentation presentation = new Presentation();
    try {
        ISlide slide = presentation.getSlides().get_Item(0);

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
        shape.getTextFrame().setText("Aspose");

        IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
        IPortion textPortion = paragraph.getPortions().get_Item(0);
        textPortion.getPortionFormat().setHyperlinkClick(new Hyperlink("https://www.aspose.com"));

        IHyperlink hyperlink = textPortion.getPortionFormat().getHyperlinkClick();
    } finally {
        presentation.dispose();
    }
}
```

## **ハイパーリンクの削除**

シェイプのテキストからハイパーリンクをクリアします。

```java
static void removeHyperlink() {
    Presentation presentation = new Presentation();
    try {
        ISlide slide = presentation.getSlides().get_Item(0);

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
        shape.getTextFrame().setText("Aspose");

        IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
        IPortion textPortion = paragraph.getPortions().get_Item(0);
        textPortion.getPortionFormat().setHyperlinkClick(new Hyperlink("https://www.aspose.com"));

        textPortion.getPortionFormat().setHyperlinkClick(null);
    } finally {
        presentation.dispose();
    }
}
```

## **ハイパーリンクの更新**

既存のハイパーリンクの対象を変更します。`HyperlinkManager` を使用して、すでにハイパーリンクが含まれるテキストを変更し、PowerPoint がハイパーリンクを安全に更新する方法を模倣します。

```java
static void updateHyperlink() {
    Presentation presentation = new Presentation();
    try {
        ISlide slide = presentation.getSlides().get_Item(0);

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
        shape.getTextFrame().setText("Aspose");

        IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
        IPortion textPortion = paragraph.getPortions().get_Item(0);
        textPortion.getPortionFormat().setHyperlinkClick(new Hyperlink("https://old.example.com"));

        // 既存のテキスト内のハイパーリンクを変更する場合は、 
        // プロパティを直接設定するのではなく、HyperlinkManager を使用すべきです。 
        // これは、PowerPoint がハイパーリンクを安全に更新する方法を模倣しています。 
        textPortion.getPortionFormat().getHyperlinkManager().setExternalHyperlinkClick("https://new.example.com");
    } finally {
        presentation.dispose();
    }
}
```