Zarządzanie hiperłączami w prezentacjach w .NET

Wprowadzenie

Hiperłącze jest odwołaniem do obiektu, danych lub miejsca w czymś. Są to typowe hiperłącza w prezentacjach PowerPoint:

• Linki do stron internetowych w tekście, kształtach lub mediach
• Linki do slajdów

Aspose.Slides dla .NET umożliwia wykonywanie wielu zadań związanych z hiperłączami w prezentacjach.

Możesz chcieć wypróbować prosty, darmowy edytor PowerPoint online.

Dodaj hiperłącza URL

Dodaj hiperłącza URL do tekstu

Ten kod C# pokazuje, jak dodać hiperłącze do strony internetowej w tekście:

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

Dodaj hiperłącza URL do kształtów lub ramek

Ten przykładowy kod w C# pokazuje, jak dodać hiperłącze do strony internetowej w kształcie:

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

Dodaj hiperłącza URL do multimediów

Aspose.Slides pozwala dodawać hiperłącza do plików obrazów, dźwięku i wideo.

Ten przykładowy kod pokazuje, jak dodać hiperłącze do obrazu:

using (Presentation pres = new Presentation())
{
    // Dodaje obraz do prezentacji
    IPPImage image = pres.Images.AddImage(File.ReadAllBytes("image.png"));
    // Tworzy ramkę obrazu na slajdzie 1 na podstawie wcześniej dodanego obrazu
    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);
}

Ten przykładowy kod pokazuje, jak dodać hiperłącze do pliku 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);
}

Ten przykładowy kod pokazuje, jak dodać hiperłącze do wideo:

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

Tip

Możesz chcieć zobaczyć Zarządzaj OLE.

Użyj hiperłączy do utworzenia spisu treści

Ponieważ hiperłącza pozwalają dodawać odwołania do obiektów lub miejsc, możesz ich używać do tworzenia spisu treści.

Ten przykładowy kod pokazuje, jak utworzyć spis treści z hiperłączami:

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

Formatuj hiperłącza

Kolor

Za pomocą właściwości ColorSource w interfejsie IHyperlink możesz ustawić kolor hiperłączy oraz pobrać informacje o kolorze z hiperłączy. Funkcja została po raz pierwszy wprowadzona w PowerPoint 2019, więc zmiany dotyczące tej właściwości nie mają zastosowania w starszych wersjach PowerPoint.

Ten przykładowy kod demonstruje operację, w której do tego samego slajdu dodano hiperłącza o różnych kolorach:

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

Dźwięk

Aspose.Slides udostępnia następujące właściwości, aby umożliwić podkreślenie hiperłącza dźwiękiem:

• IHyperlink.Sound
• IHyperlink.StopSoundOnClick

Dodaj dźwięk do hiperłącza

Ten kod C# pokazuje, jak ustawić hiperłącze odtwarzające dźwięk i zatrzymać je za pomocą innego hiperłącza:

using (Presentation pres = new Presentation())
{
	// Dodaje nowy dźwięk do kolekcji audio prezentacji
	IAudio playSound = pres.Audios.AddAudio(File.ReadAllBytes("sampleaudio.wav"));

	ISlide firstSlide = pres.Slides[0];

	// Dodaje nowy kształt z hiperłączem do następnego slajdu
	IShape firstShape = firstSlide.Shapes.AddAutoShape(ShapeType.SoundButton, 100, 100, 100, 50);
	firstShape.HyperlinkClick = Hyperlink.NextSlide;

	// Sprawdza hiperłącze pod kątem "No Sound"
	if (!firstShape.HyperlinkClick.StopSoundOnClick && firstShape.HyperlinkClick.Sound == null)
	{
		// Ustawia hiperłącze odtwarzające dźwięk
		firstShape.HyperlinkClick.Sound = playSound;
	}

	// Dodaje pusty slajd 
	ISlide secondSlide = pres.Slides.AddEmptySlide(firstSlide.LayoutSlide);

	// Dodaje nowy kształt z hiperłączem NoAction
	IShape secondShape = secondSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 100, 50);
	secondShape.HyperlinkClick = Hyperlink.NoAction;

	// Ustawia flagę hiperłącza "Stop previous sound"
	secondShape.HyperlinkClick.StopSoundOnClick = true;

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

Wyodrębnij dźwięk z hiperłącza

Ten kod C# pokazuje, jak wyodrębnić dźwięk użyty w hiperłączu:

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

	// Pobiera hiperłącze pierwszego kształtu
	IHyperlink link = firstSlide.Shapes[0].HyperlinkClick;

	if (link.Sound != null)
	{
		// Wyodrębnia dźwięk hiperłącza do tablicy bajtów
		byte[] audioData = link.Sound.BinaryData;
	}
}

Usuń hiperłącza z prezentacji

Usuń hiperłącza z tekstu

Ten kod C# pokazuje, jak usunąć hiperłącze z tekstu na slajdzie prezentacji:

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

Usuń hiperłącza z kształtów lub ramek

Ten kod C# pokazuje, jak usunąć hiperłącze z kształtu na slajdzie prezentacji:

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

Modyfikowalne hiperłącze

Klasa Hyperlink jest modyfikowalna. Dzięki tej klasie możesz zmieniać wartości następujących właściwości:

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

Fragment kodu pokazuje, jak dodać hiperłącze do slajdu i później edytować jego podpowiedź (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);
}

Obsługiwane właściwości w IHyperlinkQueries

Możesz uzyskać dostęp do IHyperlinkQueries z prezentacji, slajdu lub tekstu, dla którego zdefiniowano hiperłącze.

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

Klasa IHyperlinkQueries obsługuje następujące metody i właściwości:

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

FAQ

Jak mogę utworzyć wewnętrzną nawigację nie tylko do slajdu, ale do „sekcji” lub pierwszego slajdu sekcji?

Sekcje w PowerPoint są grupami slajdów; nawigacja technicznie celuje w konkretny slajd. Aby „nawigować do sekcji”, zazwyczaj linkuje się do jej pierwszego slajdu.

Czy mogę dołączyć hiperłącze do elementów slajdu głównego, aby działało na wszystkich slajdach?

Tak. Elementy slajdu głównego i układu obsługują hiperłącza. Takie linki pojawiają się na slajdach podrzędnych i są klikalne podczas prezentacji.

Czy hiperłącza będą zachowane przy eksportowaniu do PDF, HTML, obrazów lub wideo?

W PDF i HTML tak — linki są zazwyczaj zachowywane. Przy eksporcie do images i video klikalność nie zostanie przeniesiona ze względu na naturę tych formatów (klatki rastrowe/wideo nie obsługują hiperłączy).