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

導入

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

INormalViewProperties について

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

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

INormalViewProperties の復元について

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("demo.pptx");
try {
    INormalViewProperties 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% ズームを設定します。

import com.aspose.slides.*;

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

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

グリッド間隔を設定する

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("demo.pptx");
try {
    IViewProperties viewProperties = presentation.getViewProperties();
    System.out.println("Current grid spacing: " + viewProperties.getGridSpacing() + " points");

    viewProperties.setGridSpacing(18f);
    
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

グリッドは固定間隔で繰り返されます。Drawing guides は個別の水平または垂直位置をマークします。どちらも編集支援ツールであり、表示できるエディタでのみ表示されます。スライドショーや PDF、画像、SVG へのエクスポートではこれらは除外されます。

プレゼンテーションを開くときのコメントの表示/非表示

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("comments.pptx");
try {
    IViewProperties viewProperties = presentation.getViewProperties();
    System.out.println("Current comment visibility: " + viewProperties.getShowComments());

    viewProperties.setShowComments(NullableBool.False);
    viewProperties.setLastView(ViewType.SlideView);

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

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

FAQ

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

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

描画ガイドを削除してもグリッド間隔は変わりますか?

いいえ。ガイドを追加、移動、削除してもグリッド間隔は変わりません。

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

いいえ。Presentation.getViewProperties はプレゼンテーション全体に適用されます。

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

ファイルは全員用に 1 つのビュー設定セットを保存します。エディタはユーザー固有のローカル設定を適用することがあります。

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

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