Presentation View Properties

The normal view consists of three content regions: the slide itself, a side content region, and a bottom content region. Properties pertaining to the positioning of the different content regions. This information allows the application to save its view state to the file, so that when reopened the view is in the same state as when the presentation was last saved.

Method IViewProperties.getNormalViewProperties has been added to provide access to normal view properties of presentation. 

INormalViewProperties, INormalViewRestoredProperties interfaces and its descendants, SplitterBarStateType enum have been added.

About INormalViewProperties

Represents normal view properties.

Methods getShowOutlineIcons and setShowOutlineIcons specifies whether the application should show icons if displaying outline content in any of the content regions of normal view mode.

Methods getSnapVerticalSplitter and setSnapVerticalSplitter specifies whether the vertical splitter should snap to a minimized state when the side region is sufficiently small.

Property getPreferSingleView and setPreferSingleView specifies whether the user prefers to see a full-window single-content region over the standard normal view with three content regions. If enabled, the application may choose to display one of the content regions in the entire window.

Methods getVerticalBarState and getHorizontalBarState specify the state that the horizontal or vertical splitter bar should be shown in. A horizontal splitter bar separates the slide from the content region below the slide, vertical splitter bar separates the slide from the side content region. Possible values are: SplitterBarStateType::Minimized, SplitterBarStateType::Maximized and SplitterBarStateType::Restored.

Methods getRestoredLeft and getRestoredTop specify the sizing of the top or side slide region of the normal view, when SplitterBarStateType::Restored value applied for getVerticalBarState and getHorizontalBarState accordingly.

About Restoring INormalViewProperties

Specifies the sizing of the slide region (width when a child of getRestoredTop, height when a child of getRestoredLeft) of the normal view, when the region is of a variable restored size (neither minimized nor maximized). 

Method getDimensionSize specifies the size of the slide region (width when a child of restoredTop, height when a child of restoredLeft).

Method getAutoAdjust specifies whether the size of the side content region should compensate for the new size when resizing the window containing the view within the application

An example is given below shows how can you access ViewProperties.getNormalViewProperties properties for a presentation.

  # Instantiate a Presentation object that represents a presentation file
  $pres = new Presentation();
  try {
    $pres->getViewProperties()->getNormalViewProperties()->setHorizontalBarState(SplitterBarStateType::Restored);
    $pres->getViewProperties()->getNormalViewProperties()->setVerticalBarState(SplitterBarStateType::Maximized);
    # Restore View Properties of Presentation
    $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();
  }

Set Default Zoom Value

Aspose.Slides for PHP via Java now supports setting the default zoom value for presentation such that when the presentation is opened, zoom is set already. This could be done by setting the ViewProperties of a presentation. getSlideViewProperties as well as getNotesViewProperties could be set programmatically. In this topic, we will see with an example how to set the View Properties of Presentation in Aspose.Slides.

In order to set the view properties. Please follow the steps below:

1. Create an instance of Presentation class.
2. Set View Properties of Presentation.
3. Write the presentation as a PPTX file. In the example given below, we have set the zoom value for slide view as well as notes view.

  # Instantiate a Presentation object that represents a presentation file
  $presentation = new Presentation();
  try {
    # Setting View Properties of Presentation
    $presentation->getViewProperties()->getSlideViewProperties()->setScale(100);// Zoom value in percentages for slide view

    $presentation->getViewProperties()->getNotesViewProperties()->setScale(100);// Zoom value in percentages for notes view

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