.NET'te Sunum Köprülerini Yönetme

Giriş

Köprü, bir nesneye, veriye veya bir yere yapılan referanstır. Bunlar PowerPoint Sunumlarındaki yaygın köprülerdir:

Metinler, şekiller veya medya içinde web sitelerine bağlantılar
Slaytlara bağlantılar

Aspose.Slides for .NET, sunumlardaki köprülerle ilgili birçok görevi gerçekleştirmenizi sağlar.

Aspose Simple’i, ücretsiz çevrimiçi PowerPoint düzenleyicisini.

URL Köprüleri Ekleme

Metne URL Köprüsü Ekleme

Bu C# kodu, bir metne web sitesi köprüsü eklemenizi gösterir:

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

Şekillere veya Çerçevelere URL Köprüsü Ekleme

Bu C# örnek kodu, bir şekle web sitesi köprüsü eklemenizi gösterir:

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

Medya İçin URL Köprüsü Ekleme

Aspose.Slides, görsellere, ses ve video dosyalarına köprü eklemenize olanak tanır.

Bu örnek kod, bir görsele köprü eklemenizi gösterir:

using (Presentation pres = new Presentation())
{
    // Sunuma resim ekler
    IPPImage image = pres.Images.AddImage(File.ReadAllBytes("image.png"));
    // Daha önce eklenen resme dayalı olarak slayt 1'de resim çerçevesi oluşturur
    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);
}

Bu örnek kod, bir ses dosyasına köprü eklemenizi gösterir:

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

Bu örnek kod, bir video’ya köprü eklemenizi gösterir:

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

Şu belgeyi incelemek isteyebilirsiniz OLE Yönetimi.

Köprüleri İçindekiler Tablosu Oluşturmak İçin Kullanma

Köprüler nesnelere veya yerlere referans eklemenizi sağladığından, bunları bir içindekiler tablosu oluşturmak için kullanabilirsiniz.

Bu örnek kod, köprülerle bir içindekiler tablosu oluşturmanızı gösterir:

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

Köprüleri Biçimlendirme

Renk

IHyperlink arayüzündeki ColorSource özelliği sayesinde köprülerin rengini ayarlayabilir ve köprülerden renk bilgisini alabilirsiniz. Bu özellik PowerPoint 2019’da ilk kez sunulmuştur, bu yüzden özellikteki değişiklikler eski PowerPoint sürümlerine uygulanmaz.

Bu örnek kod, aynı slayta farklı renklerde köprüler eklenmesini gösterir:

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

Ses

Aspose.Slides, bir köprüyü sesle vurgulamanızı sağlayan şu özellikleri sunar:

Bir Köprüye Ses Ekleme

Bu C# kodu, bir ses çalan köprüyü ayarlamayı ve başka bir köprü ile durdurmayı gösterir:

using (Presentation pres = new Presentation())
{
	// Sunumun ses koleksiyonuna yeni ses ekler
	IAudio playSound = pres.Audios.AddAudio(File.ReadAllBytes("sampleaudio.wav"));

	ISlide firstSlide = pres.Slides[0];

	// Sonraki slayta yönlendiren köprü ile yeni şekil ekler
	IShape firstShape = firstSlide.Shapes.AddAutoShape(ShapeType.SoundButton, 100, 100, 100, 50);
	firstShape.HyperlinkClick = Hyperlink.NextSlide;

	// "Ses Yok" köprüsünü kontrol eder
	if (!firstShape.HyperlinkClick.StopSoundOnClick && firstShape.HyperlinkClick.Sound == null)
	{
		// Ses çalan köprüyü ayarlar
		firstShape.HyperlinkClick.Sound = playSound;
	}

	// Boş slaytı ekler 
	ISlide secondSlide = pres.Slides.AddEmptySlide(firstSlide.LayoutSlide);

	// NoAction köprüsü ile yeni şekil ekler
	IShape secondShape = secondSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 100, 50);
	secondShape.HyperlinkClick = Hyperlink.NoAction;

	// "Önceki sesi durdur" köprüsü bayrağını ayarlar
	secondShape.HyperlinkClick.StopSoundOnClick = true;

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

Bir Köprünün Sesini Çıkarma

Bu C# kodu, bir köprüde kullanılan sesi çıkarmayı gösterir:

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

	// İlk şeklin köprüsünü alır
	IHyperlink link = firstSlide.Shapes[0].HyperlinkClick;

	if (link.Sound != null)
	{
		// Köprü sesini bayt dizisi olarak çıkarır
		byte[] audioData = link.Sound.BinaryData;
	}
}

Sunumlardan Köprüleri Kaldırma

Metinden Köprüleri Kaldırma

Bu C# kodu, bir sunum slaydındaki metinden köprüyü kaldırmayı gösterir:

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

Şekillerden veya Çerçevelerden Köprüleri Kaldırma

Bu C# kodu, bir sunum slaydındaki şekilden köprüyü kaldırmayı gösterir:

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

Değiştirilebilir Köprü

Hyperlink sınıfı değiştirilebilirdir. Bu sınıfla, aşağıdaki özelliklerin değerlerini değiştirebilirsiniz:

Kod parçacığı, bir slayta köprü eklemeyi ve daha sonra araç ipucunu düzenlemeyi gösterir:

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

IHyperlinkQueries İçindeki Desteklenen Özellikler

Köprünün tanımlı olduğu sunum, slayt veya metinden IHyperlinkQueries’e erişebilirsiniz.

IHyperlinkQueries sınıfı şu yöntemleri ve özellikleri destekler:

SSS

Bir slayta değil, bir “bölüm”e veya bir bölümün ilk slaytına iç gezinme nasıl oluşturabilirim?

PowerPoint’teki bölümler, slaytların gruplarıdır; gezinme teknik olarak belirli bir slaytı hedefler. “Bir bölüme gezinmek” için genellikle o bölümün ilk slaytına bağlanırsınız.

Ana slayt öğelerine köprü ekleyebilir ve tüm slaytlarda işe yarar hale getirebilir miyim?

Evet. Ana slayt ve düzen öğeleri köprüleri destekler. Bu tür bağlantılar alt slaytlarda görünür ve sunum sırasında tıklanabilir.

Köprüler PDF, HTML, görüntüler veya video olarak dışa aktarıldığında korunur mu?

PDF ve HTML formatlarında, evet—bağlantılar genellikle korunur. Görüntüler ve video formatına dışa aktarıldığında, bu formatların doğası gereği (raster çerçeveler/video köprüleri desteklemez) tıklanabilirlik korunmaz.

Sunum BLOB'larını .NET'te Verimli Bellek Kullanımı İçin Yönetme .NET'te Medya Dosyalarını Yönet