Načtení a aktualizace vlastností zobrazení prezentace v PHP

Úvod

Normální zobrazení se skládá ze tří oblastí obsahu: samotného snímku, postranní oblasti obsahu a spodní oblasti obsahu. Vlastnosti týkající se umístění jednotlivých oblastí obsahu. Tyto informace umožňují aplikaci uložit stav zobrazení do souboru, takže po opětovném otevření je zobrazení ve stejném stavu, v jakém bylo prezentace naposledy uloženo.

Metoda ViewProperties::getNormalViewProperties byla přidána pro poskytování přístupu k vlastnostem normálního zobrazení prezentace.

Byly přidány třídy NormalViewProperties, NormalViewRestoredProperties, jejich potomci a výčet SplitterBarStateType .

O INormalViewProperties

Reprezentuje vlastnosti normálního zobrazení.

Metoda getShowOutlineIcons a metoda setShowOutlineIcons určují, zda má aplikace zobrazovat ikony při zobrazování obsahu osnovy v některé z oblastí obsahu v režimu normálního zobrazení.

Metoda getSnapVerticalSplitter a metoda setSnapVerticalSplitter určují, zda se má svislý dělič přichytit do minimalizovaného stavu, když je postranní oblast dostatečně malá.

Vlastnost getPreferSingleView a metoda setPreferSingleView určují, zda uživatel upřednostňuje zobrazit jednorozměrnou oblast obsahu na celou obrazovku místo standardního normálního zobrazení se třemi oblastmi obsahu. Pokud je povoleno, aplikace může zobrazit jednu z oblastí obsahu v celém okně.

Metoda getVerticalBarState a metoda getHorizontalBarState určují stav, ve kterém by měl být zobrazen vodorovný nebo svislý dělič. Vodorovný dělič odděluje snímek od oblasti obsahu pod snímkem, svislý dělič odděluje snímek od postranní oblasti obsahu. Možné hodnoty jsou: SplitterBarStateType::Minimized, SplitterBarStateType::Maximized a SplitterBarStateType::Restored.

Metoda getRestoredLeft a metoda getRestoredTop určují velikost horní nebo postranní oblasti snímku v normálním zobrazení, když je pro getVerticalBarState a getHorizontalBarState použita hodnota SplitterBarStateType::Restored.

O obnovování INormalViewProperties

Určuje velikost oblasti snímku (šířka, pokud je podřízená getRestoredTop, výška, pokud je podřízená getRestoredLeft) v normálním zobrazení, když má oblast proměnnou obnovovanou velikost (není ani minimalizovaná, ani maximalizovaná).

Metoda getDimensionSize určuje velikost oblasti snímku (šířka, pokud je podřízená restoredTop, výška, pokud je podřízená restoredLeft).

Metoda getAutoAdjust určuje, zda má velikost postranní oblasti obsahu kompenzovat novou velikost při změně velikosti okna obsahujícího zobrazení v aplikaci.

Níže je uveden příklad, který ukazuje, jak můžete získat vlastnosti ViewProperties::getNormalViewProperties pro prezentaci.

  $pres = new Presentation();
  try {
    $pres->getViewProperties()->getNormalViewProperties()->setHorizontalBarState(SplitterBarStateType::Restored);
    $pres->getViewProperties()->getNormalViewProperties()->setVerticalBarState(SplitterBarStateType::Maximized);

    # Obnovit vlastnosti zobrazení prezentace
    $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();
  }

Nastavení výchozí úrovně přiblížení

Aspose.Slides for PHP via Java nyní podporuje nastavení výchozí úrovně přiblížení pro prezentaci tak, že při otevření je přiblížení již nastaveno. To lze provést nastavením ViewProperties prezentace. getSlideViewProperties i getNotesViewProperties lze nastavit programově. V tomto tématu si ukážeme na příkladu, jak nastavit View Properties pro Presentation v Aspose.Slides.

Pro nastavení vlastností zobrazení postupujte podle následujících kroků:

1. Vytvořte instanci třídy Presentation.
2. Nastavte View Properties pro Presentation.
3. Uložte prezentaci jako soubor PPTX . V níže uvedeném příkladu jsme nastavili hodnotu přiblížení pro zobrazení snímku i zobrazení poznámek.

  $presentation = new Presentation();
  try {
    # Nastavení vlastností zobrazení prezentace
    $presentation->getViewProperties()->getSlideViewProperties()->setScale(100); // Hodnota přiblížení v procentech pro zobrazení snímku
    $presentation->getViewProperties()->getNotesViewProperties()->setScale(100); // Hodnota přiblížení v procentech pro zobrazení poznámek

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

Často kladené otázky

Mohu nastavit různé nastavení zobrazení pro různé sekce prezentace?

Nastavení zobrazení jsou definována na úrovni prezentace (Normal View/Slide View), nikoli pro jednotlivé sekce, takže jeden soubor parametrů platí pro celý dokument při otevření.

Mohu předdefinovat různé stavy zobrazení pro různé uživatele?

Ne. Nastavení jsou uložena v souboru a jsou sdílená. Aplikační prohlížeče mohou respektovat uživatelské preference, ale samotný soubor obsahuje jeden soubor vlastností zobrazení.

Mohu připravit šablonu s předdefinovanými vlastnostmi zobrazení, aby se nové prezentace otevíraly stejným způsobem?

Ano. Protože view properties jsou uloženy na úrovni prezentace, můžete je vložit do šablony a vytvářet z ní nové dokumenty se stejnou počáteční konfigurací zobrazení.