Hantera ritningsguider i presentationer i Java

Vad den här sidan handlar om

Lägg till, hämta och rensa horisontella och vertikala ritningsguider i PowerPoint-presentationer med Aspose.Slides för Java.

Översikt

Ritningsguider är justerbara horisontella och vertikala linjer som hjälper användare att justera former konsekvent när de redigerar en presentation i PowerPoint. De är särskilt användbara när en applikation genererar en presentation som senare ska finjusteras manuellt: applikationen kan spara samma justeringshjälpmedel som författare bör följa när de lägger till eller flyttar innehåll.

Ritningsguider är redigeringshjälpmedel, inte bildinnehåll. De visas inte i en bildspelsvisning eller renderad output. Aspose.Slides for Java exponerar dem via gränssnittet IDrawingGuidesCollection. En guide representeras av IDrawingGuide och har en orientering, en position och en färg.

Positionen mäts i punkter från det övre vänstra hörnet av den aktuella bilden eller mastern. En vertikal guide använder en horisontell koordinat, vanligtvis mellan noll och bildens bredd. En horisontell guide använder en vertikal koordinat, vanligtvis mellan noll och bildens höjd.

Lägg till guider i bildvyn

Använd ICommonSlideViewProperties.getDrawingGuides för att hantera guider som visas vid redigering av vanliga bilder. Anropa IDrawingGuidesCollection.add med ett Orientation‑värde och en position i punkter.

Följande exempel lägger till en vertikal guide till höger om bildens mitt och en horisontell guide under den:

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

Presentation presentation = new Presentation();
try {
    Dimension2D slideSize = presentation.getSlideSize().getSize();
    IDrawingGuidesCollection guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    guides.add(Orientation.Vertical, (float) (slideSize.getWidth() / 2 + 12.5));
    guides.add(Orientation.Horizontal, (float) (slideSize.getHeight() / 2 + 12.5));

    presentation.save("drawing-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Åtkomst till ritningsguider

Metoderna IDrawingGuidesCollection.getCount och IDrawingGuidesCollection.get_Item ger åtkomst till befintliga guider. Metoderna IDrawingGuide.getOrientation, IDrawingGuide.getPosition och IDrawingGuide.getColor returnerar värden som också kan ändras via motsvarande setter‑metoder.

Följande exempel läser in bild‑vyns guider från presentationen som skapades ovan:

import com.aspose.slides.*;

Presentation presentation = new Presentation("drawing-guides.pptx");
try {
    IDrawingGuidesCollection guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    for (int index = 0; index < guides.getCount(); index++) {
        IDrawingGuide guide = guides.get_Item(index);
        System.out.println("Guide " + index + ": orientation = " + guide.getOrientation() + ", position = " + guide.getPosition() + ", color = " + guide.getColor());
    }
} finally {
    presentation.dispose();
}

Lägg till guider på master‑ och layoutbilder

En bildmaster och var och en av dess layoutbilder kan ha egna samlingar av ritningsguider. Använd IMasterSlide.getDrawingGuides för en master‑bild och ILayoutSlide.getDrawingGuides för en layout‑bild.

Följande exempel lägger till en vertikal guide på den första master‑bilden och en horisontell guide på den första layout‑bilden:

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

Presentation presentation = new Presentation();
try {
    Dimension2D slideSize = presentation.getSlideSize().getSize();
    IDrawingGuidesCollection masterGuides = presentation.getMasters().get_Item(0).getDrawingGuides();
    IDrawingGuidesCollection layoutGuides = presentation.getLayoutSlides().get_Item(0).getDrawingGuides();

    masterGuides.add(Orientation.Vertical, (float) (slideSize.getWidth() / 2 - 20));
    layoutGuides.add(Orientation.Horizontal, (float) (slideSize.getHeight() / 2 + 20));

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

Lägg till guider på antecknings‑ och utdelnings‑masterbilder

Antecknings‑masterbilder och utdelnings‑masterbilder stödjer också ritningsguider. Använd IMasterNotesSlide.getDrawingGuides och IMasterHandoutSlide.getDrawingGuides för att komma åt deras samlingar. Om en presentation inte innehåller någon av dessa masterbilder skapar IMasterNotesSlideManager.setDefaultMasterNotesSlide eller IMasterHandoutSlideManager.setDefaultMasterHandoutSlide standard‑masterbilden och returnerar den.

Följande exempel lägger till en horisontell guide på en antecknings‑master och en vertikal guide på en utdelnings‑master:

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

Presentation presentation = new Presentation();
try {
    Dimension2D notesSize = presentation.getNotesSize().getSize();
    IMasterNotesSlide notesMaster = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide();
    IMasterHandoutSlide handoutMaster = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();

    notesMaster.getDrawingGuides().add(Orientation.Horizontal, (float) (notesSize.getHeight() / 2 + 50));
    handoutMaster.getDrawingGuides().add(Orientation.Vertical, (float) (notesSize.getWidth() / 2 - 50));

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

Rensa ritningsguider

Anropa IDrawingGuidesCollection.clear för att ta bort alla guider från en viss samling. Att rensa en samling påverkar inte guider som lagras i en annan omfattning.

Följande exempel rensar bild‑vyns guider samt alla guider på bild‑master, layout‑bilder, antecknings‑master och utdelnings‑master utan att skapa saknade masterbilder:

import com.aspose.slides.*;

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

    for (IMasterSlide masterSlide : presentation.getMasters()) {
        masterSlide.getDrawingGuides().clear();
    }

    for (ILayoutSlide layoutSlide : presentation.getLayoutSlides()) {
        layoutSlide.getDrawingGuides().clear();
    }

    IMasterNotesSlide notesMaster = presentation.getMasterNotesSlideManager().getMasterNotesSlide();
    if (notesMaster != null) {
        notesMaster.getDrawingGuides().clear();
    }

    IMasterHandoutSlide handoutMaster = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();
    if (handoutMaster != null) {
        handoutMaster.getDrawingGuides().clear();
    }

    presentation.save("presentation-without-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Vanliga frågor

Visas ritningsguider i ett bildspel eller exporterade bilder?

Nej. Ritningsguider är justeringshjälpmedel för redigering och renderas inte som presentationsinnehåll.

Kan en ritningsguide läggas till direkt på en enskild normal bild?

Redigeringsguider för vanliga bilder lagras i presentationens bild‑vyegenskaper. Separata guidsamlingar finns för bild‑master, layout‑bilder, antecknings‑master och utdelnings‑master.

Vilka enheter används för guidernas positioner?

Positioner anges i punkter, där 72 punkter motsvarar en tum. Vertikala positioner mäts från vänster kant och horisontella positioner mäts från överkanten.

Tar rensning av ritningsguider bort former eller förändrar bildens innehåll?

Nej. Metoden IDrawingGuidesCollection.clear tar bara bort guiderna i den valda samlingen. Former och annat bildinnehåll förblir oförändrade.