Správa kreslicích vodítek v prezentacích v Pythonu

O čem je tato stránka

Přidejte, přistupujte k a odstraňte vodorovná a svislá kreslicí vodítka v PowerPoint prezentacích pomocí Aspose.Slides pro Python prostřednictvím Javy.

Přehled

Kreslicí vodítka jsou nastavitelná vodorovná a svislá čáry, které uživatelům pomáhají konzistentně zarovnávat tvary při úpravě prezentace v aplikaci PowerPoint. Jsou zvláště užitečná, když aplikace generuje prezentaci, která bude později manuálně upravována: aplikace může uložit stejné zarovnávací pomůcky, které by autoři měli následovat při přidávání nebo přesouvání obsahu.

Kreslicí vodítka jsou pomůcky pro úpravy, nikoli obsah snímku. Neobjevují se v prezentaci ani ve vykresleném výstupu. Aspose.Slides for Python via Java je vystavuje prostřednictvím třídy DrawingGuidesCollection . Vodítko je reprezentováno třídou DrawingGuide a má orientaci, pozici a barvu.

Pozice se měří v bodech od levého horního rohu příslušného snímku nebo masteru. Svislé vodítko používá horizontální souřadnici, obvykle mezi nulou a šířkou snímku. Vodorovné vodítko používá vertikální souřadnici, obvykle mezi nulou a výškou snímku.

Přidat vodítka do zobrazení snímku

Použijte CommonSlideViewProperties.getDrawingGuides k řízení vodítek zobrazovaných při úpravě běžných snímků. Zavolejte DrawingGuidesCollection.add s hodnotou Orientation a pozicí v bodech.

Následující příklad přidá jedno svislé vodítko napravo od středu snímku a jedno vodorovné vodítko pod ním:

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()

Přístup ke kreslicím vodítkům

Metody DrawingGuidesCollection.getCount a DrawingGuidesCollection.get_Item poskytují přístup k existujícím vodítkům. Metody DrawingGuide.getOrientation, DrawingGuide.getPosition a DrawingGuide.getColor vrací hodnoty, které lze také změnit pomocí odpovídajících metod pro nastavení.

Následující příklad načte vodítka zobrazení snímku z výše vytvořené prezentace:

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()

Přidat vodítka do masteru a rozložení snímků

Master snímku a každý jeho rozložení snímku může mít vlastní kolekce kreslicích vodítek. Použijte MasterSlide.getDrawingGuides pro master snímek a LayoutSlide.getDrawingGuides pro snímek rozložení.

Následující příklad přidá svislé vodítko k prvnímu masteru snímku a vodorovné vodítko k prvnímu rozložení snímku:

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()

Přidat vodítka do masterů poznámek a handoutů

Mastery poznámek a handoutů také podporují kreslicí vodítka. Použijte MasterNotesSlide.getDrawingGuides a MasterHandoutSlide.getDrawingGuides pro přístup k jejich kolekcím. Pokud prezentace neobsahuje některý z těchto masterů, MasterNotesSlideManager.setDefaultMasterNotesSlide nebo MasterHandoutSlideManager.setDefaultMasterHandoutSlide vytvoří výchozí master a vrátí jej.

Následující příklad přidá vodorovné vodítko do masteru poznámek a svislé vodítko do handout masteru:

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()

Odstranit kreslicí vodítka

Zavolejte DrawingGuidesCollection.clear, aby se odstranilo každé vodítko z konkrétní kolekce. Vymazání jedné kolekce neovlivní vodítka uložená v jiné oblasti.

Následující příklad vymaže vodítka zobrazení snímku a všechna vodítka na masterech snímků, rozložení snímků, masteru poznámek a handout masteru bez vytváření chybějících masterů:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpime.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()

FAQ

Objevují se kreslicí vodítka v prezentaci nebo exportovaných obrázcích?

Ne. Kreslicí vodítka jsou pomůcky pro zarovnání při úpravách a nejsou vykreslená jako obsah prezentace.

Lze kreslicí vodítko přidat přímo k jednotlivému normálnímu snímku?

Vodítka pro úpravu normálních snímků jsou uložena ve vlastnostech zobrazení snímku prezentace. Samostatné kolekce vodítek jsou k dispozici pro master snímky, rozložení snímků, mastery poznámek a handoutů.

Jaké jednotky se používají pro pozice vodítek?

Pozice jsou specifikovány v bodech, kde 72 bodů odpovídá jednomu palci. Vertikální pozice jsou měřeny od levého okraje a horizontální pozice od horního okraje.

Odstranění kreslicích vodítek odstraňuje tvary nebo mění obsah snímku?

Ne. Metoda DrawingGuidesCollection.clear odstraňuje pouze vodítka ve vybrané kolekci. Tvary a další obsah snímku zůstávají beze změny.