Opvragen en bijwerken van presentatie-weergave-eigenschappen in PHP

Inleiding

De normale weergave bestaat uit drie inhoudsgebieden: de dia zelf, een zijinhoudsgebied en een onderinhoudsgebied. Eigenschappen die betrekking hebben op de positionering van de verschillende inhoudsgebieden. Deze informatie stelt de applicatie in staat om de weergavestatus op te slaan in het bestand, zodat bij het opnieuw openen de weergave zich in dezelfde staat bevindt als toen de presentatie voor het laatst werd opgeslagen.

De methode ViewProperties::getNormalViewProperties is toegevoegd om toegang te bieden tot de normale weergave‑eigenschappen van een presentatie.

NormalViewProperties, NormalViewRestoredProperties klassen en hun afstammelingen, SplitterBarStateType enum zijn toegevoegd.

Over INormalViewProperties

Stelt normale weergave‑eigenschappen voor.

Methoden getShowOutlineIcons en setShowOutlineIcons geven aan of de applicatie pictogrammen moet weergeven bij het tonen van schemavoorstellinginhoud in een van de inhoudsgebieden van de normale weergavemodus.

Methoden getSnapVerticalSplitter en setSnapVerticalSplitter geven aan of de verticale scheidingsbalk moet ‘snap’ naar een geminimaliseerde toestand wanneer het zijgebied voldoende klein is.

Eigenschap getPreferSingleView en setPreferSingleView geeft aan of de gebruiker de voorkeur geeft aan 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 een van de inhoudsgebieden over het gehele venster weer te geven.

Methoden getVerticalBarState en getHorizontalBarState bepalen de toestand waarin de horizontale of verticale scheidingsbalk moet worden weergegeven. 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 bepalen de afmetingen van respectievelijk het linkere of bovenste dia‑gebied van de normale weergave, wanneer de waarde SplitterBarStateType::Restored is toegepast op getVerticalBarState en getHorizontalBarState overeenkomstig.

Over het herstellen van INormalViewProperties

Geeft de afmetingen 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 (noch geminimaliseerd noch gemaximaliseerd).

Methode getDimensionSize bepaalt de grootte van het dia‑gebied (breedte wanneer een kind van restoredTop, hoogte wanneer een kind van restoredLeft).

Methode getAutoAdjust geeft aan of de grootte van het zij‑inhoudsgebied moet compenseren bij het aanpassen van de grootte van het venster dat de weergave bevat binnen de applicatie.

Hieronder staat een voorbeeld dat laat zien hoe u toegang kunt krijgen tot de eigenschappen van ViewProperties::getNormalViewProperties voor een presentatie.

  $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

Aspose.Slides voor PHP via Java ondersteunt nu het instellen van de standaard zoomwaarde voor een presentatie, zodat bij het openen van de presentatie de zoom al is ingesteld. Dit kan worden gedaan door de ViewProperties van een presentatie in te stellen. getSlideViewProperties en getNotesViewProperties kunnen programmatisch worden ingesteld. In dit onderwerp laten we aan de hand van een voorbeeld zien hoe u de View Properties van Presentation in Aspose.Slides kunt 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 de Presentation in.
Schrijf de presentatie weg als een PPTX bestand.
In het onderstaande voorbeeld hebben we de zoomwaarde ingesteld voor zowel de diavoorstelling als de notitie‑weergave.

  $presentation = new Presentation();
  try {
    # Instellen van de weergave-eigenschappen van de presentatie
    $presentation->getViewProperties()->getSlideViewProperties()->setScale(100); // Zoomwaarde in percentages voor diavoorstelling
    $presentation->getViewProperties()->getNotesViewProperties()->setScale(100); // Zoomwaarde in percentages voor notitie-weergave

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

FAQ

Kan ik verschillende weergave‑instellingen voor verschillende secties van een presentatie instellen?

View settings worden op presentatieniveau gedefinieerd (Normal View/Slide View), niet per sectie, dus een enkele set parameters geldt voor het hele 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. Viewer‑applicaties kunnen de voorkeuren van de gebruiker respecteren, maar het bestand zelf bevat één set weergave‑eigenschappen.

Kan ik een sjabloon voorbereiden met vooraf gedefinieerde View Properties zodat nieuwe presentaties op dezelfde manier worden geopend?

Ja. Omdat view properties op presentatieniveau worden opgeslagen, kunt u ze in een sjabloon opnemen en nieuwe documenten ervan maken met dezelfde initiële weergave‑configuratie.

Beheer presentatie-eigenschappen in PHP Beheer presentatie‑opmerkingen in PHP