Gerenciar Hiperlinks de Apresentação no Android

Introdução

Um hiperlink é uma referência a um objeto, a dados ou a um local em algo. Estes são hiperlinks comuns em apresentações do PowerPoint:

Links para sites dentro de textos, formas ou mídia
Links para slides

Aspose.Slides for Android via Java permite que você execute muitas tarefas envolvendo hiperlinks em apresentações.

Você pode querer conferir o simples Aspose, editor online gratuito de PowerPoint.

Adicionar Hiperlinks de URL

Adicionar Hiperlinks de URL ao Texto

Este código Java mostra como adicionar um hiperlink de site a um texto:

Presentation presentation = new Presentation();
try {
	IAutoShape shape1 = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);
	shape1.addTextFrame("Aspose: File Format APIs");
	
	IPortionFormat portionFormat = shape1.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat(); 
	portionFormat.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	portionFormat.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");
	portionFormat.setFontHeight(32);

	presentation.save("presentation-out.pptx", SaveFormat.Pptx);
} finally {
	if (presentation != null) presentation.dispose();
}

Adicionar Hiperlinks de URL a Formas ou Quadros

Este código de exemplo em Java mostra como adicionar um hiperlink de site a uma forma:

Presentation pres = new Presentation();
try {
	IShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50);

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

	pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Adicionar Hiperlinks de URL a Mídia

Aspose.Slides permite que você adicione hiperlinks a imagens, arquivos de áudio e vídeo.

Este código de exemplo mostra como adicionar um hiperlink a uma imagem:

Presentation pres = new Presentation();
try {
	// Adiciona imagem à apresentação
    IPPImage picture;
    IImage image = Images.fromFile("image.png");
    try {
    picture = pres.getImages().addImage(picture);
    } finally {
          if (image != null) image.dispose();
    }
	// Cria quadro de imagem no slide 1 com base na imagem adicionada anteriormente
	IPictureFrame pictureFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, picture);

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

	pres.save("pres-out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
	if (pres != null) pres.dispose();
}

Este código de exemplo mostra como adicionar um hiperlink a um arquivo de áudio:

Presentation pres = new Presentation();
try {
	IAudio audio = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("audio.mp3")));
	IAudioFrame audioFrame = pres.getSlides().get_Item(0).getShapes().addAudioFrameEmbedded(10, 10, 100, 100, audio);

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

	pres.save("pres-out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
	if (pres != null) pres.dispose();
}

Este código de exemplo mostra como adicionar um hiperlink a um vídeo:

Presentation pres = new Presentation();
try {
	IVideo video = pres.getVideos().addVideo(Files.readAllBytes(Paths.get("video.avi")));
	IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 100, 100, video);

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

	pres.save("pres-out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
	if (pres != null) pres.dispose();
}

Dica

Você pode querer ver Gerenciar OLE.

Usar Hiperlinks para Criar um Sumário

Como os hiperlinks permitem que você adicione referências a objetos ou locais, pode usá‑los para criar um sumário.

Este código de exemplo mostra como criar um sumário com hiperlinks:

Presentation pres = new Presentation();
try {
	ISlide firstSlide = pres.getSlides().get_Item(0);
	ISlide secondSlide = pres.getSlides().addEmptySlide(firstSlide.getLayoutSlide());

	IAutoShape contentTable = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 300, 100);
	contentTable.getFillFormat().setFillType(FillType.NoFill);
	contentTable.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
	contentTable.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);
	contentTable.getTextFrame().getParagraphs().add(paragraph);

	pres.save("link_to_slide.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Formatar Hiperlinks

Cor

Com a propriedade ColorSource na interface IHyperlink, você pode definir a cor dos hiperlinks e também obter as informações de cor dos hiperlinks. O recurso foi introduzido pela primeira vez no PowerPoint 2019, portanto as alterações envolvendo a propriedade não se aplicam a versões mais antigas do PowerPoint.

Este código de exemplo demonstra uma operação onde hiperlinks com cores diferentes foram adicionados ao mesmo slide:

Presentation pres = new Presentation();
try {
	IAutoShape shape1 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 450, 50, false);
	shape1.addTextFrame("This is a sample of colored hyperlink.");
	IPortionFormat portionFormat = shape1.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
	portionFormat.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	portionFormat.getHyperlinkClick().setColorSource(HyperlinkColorSource.PortionFormat);
	portionFormat.getFillFormat().setFillType(FillType.Solid);
	portionFormat.getFillFormat().getSolidFillColor().setColor(Color.RED);

	IAutoShape shape2 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 450, 50, false);
	shape2.addTextFrame("This is a sample of usual hyperlink.");
	shape2.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));

	pres.save("presentation-out-hyperlink.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Remover Hiperlinks de Apresentações

Remover Hiperlinks do Texto

Este código Java mostra como remover o hiperlink de um texto em um slide de apresentação:

Presentation pres = new Presentation();
try {
	ISlide slide = pres.getSlides().get_Item(0);
	for (IShape shape : slide.getShapes())
	{
		IAutoShape autoShape = (IAutoShape)shape;
		if (autoShape != null)
		{
			for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs())
			{
				for (IPortion portion : paragraph.getPortions())
				{
					portion.getPortionFormat().getHyperlinkManager().removeHyperlinkClick();
				}
			}
		}
	}

	pres.save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Remover Hiperlinks de Formas ou Quadros

Este código Java mostra como remover o hiperlink de uma forma em um slide de apresentação:

Presentation pres = new Presentation();
try {
	ISlide slide = pres.getSlides().get_Item(0);
	for (IShape shape : slide.getShapes())
	{
		shape.getHyperlinkManager().removeHyperlinkClick();
	}
	pres.save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Hiperlink Mutável

A classe Hyperlink é mutável. Com esta classe, você pode alterar os valores dessas propriedades:

O trecho de código mostra como adicionar um hiperlink a um slide e editar sua dica de ferramenta posteriormente:

Presentation pres = new Presentation();
try {
	IAutoShape shape1 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);
	shape1.addTextFrame("Aspose: File Format APIs");

	IPortionFormat portionFormat = shape1.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat(); 
	portionFormat.setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
	portionFormat.getHyperlinkClick().setTooltip("More than 70% Fortune 100 companies trust Aspose APIs");
	portionFormat.setFontHeight(32);

	pres.save("presentation-out.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

Propriedades Suportadas em IHyperlinkQueries

Você pode acessar IHyperlinkQueries a partir de uma apresentação, slide ou texto para o qual o hiperlink está definido.

A classe IHyperlinkQueries suporta estes métodos e propriedades:

Perguntas Frequentes

Como posso criar navegação interna não apenas para um slide, mas para uma “seção” ou o primeiro slide de uma seção?

Seções no PowerPoint são agrupamentos de slides; a navegação tecnicamente aponta para um slide específico. Para “navegar para uma seção”, normalmente você cria um link para o primeiro slide da seção.

Posso anexar um hiperlink a elementos do slide mestre para que ele funcione em todos os slides?

Sim. Elementos do slide mestre e de layout suportam hiperlinks. Esses links aparecem nos slides filhos e são clicáveis durante a apresentação.

Os hiperlinks serão preservados ao exportar para PDF, HTML, imagens ou vídeo?

Em PDF e HTML, sim — os links geralmente são preservados. Ao exportar para imagens e vídeo, a interatividade não será mantida devido à natureza desses formatos (quadros rasterizados/vídeo não suportam hiperlinks).

Gerenciar BLOBs de Apresentação no Android para Uso Eficiente de Memória Gerenciar acessibilidade de apresentações no Android