Abrufen und Aktualisieren von Präsentationsansichtseigenschaften in PHP

Einleitung

In der normalen Ansicht von PowerPoint wird die Folie zwischen einem Seitenbereich für Miniaturansichten oder einer Gliederung und einem Notizenbereich unten angezeigt. Aspose.Slides für PHP via Java stellt die gespeicherten Bearbeitungspräferenzen der Präsentation über Presentation::getViewProperties zur Verfügung. Dazu gehören das Layout der Bereiche, Zoom‑Stufen, Rasterabstand und die Sichtbarkeit von Kommentaren.

Über NormalViewProperties

Verwenden Sie getNormalViewProperties, um auf die Klasse NormalViewProperties zuzugreifen. setShowOutlineIcons steuert, ob Symbole neben den Folientiteln in der Gliederungsansicht angezeigt werden. setSnapVerticalSplitter lässt den Seitenbereich in den minimierten Zustand „einrasten“, wenn der Benutzer ihn verkleinert. setPreferSingleView gibt eine Präferenz an, ein Feld im Vollfenster anzuzeigen.

setVerticalBarState steuert den Trenner zwischen dem Seitenbereich und der Folie. setHorizontalBarState steuert den Trenner über dem Notizenbereich. Beide akzeptieren einen SplitterBarStateType-Wert von Minimized, Maximized oder Restored.

Über das Wiederherstellen von NormalViewProperties

Wenn ein Trenner wiederhergestellt wird, liefert getRestoredLeft die gespeicherte Größe des Seitenbereichs und getRestoredTop die gespeicherte Größe des oberen Folienbereichs. Beide geben NormalViewRestoredProperties frei. Die Methode setDimensionSize akzeptiert einen Prozentsatz von 0 bis 100, und setAutoAdjust steuert, ob der Editor die Größe beim Ändern der Fenstergröße anpasst.

Dieses Beispiel aktualisiert eine vorhandene Präsentation. Es stellt den horizontalen Trenner wieder her, setzt die von getRestoredTop zurückgegebene Größe auf 80 % mit aktivierter automatischer Anpassung und maximiert den vertikalen Trenner. Außerdem wird setShowOutlineIcons aufgerufen, um Symbole in der Gliederungsansicht anzuzeigen.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SplitterBarStateType;

$presentation = new Presentation("demo.pptx");
try {
    $normalView = $presentation->getViewProperties()->getNormalViewProperties();
    $normalView->setHorizontalBarState(SplitterBarStateType::Restored);
    $normalView->setVerticalBarState(SplitterBarStateType::Maximized);
    $normalView->getRestoredTop()->setAutoAdjust(true);
    $normalView->getRestoredTop()->setDimensionSize(80);
    $normalView->setShowOutlineIcons(true);

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

Standard‑Zoomwert festlegen

getSlideViewProperties und getNotesViewProperties speichern unabhängige Zoom‑Einstellungen für den Editor. Diese Einstellungen beeinflussen weder die Folienabmessungen, die Wiedergabe von Bildschirmen, noch die Auflösung beim Export von Bildern.

Dieses Beispiel öffnet eine vorhandene Präsentation und ruft setVariableScale auf, um die Folie an das Bearbeitungsfenster anzupassen. Für die Notizseite deaktiviert es die automatische Skalierung und ruft setScale auf, um einen festen Zoom von 80 % festzulegen.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("demo.pptx");
try {
    $viewProperties = $presentation->getViewProperties();
    $viewProperties->getSlideViewProperties()->setVariableScale(true);
    $viewProperties->getNotesViewProperties()->setVariableScale(false);
    $viewProperties->getNotesViewProperties()->setScale(80);

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

Rasterabstand festlegen

Die Methode setGridSpacing von ViewProperties legt den Abstand zwischen den Bearbeitungsrastern in der gesamten Präsentation fest. Sie akzeptiert einen positiven Wert in Punkten, wobei 72 Punkte einem Zoll entsprechen. Dieses Beispiel gibt den aktuellen Abstand in einer vorhandenen Präsentation aus und speichert ein Raster von einem Viertel Zoll, indem es das Intervall auf 18 Punkte setzt.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("demo.pptx");
try {
    $viewProperties = $presentation->getViewProperties();
    echo "Current grid spacing: " . java_values($viewProperties->getGridSpacing()) . " points" . PHP_EOL;

    $viewProperties->setGridSpacing(18.0);
    
    $presentation->save("grid-spacing.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Das Raster wiederholt sich in einem festen Intervall. Drawing guides markieren einzelne horizontale oder vertikale Positionen. Beide dienen als Bearbeitungshilfen und erscheinen nur in Editoren, die sie anzeigen. Bildschirminterpretationen sowie Exporte nach PDF, Bildern oder SVG lassen sie weg.

Kommentare beim Öffnen einer Präsentation ein‑ oder ausblenden

setShowComments speichert eine Präferenz, die kompatible Editoren beim Öffnen der Präsentation verwenden. Für eine vorhandene Präsentation mit Kommentaren gibt dieses Beispiel die aktuelle Einstellung aus und speichert eine Kopie mit ausgeblendeten Kommentaren. Außerdem wird setLastView mit ViewType::SlideView aufgerufen, damit die Kopie in der Folienansicht geöffnet wird.

use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ViewType;

$presentation = new Presentation("comments.pptx");
try {
    $viewProperties = $presentation->getViewProperties();
    echo "Current comment visibility: " . java_values($viewProperties->getShowComments()) . PHP_EOL;

    $viewProperties->setShowComments(NullableBool::False);
    $viewProperties->setLastView(ViewType::SlideView);

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

Das Ausblenden von Kommentaren bewahrt deren Text, Autoren, Positionen, Antworten und Status. Um die Kommentare selbst zu ändern, siehe Presentation Comments. Exporteinstellungen bestimmen, ob Kommentare in PDF, HTML, Bildern, Notizen oder Handzetteln erscheinen.

FAQ

Warum ist das Raster ausgeblendet, wenn ich die Präsentation erneut öffne?

Die Präsentation speichert das Rasterintervall. Um das Raster zu sehen, aktivieren Sie die Rasteranzeige im Editor.

Ändert das Entfernen von Zeichenhilfen den Rasterabstand?

Nein. Das Hinzufügen, Verschieben oder Entfernen einer Hilfslinie lässt das Rasterintervall unverändert.

Können verschiedene Abschnitte einer Präsentation unterschiedliche Ansichtseinstellungen haben?

Nein. Presentation::getViewProperties gilt für die gesamte Präsentation.

Kann ich unterschiedliche Ansichtseinstellungen für verschiedene Benutzer speichern?

Die Datei speichert einen Satz von Ansichtseigenschaften für alle. Ein Editor kann zudem die lokalen Präferenzen eines Benutzers anwenden.

Kann ich Ansichtseinstellungen in einer Vorlage speichern?

Ja. Aus einer Vorlage erstellte Präsentationen übernehmen deren gespeicherte Ansichtseinstellungen.