Gestire i collegamenti ipertestuali delle presentazioni in .NET

Introduzione

Un collegamento ipertestuale è un riferimento a un oggetto, a dati o a un luogo in qualcosa. Questi sono collegamenti ipertestuali comuni nelle presentazioni PowerPoint:

• Collegamenti a siti web all’interno di testi, forme o media
• Collegamenti a diapositive

Aspose.Slides per .NET consente di eseguire molte operazioni sui collegamenti ipertestuali nelle presentazioni.

Potresti voler provare Aspose semplice, editor online gratuito di PowerPoint.

Aggiungere collegamenti ipertestuali URL

Aggiungere collegamenti ipertestuali URL al testo

Questo codice C# mostra come aggiungere un collegamento ipertestuale a un sito web in un testo:

using (Presentation presentation = new Presentation())
{
	IAutoShape shape1 = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);
	shape1.AddTextFrame("Aspose: File Format APIs");
	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;

	presentation.Save("presentation-out.pptx", SaveFormat.Pptx);
}

Aggiungere collegamenti ipertestuali URL a forme o cornici

Questo esempio di codice in C# mostra come aggiungere un collegamento ipertestuale a un sito web a una forma:

using (Presentation pres = new Presentation())
{
    IShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 600, 50);
    
    shape.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
    shape.HyperlinkClick.Tooltip = "More than 70% Fortune 100 companies trust Aspose APIs";

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

Aggiungere collegamenti ipertestuali URL a media

Aspose.Slides consente di aggiungere collegamenti ipertestuali a immagini, audio e video.

Questo esempio di codice mostra come aggiungere un collegamento ipertestuale a un immagine:

using (Presentation pres = new Presentation())
{
    // Aggiunge immagine alla presentazione
    IPPImage image = pres.Images.AddImage(File.ReadAllBytes("image.png"));
    // Crea un frame immagine sulla diapositiva 1 basato sull'immagine aggiunta in precedenza
    IPictureFrame pictureFrame = pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, image);

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

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

Questo esempio di codice mostra come aggiungere un collegamento ipertestuale a un file audio:

using (Presentation pres = new Presentation())
{
    IAudio audio = pres.Audios.AddAudio(File.ReadAllBytes("audio.mp3"));
    IAudioFrame audioFrame = pres.Slides[0].Shapes.AddAudioFrameEmbedded(10, 10, 100, 100, audio);

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

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

Questo esempio di codice mostra come aggiungere un collegamento ipertestuale a un video:

using (Presentation pres = new Presentation())
{
    IVideo video = pres.Videos.AddVideo(File.ReadAllBytes("video.avi"));
    IVideoFrame videoFrame = pres.Slides[0].Shapes.AddVideoFrame(10, 10, 100, 100, video);

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

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

Suggerimento

Potresti voler vedere Gestire OLE.

Usare i collegamenti ipertestuali per creare un indice

Poiché i collegamenti ipertestuali consentono di aggiungere riferimenti a oggetti o luoghi, è possibile usarli per creare un indice.

Questo esempio di codice mostra come creare un indice con collegamenti ipertestuali:

using (var presentation = new Presentation())
{
    var firstSlide = presentation.Slides[0];
    var secondSlide = presentation.Slides.AddEmptySlide(firstSlide.LayoutSlide);

    var contentTable = firstSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 300, 100);
    contentTable.FillFormat.FillType = FillType.NoFill;
    contentTable.LineFormat.FillFormat.FillType = FillType.NoFill;
    contentTable.TextFrame.Paragraphs.Clear();

    var paragraph = new Paragraph();
    paragraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    paragraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    paragraph.Text = "Title of slide 2 .......... ";

    var linkPortion = new Portion();
    linkPortion.Text = "Page 2";
    linkPortion.PortionFormat.HyperlinkManager.SetInternalHyperlinkClick(secondSlide);

    paragraph.Portions.Add(linkPortion);
    contentTable.TextFrame.Paragraphs.Add(paragraph);

    presentation.Save("link_to_slide.pptx", SaveFormat.Pptx);
}

Formattare i collegamenti ipertestuali

Colore

Con la proprietà ColorSource nell’interfaccia IHyperlink, è possibile impostare il colore per i collegamenti ipertestuali e anche ottenere le informazioni sul colore dai collegamenti stessi. La funzionalità è stata introdotta per la prima volta in PowerPoint 2019, quindi le modifiche alla proprietà non si applicano alle versioni precedenti di PowerPoint.

Questo esempio di codice dimostra un’operazione in cui collegamenti ipertestuali con colori diversi sono stati aggiunti alla stessa diapositiva:

using (Presentation presentation = new Presentation())
{
    IAutoShape shape1 = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 450, 50, false);
    shape1.AddTextFrame("This is a sample of colored hyperlink.");
    shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick = new Hyperlink("https://www.aspose.com/");
    shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick.ColorSource = HyperlinkColorSource.PortionFormat;
    shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FillFormat.FillType = FillType.Solid;
    shape1.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FillFormat.SolidFillColor.Color = Color.Red;

    IAutoShape shape2 = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 200, 450, 50, false);
    shape2.AddTextFrame("This is a sample of usual hyperlink.");
    shape2.TextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkClick = new Hyperlink("https://www.aspose.com/");

    presentation.Save("presentation-out-hyperlink.pptx", SaveFormat.Pptx);
}

Suono

Aspose.Slides fornisce queste proprietà per consentire di enfatizzare un collegamento ipertestuale con un suono:

• IHyperlink.Sound
• IHyperlink.StopSoundOnClick

Aggiungere un suono al collegamento ipertestuale

