PHPでプレゼンテーションのビュー プロパティを取得および更新する

概要

PowerPoint の標準ビューでは、スライドはサムネイルまたはアウトライン用のサイドペインと、下部のノートペインの間に表示されます。Aspose.Slides for PHP via Java は、Presentation::getViewProperties を通じてプレゼンテーションの保存された編集設定を公開します。これにはペインのレイアウト、ズームレベル、グリッド間隔、コメントの表示状態が含まれます。

NormalViewPropertiesについて

getNormalViewProperties を使用して NormalViewProperties クラスにアクセスします。setShowOutlineIcons はアウトラインでスライドタイトルの横にアイコンを表示するかどうかを制御します。setSnapVerticalSplitter はユーザーがサイドペインを狭めたときに最小化状態にスナップさせます。setPreferSingleView は全ウィンドウで 1 つのペインを表示することを優先します。

setVerticalBarState はサイドペインとスライドの間の区切りバーを制御し、setHorizontalBarState はノートペイン上部の区切りバーを制御します。両方とも Minimized、Maximized、または Restored のいずれかの SplitterBarStateType 値を受け取ります。

NormalViewPropertiesの復元について

区切りバーが復元されると、getRestoredLeft はサイドペインの保存されたサイズを、getRestoredTop は上部スライド領域の保存されたサイズを提供します。両方とも NormalViewRestoredProperties を公開します。その setDimensionSize メソッドは 0 から 100 のパーセンテージを受け取り、setAutoAdjust はウィンドウのサイズ変更時にエディタがサイズを自動調整するかどうかを制御します。

この例は既存のプレゼンテーションを更新します。水平区切りバーを復元し、getRestoredTop が返すサイズを自動調整有効で 80% に設定し、垂直区切りバーを最大化します。また、setShowOutlineIcons を呼び出してアウトラインビューにアイコンを表示します。

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();
}

デフォルトのズーム値を設定する

getSlideViewProperties と getNotesViewProperties はエディタ用に個別のズーム設定を保存します。これらの設定はスライドサイズ、スライドショーの再生、画像エクスポートの解像度には影響しません。

この例は既存のプレゼンテーションを開き、setVariableScale を呼び出してスライドを編集ウィンドウに合わせます。ノートページについては自動スケーリングを無効にし、setScale で固定の 80% ズームを設定します。

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();
}

グリッド間隔を設定する

ViewProperties の setGridSpacing メソッドは、プレゼンテーション全体の編集グリッド線間の距離を設定します。単位はポイントで、1 インチあたり 72 ポイントです。この例は既存のプレゼンテーションで現在の間隔を出力し、間隔を 18 ポイントに設定して 1/4 インチのグリッドを保存します。

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();
}

グリッドは固定間隔で繰り返されます。描画ガイド は個別の水平または垂直位置を示します。両方とも編集支援機能であり、表示できるエディタでのみ表示されます。スライドショーや PDF、画像、SVG へのエクスポートには含まれません。

プレゼンテーションを開くときにコメントを表示または非表示にする

setShowComments は、互換性のあるエディタがプレゼンテーションを開く際に使用する設定を保存します。コメント付きの既存プレゼンテーションについて、この例は現在の設定を出力し、コメントを非表示にしたコピーを保存します。また、setLastView に ViewType::SlideView を指定して、コピーがスライドビューで開くようにします。

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();
}

コメントを非表示にしても、テキスト、作者、位置、返信、ステータスは保持されます。コメント自体を変更するには、Presentation Comments を参照してください。エクスポート設定で PDF、HTML、画像、ノート、配布資料にコメントを含めるかどうかを制御できます。

よくある質問

プレゼンテーションを再度開くときにグリッドが非表示になるのはなぜですか?

プレゼンテーションはグリッド間隔を保存しています。グリッドを表示させるには、エディタでグリッドの表示を有効にしてください。

描画ガイドをクリアするとグリッド間隔が変わりますか?

いいえ。ガイドを追加、移動、またはクリアしてもグリッド間隔は変更されません。

プレゼンテーションの異なるセクションで異なるビュー設定を持たせることはできますか?

できません。Presentation::getViewProperties はプレゼンテーション全体に適用されます。

異なるユーザーごとに別々のビュー設定を保存できますか?

ファイルは全ユーザー共通のビュー設定を 1 つだけ保存します。エディタ側でユーザーのローカル設定を適用することはあります。

テンプレートにビュー設定を保存できますか?

はい。テンプレートから作成されたプレゼンテーションは、テンプレートに保存されたビュー設定を継承します。