Adicionar ou remover hiperlinks do PowerPoint PPT em C#

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.

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 

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.

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

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);
}

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

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);
}

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

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);
}

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 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);
}

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 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);
}

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 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.

Veja também