Hämta och uppdatera presentationsvyns egenskaper i Java

Introduktion

Normalvyn består av tre innehållsområden: själva bilden, ett sidoinnehållsområde och ett botteninnehållsområde. Egenskaper som rör placeringen av de olika innehållsområdena. Denna information gör att programmet kan spara sitt visningsläge i filen, så att när den öppnas igen är vyn i samma tillstånd som när presentationen senast sparades.

Metoden IViewProperties.getNormalViewProperties har lagts till för att ge åtkomst till normalvyns egenskaper för en presentation.

INormalViewProperties, INormalViewRestoredProperties gränssnitt och deras efterföljare, SplitterBarStateType enum har lagts till.

Om INormalViewProperties

Representerar normalvyns egenskaper.

Metoderna getShowOutlineIcons och setShowOutlineIcons anger om programmet ska visa ikoner när dispositionens innehåll visas i något av innehållsområdena i normalvyläget.

Metoderna getSnapVerticalSplitter och setSnapVerticalSplitter anger om den vertikala delaren ska fästas i ett minimerat tillstånd när sidoregionen är tillräckligt liten.

Egenskapen getPreferSingleView och setPreferSingleView anger om användaren föredrar att se ett enda innehållsområde i hela fönstret istället för den vanliga normalvyn med tre innehållsområden. Om den är aktiverad kan programmet välja att visa ett av innehållsområdena i hela fönstret.

Metoderna getVerticalBarState och getHorizontalBarState anger vilket tillstånd den horisontella eller vertikala delaren ska visas i. En horisontell delare separerar bilden från innehållsområdet under bilden, en vertikal delare separerar bilden från sidoinnehållsområdet. Möjliga värden är: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized och SplitterBarStateType.Restored.

Metoderna getRestoredLeft och getRestoredTop specificerar storleken på den övre eller sidogenererade bildregionen i normalvyn, när värdet SplitterBarStateType.Restored tillämpas för getVerticalBarState och getHorizontalBarState därefter.

Om återställning av INormalViewProperties

Anger storleken på bildregionen (bredd när den är ett underobjekt till getRestoredTop, höjd när den är ett underobjekt till getRestoredLeft) i normalvyn, när regionen har en variabel återställd storlek (varken minimerad eller maximiserad).

Metoden getDimensionSize anger storleken på bildregionen (bredd när den är ett underobjekt till restoredTop, höjd när den är ett underobjekt till restoredLeft).

Metoden getAutoAdjust anger om storleken på sidoinnehållsområdet ska anpassas till den nya storleken när fönstret som innehåller vyn i programmet ändras i storlek.

Ett exempel ges nedan som visar hur du kan komma åt ViewProperties.getNormalViewProperties egenskaper för en presentation.

import com.aspose.slides.*;

Presentation pres = new Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
    
    // Återställ vyegenskaperna för presentationen
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
    pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);

    pres.save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Ställ in standardzoomvärdet

För att ställa in vyegenskaperna. Följ stegen nedan:

  1. Skapa en instans av klassen Presentation.
  2. Ange View Properties för Presentation.
  3. Spara presentationen som en PPTX‑fil. I exemplet nedan har vi ställt in zoomvärdet för bildvyn samt notvyn.
import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    // Ställer in vyegenskaperna för presentationen
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // Zoomvärde i procent för bildvyn
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // Zoomvärde i procent för anteckningsvyn 

    presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ställ in rutnätets avstånd

Använd Presentation.getViewProperties för att komma åt presentationsomfattande vyinställningar. Metoderna IViewProperties.getGridSpacing och IViewProperties.setGridSpacing läser eller ändrar intervallet för det underliggande redigeringsrutnätet. Denna inställning gäller hela presentationen, inte enskilda bilder. Rutnätsavstånd anges i punkter, där 72 punkter motsvarar en tum. Använd ett positivt värde, enligt API‑dokumentationen.

Följande exempel öppnar en befintlig demo.pptx, skriver ut dess nuvarande rutnätsavstånd, sätter ett fjärdedels tum‑intervall och sparar resultatet.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("demo.pptx");
try {
    float gridSpacing = presentation.getViewProperties().getGridSpacing();
    System.out.println("Current grid spacing: " + gridSpacing + " points");

    presentation.getViewProperties().setGridSpacing(18f);
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Rutnätet skiljer sig från drawing guides. Rutnätsavstånd styr ett regelbundet intervall, medan ritningsguider är individuellt placerade horisontella eller vertikala justeringslinjer. Att lägga till, flytta eller rensa ritningsguider ändrar inte rutnätsavståndet.

Både rutnätet och ritningsguiderna är redigeringshjälpmedel. De renderas inte som bildinnehåll i PDF, bilder, SVG eller en bildspelsvisning. Att lagra rutnätsavståndet garanterar inte att en redigerare visar rutnätet: dess synlighet beror även på visarens eller redigerarens inställningar.

FAQ

Varför är inte rutnätet synligt efter att jag öppnat presentationen igen?

Filen lagrar rutnätsavståndet, men redigeraren styr om rutnätet visas. Kontrollera redigerarens inställningar för rutnätsynlighet.

Är det så att rensning av ritningsguider ändrar rutnätsavståndet?

Nej. Ritningsguider och rutnätsavstånd är oberoende inställningar. Att rensa guider lämnar det lagrade rutnätsintervallet oförändrat.

Kan jag ange olika vyinställningar för olika sektioner i en presentation?

Vyinställningar definieras på presentationsnivå (Normal View/Slide View), inte per sektion, så ett enda parameteruppsättning gäller för hela dokumentet när det öppnas.

Kan jag fördefiniera olika vytilstånd för olika användare?

Nej. Inställningarna lagras i filen och delas. Visarprogram kan respektera användarpreferenser, men filen själv innehåller endast en uppsättning vyegenskaper.

Kan jag förbereda en mall med fördefinierade View Properties så att nya presentationer öppnas på samma sätt?

Ja. Eftersom vyegenskaper lagras på presentationsnivå kan du bädda in dem i en mall och skapa nya dokument från den med samma initiala vykonfiguration.