Hiperlinks em documentos são usados para navegar de um local para outro. Geralmente, em apresentações do PowerPoint, eles são usados para inserir URLs de páginas 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 C#. Além disso, abordaremos como remover hiperlinks de slides PPT programaticamente.
- API .NET para trabalhar com hiperlinks no PowerPoint
- Adicionar um hiperlink no PowerPoint PPT/PPTX
- Remover hiperlinks do PowerPoint PPT
API C# .NET para adicionar ou remover hiperlinks no PowerPoint PPT
Para trabalhar com hiperlinks em apresentações do PowerPoint, usaremos Aspose.Slides for .NET. É uma API popular que é usada para criar e modificar apresentações PPT/PPTX. Além disso, permite converter as apresentações para outros formatos populares. Você pode baixar sua DLL ou instalá-la de NuGet.
PM> Install-Package Aspose.Slides.NET
Adicionar um hiperlink no PowerPoint PPT/PPTX em C#
Você pode adicionar diferentes tipos de hiperlinks em apresentações do PowerPoint usando Aspose.Slides para .NET. O hiperlink pode ser um elemento de texto, imagem, forma, áudio ou vídeo. Nas seções a seguir, abordaremos como adicionar todos esses hiperlinks em uma apresentação PPT/PPTX.
Adicionar hiperlink de texto no PowerPoint PPT
A seguir estão as etapas para adicionar um hiperlink de texto em um PowerPoint PPT/PPTX em C#.
- Primeiro, carregue o arquivo de apresentação ou crie um novo usando a classe Apresentação.
- Em seguida, adicione uma forma automática retangular à coleção de formas usando o método ISlide.Shapes.AddAutoShape(ShapeType, single, single, single, single).
- Adicione texto à forma usando o método IAutoShape.AddTextFrame(string).
- Crie um hiperlink usando a propriedade IAutoShape.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick.
- Defina outras propriedades do hiperlink, como dica de ferramenta.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como adicionar um hiperlink de texto em um PowerPoint PPTX usando C#.
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Criar uma forma automática para texto
IAutoShape shape1 = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);
// Definir texto
shape1.AddTextFrame("Aspose: File Format APIs");
// Definir hiperlink
shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";
shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FontHeight = 32;
// Salvar apresentação
presentation.Save("text-hyperlink.pptx", SaveFormat.Pptx);
}
Inserir um hiperlink de forma no PowerPoint
As etapas a seguir demonstram como inserir um hiperlink de forma em uma apresentação do PowerPoint em C#.
- Primeiro, carregue o arquivo de apresentação ou crie um novo usando a classe Apresentação.
- Em seguida, adicione uma forma automática do tipo desejado usando o método ISlide.Shapes.AddAutoShape(ShapeType, single, single, single, single).
- Crie um hiperlink usando a propriedade IAutoShape.HyperlinkClick.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como criar um hiperlink de forma no PowerPoint usando C#.
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Criar uma forma automática
IShape shape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 600, 50);
// Criar hiperlink
shape.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
shape.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";
// Salvar apresentação
presentation.Save("shape-hyperlink.pptx", SaveFormat.Pptx);
}
Inserir um hiperlink de imagem no PowerPoint
A seguir estão as etapas para inserir um hiperlink de imagem em um PowerPoint PPT em C#.
- Primeiro, carregue o arquivo de apresentação ou crie um novo usando a classe Apresentação.
- Em seguida, adicione a imagem à coleção usando o método Presentation.Images.AddImage().
- Adicione o quadro de imagem ao slide desejado usando o método Presentation.Slides[index].Shapes.AddPictureFrame().
- Crie um hiperlink definindo a propriedade IPictureFrame.HyperlinkClick.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como criar um hiperlink de uma imagem no PowerPoint usando C#.
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Adicionar imagem à apresentação
IPPImage image = presentation.Images.AddImage(File.ReadAllBytes("image.png"));
// Criar moldura no slide 1 com base na imagem adicionada anteriormente
IPictureFrame pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, image);
// Criar hiperlink
pictureFrame.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
pictureFrame.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";
// Salvar apresentação
presentation.Save("image-hyperlink.pptx", SaveFormat.Pptx);
}
Adicionar um hiperlink de áudio em PPT
Você pode adicionar um hiperlink de áudio a um PowerPoint PPT/PPTX seguindo as etapas abaixo:
- Primeiro, carregue o arquivo de apresentação ou crie um novo usando a classe Apresentação.
- Em seguida, adicione áudio à coleção usando o método Presentation.Audios.AddAudio().
- Depois disso, adicione o quadro de áudio ao slide desejado usando o método Presentation.Slides[index].Shapes.AddAudioFrameEmbedded().
- Crie um hiperlink definindo a propriedade IAudioFrame.HyperlinkClick.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O trecho de código a seguir demonstra como adicionar um hiperlink de áudio no PowerPoint em C#:
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Inserir áudio
IAudio audio = presentation.Audios.AddAudio(File.ReadAllBytes("audio.mp3"));
IAudioFrame audioFrame = presentation.Slides[0].Shapes.AddAudioFrameEmbedded(10, 10, 100, 100, audio);
// Criar hiperlink
audioFrame.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
audioFrame.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";
// Salvar apresentação
presentation.Save("audio-hyperlink.pptx", SaveFormat.Pptx);
}
Adicionar um hiperlink de vídeo no PowerPoint PPT
Para adicionar um hiperlink de vídeo a um PowerPoint PPT/PPTX, siga as etapas abaixo:
- Primeiro, carregue o arquivo de apresentação ou crie um novo usando a classe Apresentação.
- Em seguida, adicione o vídeo à coleção usando o método Presentation.Videos.AddVideo().
- Adicione o quadro de vídeo ao slide desejado usando o método Presentation.Slides[index].Shapes.AddVideoFrame().
- Crie um hiperlink definindo a propriedade IPoFrame.HyperlinkClick.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O trecho de código a seguir demonstra como adicionar um hiperlink de vídeo no PowerPoint em C#:
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Inserir vídeo
IVideo video = presentation.Videos.AddVideo(File.ReadAllBytes("wildlife.mp4"));
IVideoFrame videoFrame = presentation.Slides[0].Shapes.AddVideoFrame(10, 10, 100, 100, video);
// Criar hiperlink
videoFrame.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
videoFrame.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";
// Salvar apresentação
presentation.Save("video-hyperlink.pptx", SaveFormat.Pptx);
}
Remover hiperlinks do PowerPoint PPT em C#
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.
- Primeiro, carregue o arquivo de apresentação usando a classe Apresentação.
- Em seguida, percorra todas as formas no slide usando a coleção ISlide.Shapes.
- Depois disso, remova o hiperlink da forma usando o método IShape.HyperlinkManager.RemoveHyperlinkClick().
- Para remover hiperlinks de texto, converta a forma em IAutoShape.
- Percorra os parágrafos da forma.
- Faça um loop pelas partes de texto de cada parágrafo.
- Remova o hiperlink de texto usando o método IPortion.PortionFormat.HyperlinkManager.RemoveHyperlinkClick().
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como remover hiperlinks de um slide no PowerPoint PPT em C#.
// Carregar apresentação
using (Presentation presentation = new Presentation("text-hyperlink.pptx"))
{
// Obter referência do slide
ISlide slide = presentation.Slides[0];
// Loop através da forma
foreach (IShape shape in slide.Shapes)
{
// Remova o hiperlink se for aplicado à forma
shape.HyperlinkManager.RemoveHyperlinkClick();
// Prossiga para remover o hiperlink do texto
IAutoShape autoShape = shape as IAutoShape;
if (autoShape != null)
{
foreach (IParagraph paragraph in autoShape.TextFrame.Paragraphs)
{
foreach (IPortion portion in paragraph.Portions)
{
portion.PortionFormat.HyperlinkManager.RemoveHyperlinkClick();
}
}
}
}
// Salvar apresentação
presentation.Save("remove-hyperlinks.pptx", SaveFormat.Pptx);
}
Obtenha uma licença gratuita
Use Aspose.Slides para .NET 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 C#. Além disso, abordamos como criar hiperlinks de elementos de texto, imagem, forma, áudio e vídeo. Além disso, você pode explorar mais sobre o Aspose.Slides for .NET visitando a documentação. Além disso, você pode postar suas dúvidas em nosso fórum.