Adicionar ou remover hiperlinks do PowerPoint PPT em Java

Em vários casos, temos que inserir hiperlinks nas apresentações do PowerPoint, como para fornecer o URL de uma página da web. Você pode criar um hiperlink de texto, imagem, forma ou um elemento de mídia em slides do PowerPoint PPT. Neste artigo, você aprenderá como adicionar hiperlinks ao PowerPoint PPT/PPTX em Java. No final, também discutiremos como remover hiperlinks de slides PPT programaticamente.

Para inserir ou remover hiperlinks em apresentações do PowerPoint, usaremos Aspose.Slides for Java. A API fornece vários recursos para criar e manipular apresentações PPT/PPTX sem problemas. Além disso, permite converter as apresentações para outros formatos de documento ou imagem. Você pode baixar seu JAR ou instalá-lo usando as seguintes configurações do Maven.

Repositório:

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>

Dependência:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-slides</artifactId>
    <version>22.2</version>
    <classifier>jdk16</classifier>
</dependency>

O hiperlink nas apresentações do PowerPoint pode ser adicionado a um elemento de texto, imagem, forma, áudio ou vídeo. As seções a seguir abordam como adicionar hiperlinks a esses elementos em uma apresentação PPT/PPTX usando Java.

A seguir estão as etapas para adicionar um hiperlink de texto em um PowerPoint PPT/PPTX em Java.

O exemplo de código a seguir mostra como adicionar um hiperlink de texto em um PowerPoint PPTX usando Java.

// Criar apresentação
Presentation presentation = new Presentation();
try {
	// Adicionar uma forma automática
	IAutoShape shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100,
			100, 600, 50, false);
	
	// Adicionar hiperlink
	shape.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	shape.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");

	// Salvar apresentação
	presentation.save("add-text-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

As etapas a seguir demonstram como inserir um hiperlink de forma em uma apresentação do PowerPoint em Java.

O exemplo de código a seguir mostra como criar um hiperlink de forma no PowerPoint usando Java.

// Criar apresentação
Presentation presentation = new Presentation();
try {
	// Adicionar uma forma automática
	IAutoShape shape1 = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100,
			100, 600, 50, false);
	// Definir texto
	shape1.addTextFrame("Aspose: File Format APIs");

	// Obter formatação da parte do texto
	IPortionFormat portionFormat = shape1.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
			.getPortionFormat();
	
	// Adicionar hiperlink
	portionFormat.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	portionFormat.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");
	portionFormat.setFontHeight(32);

	// Salvar apresentação
	presentation.save("add-shape-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

A seguir estão as etapas para inserir um hiperlink de imagem em um PowerPoint PPT em Java.

O exemplo de código a seguir mostra como criar um hiperlink de uma imagem no PowerPoint usando Java.

// Criar apresentação
Presentation presentation = new Presentation();
try {
	// Adicionar imagem à apresentação
	IPPImage image = presentation.getImages().addImage(Files.readAllBytes(Paths.get("image.png")));
	
	// Criar moldura no slide 1 com base na imagem adicionada anteriormente
	IPictureFrame pictureFrame = presentation.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, image);

	// Criar hiperlink
	pictureFrame.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	pictureFrame.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");

	// Salvar apresentação
	presentation.save("add-image-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

Você pode adicionar um hiperlink de áudio a um PowerPoint PPT/PPTX seguindo as etapas abaixo:

O trecho de código a seguir demonstra como adicionar um hiperlink de áudio no PowerPoint em Java.

// Criar apresentação
Presentation presentation = new Presentation();
try {
	// Adicionar um elemento de áudio
	IAudio audio = presentation.getAudios().addAudio(Files.readAllBytes(Paths.get("audio.mp3")));
	IAudioFrame audioFrame = presentation.getSlides().get_Item(0).getShapes().addAudioFrameEmbedded(10, 10, 100, 100, audio);

	// Criar hiperlink
	audioFrame.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	audioFrame.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");

	// Salvar apresentação
	presentation.save("add-audio-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

Para adicionar um hiperlink de vídeo a um PowerPoint PPT/PPTX, siga as etapas abaixo:

O trecho de código a seguir demonstra como adicionar um hiperlink de vídeo no PowerPoint em Java:

// Criar apresentação
Presentation presentation = new Presentation();
try {
	// Adicionar vídeo
	IVideo video = presentation.getVideos().addVideo(Files.readAllBytes(Paths.get("video.avi")));
	IVideoFrame videoFrame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 100, 100, video);

	// Criar hiperlink
	videoFrame.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	videoFrame.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");

	// Salvar apresentação
	presentation.save("add-video-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

Nesta seção, demonstraremos como remover os hiperlinks de um slide do PowerPoint. Esses hiperlinks podem ser de qualquer tipo que discutimos acima. A seguir estão as etapas para realizar esta operação.

O exemplo de código a seguir mostra como remover hiperlinks de um slide no PowerPoint PPT em Java.

// Carregar apresentação
Presentation presentation = new Presentation("presentation.pptx");
try {
	// Remover hiperlink do texto
	ISlide slide = presentation.getSlides().get_Item(0);
	for (IShape shape : slide.getShapes())
	{
		// Transmitir para IAutoShape
		IAutoShape autoShape = (IAutoShape)shape;
		if (autoShape != null)
		{
			// Percorrer os parágrafos
			for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs())
			{
				// Percorrer porções de texto
				for (IPortion portion : paragraph.getPortions())
				{
					portion.getPortionFormat().getHyperlinkManager().removeHyperlinkClick();
				}
			}
		}
	}
	
	// Remover hiperlink das formas
	for (IShape shape : slide.getShapes())
	{
		shape.getHyperlinkManager().removeHyperlinkClick();
	}

	// Salvar apresentação
	presentation.save("remove-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null)
		presentation.dispose();
}

Obtenha uma licença gratuita

Use o Aspose.Slides for Java sem limitações de avaliação obtendo uma licença temporária gratuita.

Conclusão

Neste artigo, você aprendeu como adicionar ou remover hiperlinks no PowerPoint PPT em Java. Particularmente, você viu como fazer hiperlinks de elementos de texto, imagem, forma, áudio e vídeo. Além disso, abordamos como remover hiperlinks de texto ou forma explicitamente. Além disso, você pode explorar mais sobre o Aspose.Slides for Java visitando a documentação. Além disso, você pode postar suas dúvidas em nosso fórum.

Veja também