Ophalen en bijwerken van presentatie‑weergave‑eigenschappen in Java
Inleiding
De normale weergave bestaat uit drie inhoudsgebieden: de dia zelf, een zij‑inhoudsgebied en een onder‑inhoudsgebied. Eigenschappen die betrekking hebben op de positionering van de verschillende inhoudsgebieden. Deze informatie stelt de applicatie in staat om de weergavetoestand op te slaan in het bestand, zodat bij het opnieuw openen de weergave zich in dezelfde toestand bevindt als toen de presentatie voor het laatst was opgeslagen.
De methode IViewProperties.getNormalViewProperties is toegevoegd om toegang te bieden tot de normale weergave‑eigenschappen van een presentatie.
De interfaces INormalViewProperties, INormalViewRestoredProperties en hun afstammelingen, en de enum SplitterBarStateType zijn toegevoegd.
Over INormalViewProperties
Vertegenwoordigt de normale weergave‑eigenschappen.
De methoden getShowOutlineIcons en setShowOutlineIcons geven aan of de applicatie pictogrammen moet weergeven bij het tonen van de schetsinhoud in een van de inhoudsgebieden van de normale weergavemodus.
De methoden getSnapVerticalSplitter en setSnapVerticalSplitter geven aan of de verticale splitter moet vastklikken in een geminimaliseerde toestand wanneer het zijgebied voldoende klein is.
De eigenschap getPreferSingleView en setPreferSingleView geeft aan of de gebruiker de voorkeur heeft voor een enkel‑inhoudsgebied over het volledige venster in plaats van de standaard normale weergave met drie inhoudsgebieden. Indien ingeschakeld, kan de applicatie ervoor kiezen om één van de inhoudsgebieden over het gehele venster weer te geven.
De methoden getVerticalBarState en getHorizontalBarState geven de toestand aan waarin de horizontale of verticale splitterbalk moet worden weergegeven. Een horizontale splitterbalk scheidt de dia van het inhoudsgebied onder de dia, een verticale splitterbalk scheidt de dia van het zij‑inhoudsgebied. Mogelijke waarden zijn: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized en SplitterBarStateType.Restored.
De methoden getRestoredLeft en getRestoredTop bepalen de afmetingen van respectievelijk het linker‑ of bovenste dia‑gebied van de normale weergave, wanneer de waarde SplitterBarStateType.Restored wordt toegepast op getVerticalBarState en getHorizontalBarState dienovereenkomstig.
Over het herstellen van INormalViewProperties
Bepaalt de afmetingen van het dia‑gebied (breedte wanneer het een kind is van getRestoredTop, hoogte wanneer het een kind is van getRestoredLeft) van de normale weergave, wanneer het gebied een variabele herstelde grootte heeft (noch geminimaliseerd noch gemaximaliseerd).
De methode getDimensionSize geeft de grootte van het dia‑gebied aan (breedte wanneer het een kind is van restoredTop, hoogte wanneer het een kind is van restoredLeft).
De methode getAutoAdjust geeft aan of de grootte van het zij‑inhoudsgebied moet worden aangepast aan de nieuwe grootte bij het wijzigen van de grootte van het venster dat de weergave bevat binnen de applicatie.
Hieronder wordt een voorbeeld gegeven dat laat zien hoe u de eigenschappen ViewProperties.getNormalViewProperties van een presentatie kunt benaderen.
import com.aspose.slides.*;
Presentation pres = new Presentation();
try {
pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
// Herstel de weergave‑eigenschappen van de presentatie
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();
}
Standaardzoomwaarde instellen
Om de weergave‑eigenschappen in te stellen, volgt u de onderstaande stappen:
- Maak een instantie van de klasse Presentation.
- Stel de View Properties van Presentation in.
- Schrijf de presentatie weg als een PPTX‑bestand.
In het onderstaande voorbeeld hebben we de zoomwaarde ingesteld voor zowel de dia‑weergave als de notitie‑weergave.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
// Instellen van de weergave‑eigenschappen van de presentatie
presentation.getViewProperties().getSlideViewProperties().setScale(100); // Zoomwaarde in procenten voor diaview
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Zoomwaarde in procenten voor notitie‑view
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Rasterafstand instellen
Gebruik Presentation.getViewProperties om toegang te krijgen tot de weergave‑instellingen voor de gehele presentatie. De methoden IViewProperties.getGridSpacing en IViewProperties.setGridSpacing lezen of wijzigen het interval van het onderliggende bewerkingsraster. Deze instelling geldt voor de volledige presentatie, niet voor een enkele dia. Rasterafstand wordt opgegeven in punten, waarbij 72 punten één inch gelijk zijn. Gebruik een positieve waarde, zoals vereist door de API‑documentatie.
Het volgende voorbeeld opent een bestaande demo.pptx, geeft de huidige rasterafstand weer, stelt een kwart‑inch interval in, en slaat het resultaat op.
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();
}
Het raster verschilt van drawing guides. Rasterafstand regelt een regulier interval, terwijl tekengidsen individuele horizontale of verticale uitlijninglijnen zijn. Het toevoegen, verplaatsen of verwijderen van tekengidsen verandert de rasterafstand niet.
Zowel het raster als de tekengidsen zijn hulpmiddelen bij het bewerken. Ze worden niet gerenderd als dia‑inhoud in PDF, afbeeldingen, SVG of een diavoorstelling. Het opslaan van de rasterafstand garandeert niet dat een editor het raster weergeeft: de zichtbaarheid hangt ook af van de voorkeuren van de viewer of editor.
Reacties weergeven of verbergen bij het openen van een presentatie
Gebruik Presentation.getViewProperties om toegang te krijgen tot de weergave‑instellingen voor de gehele presentatie. Gebruik IViewProperties.getShowComments en IViewProperties.setShowComments om de opgeslagen voorkeur te lezen of te wijzigen of opmerkingen moeten worden weergegeven wanneer de presentatie wordt geopend in PowerPoint of een andere compatibele editor.
Deze instelling regelt alleen de opgeslagen weergave‑voorkeur. Het voegt geen opmerkingen toe, verwijdert ze, bewerkt ze of lost ze op. Het verbergen van opmerkingen behoudt hun inhoud, auteurs, posities, antwoorden en statussen. Zie Presentation Comments voor handelingen die de opmerkingen zelf wijzigen.
Het volgende voorbeeld vereist een bestaande comments.pptx met opmerkingen. Het geeft de huidige zichtbaarheid weer, vraagt om de opmerkingen te verbergen en slaat een nieuwe PPTX op zonder opmerkingen te verwijderen. Het gebruikt ook IViewProperties.setLastView met ViewType.SlideView om de initiële bewerkingsweergave te configureren naast de zichtbaarheid van opmerkingen.
import com.aspose.slides.NullableBool;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;
Presentation presentation = new Presentation("comments.pptx");
try {
byte showComments = presentation.getViewProperties().getShowComments();
System.out.println("Current comment visibility: " + showComments);
presentation.getViewProperties().setShowComments(NullableBool.False);
presentation.getViewProperties().setLastView(ViewType.SlideView);
presentation.save("comments-hidden.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Deze instelling bepaalt niet of opmerkingen worden opgenomen in PDF-, HTML-, afbeelding-, notitie‑ of hand‑out‑exporten. Configureer de relevante export‑specifieke opties afzonderlijk.
Veelgestelde vragen
Waarom is het raster niet zichtbaar nadat ik de presentatie opnieuw heb geopend?
Het bestand slaat de rasterafstand op, maar de editor bepaalt of het raster wordt weergegeven. Controleer de raster‑zichtbaarheidsinstellingen van de editor.
Verandert het verwijderen van tekengidsen de rasterafstand?
Nee. Tekengidsen en rasterafstand zijn onafhankelijke instellingen. Het verwijderen van gidsen laat het opgeslagen rasterinterval onveranderd.
Kan ik verschillende weergave‑instellingen instellen voor verschillende secties van een presentatie?
Weergave‑instellingen worden gedefinieerd op presentatieniveau (Normal View/Slide View), niet per sectie, zodat één set parameters van toepassing is op het volledige document bij het openen.
Kan ik vooraf verschillende weergave‑staten definiëren voor verschillende gebruikers?
Nee. De instellingen worden opgeslagen in het bestand en worden gedeeld. Viewer‑applicaties kunnen de gebruikersvoorkeuren respecteren, maar het bestand zelf bevat één set weergave‑eigenschappen.
Kan ik een sjabloon voorbereiden met vooraf gedefinieerde weergave‑eigenschappen zodat nieuwe presentaties op dezelfde manier openen?
Ja. Omdat weergave‑eigenschappen worden opgeslagen op presentatieniveau, kunt u ze in een sjabloon opnemen en nieuwe documenten ervan maken met dezelfde initiële weergave‑configuratie.