Python ile Sunumlarda Çizim Kılavuzlarını Yönet

Bu sayfa ne hakkında

Aspose.Slides for Python via Java kullanarak PowerPoint sunumlarında yatay ve dikey çizim kılavuzlarını ekleyin, erişin ve temizleyin.

Genel Bakış

Çizim kılavuzları, PowerPoint’te bir sunumu düzenlerken şekilleri tutarlı bir şekilde hizalamaya yardımcı olan ayarlanabilir yatay ve dikey çizgilerdir. Özellikle bir uygulama, daha sonra manuel olarak iyileştirilecek bir sunum ürettiğinde faydalıdır: uygulama, yazarların içerik eklerken veya taşırken takip etmeleri gereken aynı hizalama yardımcılarını kaydedebilir.

Çizim kılavuzları düzenleme yardımcılarıdır, slayt içeriği değildir. Slayt gösterisinde veya oluşturulan çıktıda görünmezler. Aspose.Slides for Python via Java, bunları DrawingGuidesCollection sınıfı aracılığıyla sunar. Bir kılavuz, DrawingGuide ile temsil edilir ve bir yönelim, bir konum ve bir renge sahiptir.

Konum, ilgili slayt veya master’ın sol üst köşesinden ölçülen puan cinsindendir. Dikey bir kılavuz, genellikle sıfır ile slayt genişliği arasında bir yatay koordinat kullanır. Yatay bir kılavuz, genellikle sıfır ile slayt yüksekliği arasında bir dikey koordinat kullanır.

Slayt Görünümüne Kılavuz Ekleme

Normal slaytları düzenlerken görüntülenen kılavuzları yönetmek için CommonSlideViewProperties.getDrawingGuides kullanın. DrawingGuidesCollection.add metodunu bir Orientation değeri ve puan cinsinden bir konum ile çağırın.

Aşağıdaki örnek, slayt ortasının sağında bir dikey kılavuz ve altında bir yatay kılavuz ekler:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Orientation, SaveFormat

presentation = Presentation()
try:
    slide_size = presentation.getSlideSize().getSize()
    guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides()

    guides.add(Orientation.Vertical, slide_size.getWidth() / 2 + 12.5)
    guides.add(Orientation.Horizontal, slide_size.getHeight() / 2 + 12.5)

    presentation.save("drawing-guides.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Çizim Kılavuzlarına Erişim

Mevcut kılavuzlara erişmek için DrawingGuidesCollection.getCount ve DrawingGuidesCollection.get_Item metodlarını kullanın. DrawingGuide.getOrientation, DrawingGuide.getPosition ve DrawingGuide.getColor metodları değer döndürür; bu değerler ilgili ayarlayıcı metodlar kullanılarak da değiştirilebilir.

Aşağıdaki örnek, yukarıda oluşturulan sunumun slayt‑görünüm kılavuzlarını okur:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("drawing-guides.pptx")
try:
    guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides()

    for index in range(guides.getCount()):
        guide = guides.get_Item(index)
        print(f"Guide {index}: orientation = {guide.getOrientation()}, position = {guide.getPosition()}, color = {guide.getColor()}")
finally:
    presentation.dispose()

Master ve Layout Slaytlarına Kılavuz Ekleme

Bir slide master ve her bir layout slaytı kendi çizim‑kılavuz koleksiyonlarına sahip olabilir. Master slayt için MasterSlide.getDrawingGuides, layout slayt için ise LayoutSlide.getDrawingGuides kullanın.

Aşağıdaki örnek, ilk master slayta bir dikey kılavuz ve ilk layout slayta bir yatay kılavuz ekler:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Orientation, SaveFormat

presentation = Presentation()
try:
    slide_size = presentation.getSlideSize().getSize()
    master_guides = presentation.getMasters().get_Item(0).getDrawingGuides()
    layout_guides = presentation.getLayoutSlides().get_Item(0).getDrawingGuides()

    master_guides.add(Orientation.Vertical, slide_size.getWidth() / 2 - 20)
    layout_guides.add(Orientation.Horizontal, slide_size.getHeight() / 2 + 20)

    presentation.save("master-layout-drawing-guides.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Not ve El Kitabı Masterlarına Kılavuz Ekleme

Not masterları ve el kitabı masterları da çizim kılavuzlarını destekler. Kolleksiyonlarına erişmek için MasterNotesSlide.getDrawingGuides ve MasterHandoutSlide.getDrawingGuides kullanın. Bir sunum bu masterlardan birini içermiyorsa, MasterNotesSlideManager.setDefaultMasterNotesSlide veya MasterHandoutSlideManager.setDefaultMasterHandoutSlide varsayılan masterı oluşturur ve döndürür.

Aşağıdaki örnek, bir not masterına bir yatay kılavuz ve bir el kitabı masterına bir dikey kılavuz ekler:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Orientation, SaveFormat

presentation = Presentation()
try:
    notes_size = presentation.getNotesSize().getSize()
    notes_master = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide()
    handout_master = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide()

    notes_master.getDrawingGuides().add(Orientation.Horizontal, notes_size.getHeight() / 2 + 50)
    handout_master.getDrawingGuides().add(Orientation.Vertical, notes_size.getWidth() / 2 - 50)

    presentation.save("notes-handout-drawing-guides.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Çizim Kılavuzlarını Temizleme

Belirli bir koleksiyondaki tüm kılavuzları kaldırmak için DrawingGuidesCollection.clear metodunu çağırın. Bir koleksiyonun temizlenmesi, başka bir kapsamda depolanan kılavuzları etkilemez.

Aşağıdaki örnek, slayt‑görünüm kılavuzlarını ve slayt masterları, layout slaytlar, not master ve el kitabı masterındaki tüm kılavuzları eksik masterlar oluşturmadan temizler:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation-with-guides.pptx")
try:
    presentation.getViewProperties().getSlideViewProperties().getDrawingGuides().clear()

    for master_slide in presentation.getMasters():
        master_slide.getDrawingGuides().clear()

    for layout_slide in presentation.getLayoutSlides():
        layout_slide.getDrawingGuides().clear()

    notes_master = presentation.getMasterNotesSlideManager().getMasterNotesSlide()
    if notes_master is not None:
        notes_master.getDrawingGuides().clear()

    handout_master = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide()
    if handout_master is not None:
        handout_master.getDrawingGuides().clear()

    presentation.save("presentation-without-guides.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

SSS

Çizim kılavuzları slayt gösterisinde veya dışa aktarılan görüntülerde görünür mü?

Hayır. Çizim kılavuzları, düzenleme için hizalama yardımcılarıdır ve sunum içeriği olarak işlenmez.

Bir çizim kılavuzu doğrudan bireysel normal bir slayta eklenebilir mi?

Normal slayt düzenleme kılavuzları, sunumun slayt‑görünüm özelliklerinde depolanır. Slide masterları, layout slaytlar, not masterları ve el kitabı masterları için ayrı kılavuz koleksiyonları mevcuttur.

Kılavuz konumları için hangi birimler kullanılır?

Konumlar puan cinsinden belirtilir; 72 puan bir inçtir. Dikey konumlar sol kenardan, yatay konumlar üst kenardan ölçülür.

Çizim kılavuzlarını temizlemek şekilleri veya slayt içeriğini değiştirir mi?

Hayır. DrawingGuidesCollection.clear metodu yalnızca seçilen koleksiyondaki kılavuzları kaldırır. Şekiller ve diğer slayt içeriği değişmeden kalır.