Questo codice C# mostra come impostare il collegamento ipertestuale che riproduce un suono e lo interrompe con un altro collegamento:

using (Presentation pres = new Presentation())
{
	// Aggiunge nuovo audio alla collezione audio della presentazione
	IAudio playSound = pres.Audios.AddAudio(File.ReadAllBytes("sampleaudio.wav"));

	ISlide firstSlide = pres.Slides[0];

	// Aggiunge una nuova forma con il collegamento ipertestuale alla diapositiva successiva
	IShape firstShape = firstSlide.Shapes.AddAutoShape(ShapeType.SoundButton, 100, 100, 100, 50);
	firstShape.HyperlinkClick = Hyperlink.NextSlide;

	// Verifica il collegamento ipertestuale per "No Sound"
	if (!firstShape.HyperlinkClick.StopSoundOnClick && firstShape.HyperlinkClick.Sound == null)
	{
		// Imposta il collegamento ipertestuale che riproduce il suono
		firstShape.HyperlinkClick.Sound = playSound;
	}

	// Aggiunge la diapositiva vuota 
	ISlide secondSlide = pres.Slides.AddEmptySlide(firstSlide.LayoutSlide);

	// Aggiunge una nuova forma con il collegamento ipertestuale NoAction
	IShape secondShape = secondSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 100, 50);
	secondShape.HyperlinkClick = Hyperlink.NoAction;

	// Imposta il flag "Stop previous sound" del collegamento ipertestuale
	secondShape.HyperlinkClick.StopSoundOnClick = true;

	pres.Save("hyperlink-sound.pptx", SaveFormat.Pptx);
}

Estrarre un suono da un collegamento ipertestuale

Questo codice C# mostra come estrarre il suono utilizzato in un collegamento ipertestuale:

using (Presentation pres = new Presentation("hyperlink-sound.pptx"))
{
	ISlide firstSlide = pres.Slides[0];

	// Ottiene il collegamento ipertestuale della prima forma
	IHyperlink link = firstSlide.Shapes[0].HyperlinkClick;

	if (link.Sound != null)
	{
		// Estrae il suono del collegamento ipertestuale in un array di byte
		byte[] audioData = link.Sound.BinaryData;
	}
}

Rimuovere i collegamenti ipertestuali dalle presentazioni

Rimuovere i collegamenti ipertestuali dal testo

Questo codice C# mostra come rimuovere il collegamento ipertestuale da un testo in una diapositiva della presentazione:

using (Presentation pres = new Presentation("pres.pptx"))
{
    ISlide slide = pres.Slides[0];
    foreach (IShape shape in slide.Shapes)
    {
        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();
                }
            }
        }
    }
    
    pres.Save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx);
}

Rimuovere i collegamenti ipertestuali da forme o cornici

Questo codice C# mostra come rimuovere il collegamento ipertestuale da una forma in una diapositiva della presentazione:

using (Presentation pres = new Presentation("demo.pptx")) 
{ 
   ISlide slide = pres.Slides[0]; 
   foreach (IShape shape in slide.Shapes) 
     { 
       shape.HyperlinkManager.RemoveHyperlinkClick(); 
     } 
   pres.Save("pres-removed-hyperlinks.pptx", SaveFormat.Pptx); 
}

Collegamento ipertestuale mutabile

La classe Hyperlink è mutabile. Con questa classe è possibile modificare i valori di queste proprietà:

• IHyperlink.TargetFrame
• IHyperlink.Tooltip
• IHyperlink.History
• IHyperlink.HighlightClick

Lo snippet di codice mostra come aggiungere un collegamento ipertestuale a una diapositiva e modificarne in seguito il tooltip:

using (Presentation presentation = new Presentation())
{   
   IAutoShape shape1 = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 600, 50, false);    
    
   shape1.AddTextFrame("Aspose: File Format APIs");
    
   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;
    
 presentation.Save("presentation-out.pptx", SaveFormat.Pptx);
}

Proprietà supportate in IHyperlinkQueries

È possibile accedere a IHyperlinkQueries da una presentazione, diapositiva o testo per cui è definito il collegamento ipertestuale.

• IPresentation.HyperlinkQueries
• IBaseSlide.HyperlinkQueries
• ITextFrame.HyperlinkQueries

La classe IHyperlinkQueries supporta questi metodi e proprietà:

• IHyperlinkQueries.GetHyperlinkClicks();
• IHyperlinkQueries.GetHyperlinkMouseOvers();
• IHyperlinkQueries.GetAnyHyperlinks();
• IHyperlinkQueries.RemoveAllHyperlinks();

FAQ

Come posso creare una navigazione interna non solo a una diapositiva, ma a una “sezione” o alla prima diapositiva di una sezione?

Le sezioni in PowerPoint sono raggruppamenti di diapositive; la navigazione tecnicamente punta a una diapositiva specifica. Per “navigare a una sezione”, di solito si collega alla sua prima diapositiva.

Posso collegare un collegamento ipertestuale agli elementi della diapositiva master in modo che funzioni su tutte le diapositive?

Sì. Gli elementi della diapositiva master e del layout supportano i collegamenti ipertestuali. Tali collegamenti appaiono sulle diapositive figlie e sono cliccabili durante la presentazione.

I collegamenti ipertestuali saranno preservati durante l’esportazione in PDF, HTML, immagini o video?

In PDF e HTML, sì: i collegamenti sono generalmente conservati. Durante l’esportazione in immagini e video, la cliccabilità non verrà mantenuta a causa della natura di quei formati (fotogrammi raster/video non supportano collegamenti ipertestuali).