Presentatie‑weergave‑eigenschappen ophalen en bijwerken in Java
Inleiding
De normale weergave bestaat uit drie inhoudsgebieden: de dia zelf, een zijinhoudsgebied en een onderste inhoudsgebied. Eigenschappen met betrekking tot de positionering van de verschillende inhoudsgebieden. Deze informatie stelt de toepassing in staat om de weergavetoestand naar het bestand op te slaan, zodat bij het opnieuw openen de weergave zich in dezelfde toestand bevindt als toen de presentatie voor het laatst werd opgeslagen.
Method IViewProperties.getNormalViewProperties is toegevoegd om toegang te bieden tot de normale weergave‑eigenschappen van een presentatie.
INormalViewProperties, INormalViewRestoredProperties interfaces en hun afstammelingen, SplitterBarStateType enum zijn toegevoegd.
Over INormalViewProperties
Stelt de eigenschappen van de normale weergave voor.
Methoden getShowOutlineIcons en setShowOutlineIcons specificeren of de toepassing pictogrammen moet tonen wanneer de inhoudsopmaak in een van de inhoudsgebieden van de normale weergavemodus wordt weergegeven.
Methoden getSnapVerticalSplitter en setSnapVerticalSplitter geven aan of de verticale scheidingsbalk moet omslaan naar een geminimaliseerde toestand wanneer het zijgebied voldoende klein is.
Eigenschap getPreferSingleView en setPreferSingleView bepaalt of de gebruiker de voorkeur geeft aan één enkel inhoudsgebied over het volledige venster in plaats van de standaard normale weergave met drie inhoudsgebieden. Indien ingeschakeld, kan de toepassing kiezen om een van de inhoudsgebieden in het gehele venster te tonen.
Methoden getVerticalBarState en getHorizontalBarState geven de toestand aan waarin de horizontale of verticale scheidingsbalk moet worden getoond. Een horizontale scheidingsbalk scheidt de dia van het inhoudsgebied onder de dia, een verticale scheidingsbalk scheidt de dia van het zij‑inhoudsgebied. Mogelijke waarden zijn: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized en SplitterBarStateType.Restored.
Methoden getRestoredLeft en getRestoredTop specificeren de grootte van respectievelijk het bovenste of zij‑dia‑gebied van de normale weergave, wanneer de waarde SplitterBarStateType.Restored is toegepast op getVerticalBarState en getHorizontalBarState dienovereenkomstig.
Over het herstellen van INormalViewProperties
Geeft de afmetingen op van het dia‑gebied (breedte wanneer een kind van getRestoredTop, hoogte wanneer een kind van getRestoredLeft) van de normale weergave, wanneer het gebied een variabele herstelde grootte heeft (niet geminimaliseerd noch gemaximaliseerd).
Method getDimensionSize specificeert de grootte van het dia‑gebied (breedte wanneer een kind van restoredTop, hoogte wanneer een kind van restoredLeft).
Method getAutoAdjust bepaalt of de grootte van het zij‑inhoudsgebied moet worden gecompenseerd voor de nieuwe grootte bij het wijzigen van de grootte van het venster dat de weergave binnen de toepassing bevat.
Een voorbeeld hieronder laat zien hoe u de eigenschappen van ViewProperties.getNormalViewProperties kunt benaderen voor een presentatie.
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();
}
Stel de standaard zoomwaarde in
Om de weergave‑eigenschappen in te stellen, volgt u de onderstaande stappen:
- Maak een instantie van de Presentation klasse.
- Stel de View Properties van de 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 de diaweergave
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Zoomwaarde in procenten voor de notitie‑weergave
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Stel de rasterafstand in
Gebruik Presentation.getViewProperties om de weergave‑instellingen voor de gehele presentatie te benaderen. De IViewProperties.getGridSpacing en IViewProperties.setGridSpacing methoden lezen of wijzigen het interval van het onderliggende bewerkingsraster. Deze instelling geldt voor de volledige presentatie, niet voor een individuele dia. Rasterafstand wordt opgegeven in punten, waarbij 72 punten gelijk zijn aan één inch. Gebruik een positieve waarde, zoals vereist door de API‑documentatie.
Het volgende voorbeeld opent een bestaande demo.pptx, toont de huidige rasterafstand, 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 de drawing guides. Rasterafstand regelt een regelmatig interval, terwijl tekengidsen individueel gepositioneerde horizontale of verticale uitlijningslijnen zijn. Het toevoegen, verplaatsen of wissen van tekengidsen verandert de rasterafstand niet.
Zowel het raster als tekengidsen zijn hulpmiddelen voor bewerking. 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 kijker of editor.
FAQ
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 wissen van tekengidsen de rasterafstand?
Nee. Tekengidsen en rasterafstand zijn onafhankelijke instellingen. Het wissen van gidsen laat het opgeslagen raster‑interval ongewijzigd.
Kan ik verschillende weergave‑instellingen definiëren voor verschillende secties van een presentatie?
View settings worden gedefinieerd op presentatieniveau (Normal View/Slide View), niet per sectie, dus een enkele set parameters geldt voor het gehele document bij het openen.
Kan ik verschillende weergave‑toestanden vooraf definiëren voor verschillende gebruikers?
Nee. De instellingen worden in het bestand opgeslagen en zijn gedeeld. Toepassingen voor weergave kunnen gebruikersvoorkeuren respecteren, maar het bestand zelf bevat één set weergave‑eigenschappen.
Kan ik een sjabloon maken met vooraf gedefinieerde View Properties zodat nieuwe presentaties op dezelfde manier openen?
Ja. Omdat view properties op presentatieniveau worden opgeslagen, kunt u ze opnemen in een sjabloon en nieuwe documenten hiervan maken met dezelfde initiële weergaveconfiguratie.