C++ のプレゼンテーション ビュー プロパティの取得と更新

INormalViewProperties について

通常ビューのプロパティを表します。

プロパティShowOutlineIconsは、通常ビュー モードの任意のコンテンツ領域でアウトライン コンテンツを表示する際に、アプリケーションがアイコンを表示すべきかどうかを指定します。

プロパティSnapVerticalSplitterは、側面領域が十分に小さい場合に、垂直スプリッタが最小化状態にスナップすべきかどうかを指定します。

プロパティPreferSingleViewは、ユーザーが3つのコンテンツ領域を持つ標準の通常ビューではなく、ウィンドウ全体に単一のコンテンツ領域を表示するフルウィンドウ表示を好むかどうかを指定します。有効にすると、アプリケーションはウィンドウ全体に1つのコンテンツ領域を表示することを選択できる場合があります。

プロパティVerticalBarStateおよびHorizontalBarStateは、水平スプリッタバーまたは垂直スプリッタバーがどの状態で表示されるべきかを指定します。水平スプリッタバーはスライドとスライド下部のコンテンツ領域を分割し、垂直スプリッタバーはスライドと側面コンテンツ領域を分割します。可能な値はSplitterBarStateType.Minimized、SplitterBarStateType.Maximized、SplitterBarStateType.Restoredです。

プロパティRestoredLeftおよびRestoredTopは、VerticalBarStateおよびHorizontalBarStateにSplitterBarStateType.Restoredが適用された場合に、通常ビューの上部または側面スライド領域のサイズを指定します。

INormalViewProperties の復元について

領域が可変の復元サイズ（最小化でも最大化でもない）である場合の、通常ビューのスライド領域（RestoredTop の子の場合は幅、RestoredLeft の子の場合は高さ）のサイズを指定します。

プロパティDimensionSizeは、スライド領域のサイズ（restoredTop の子の場合は幅、restoredLeft の子の場合は高さ）を指定します。

プロパティAutoAdjustは、ウィンドウのサイズ変更時に、側面コンテンツ領域のサイズが新しいサイズに合わせて自動的に調整されるべきかどうかを指定します。

以下の例は、プレゼンテーションのViewProperties.NormalViewPropertiesプロパティにアクセスする方法を示しています。

auto pres = System::MakeObject<Presentation>(u"demo.pptx");
pres->get_ViewProperties()->get_NormalViewProperties()->set_HorizontalBarState(SplitterBarStateType::Restored);
pres->get_ViewProperties()->get_NormalViewProperties()->set_VerticalBarState(SplitterBarStateType::Maximized);

// プレゼンテーションのビュー プロパティを復元する
pres->get_ViewProperties()->get_NormalViewProperties()->get_RestoredTop()->set_AutoAdjust(true);
pres->get_ViewProperties()->get_NormalViewProperties()->get_RestoredTop()->set_DimensionSize(80.0f);
pres->get_ViewProperties()->get_NormalViewProperties()->set_ShowOutlineIcons(true);

pres->Save(u"presentation_normal_view_state.pptx", SaveFormat::Pptx);

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

Aspose.Slides for C++ は、プレゼンテーションが開かれたときにズームが既に設定された状態になるよう、デフォルト ズーム値を設定できるようになりました。これはプレゼンテーションのViewPropertiesを設定することで実現できます。スライド ビュー プロパティだけでなく、get_NotesViewPropertiesもプログラムから設定可能です。このトピックでは、Aspose.Slides でプレゼンテーションのビュー プロパティを設定する方法を例で示します。

ビュー プロパティを設定するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します
  2. プレゼンテーションのビューPropertiesを設定します
  3. プレゼンテーションを PPTX ファイルとして保存します

以下の例では、スライドビューとノートビューのズーム値を設定しています。

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");

// プレゼンテーションのビュー プロパティを設定する
presentation->get_ViewProperties()->get_SlideViewProperties()->set_Scale(100); // スライドビューのズーム値（パーセンテージ）
presentation->get_ViewProperties()->get_NotesViewProperties()->set_Scale(100); // ノートビューのズーム値（パーセンテージ） 

presentation->Save(u"Zoom_out.pptx", SaveFormat::Pptx);

よくある質問

プレゼンテーションの異なるセクションごとに異なるビュー設定を設定できますか？

View settingsはプレゼンテーション レベル（Normal View/Slide View）で定義されており、セクション単位ではありません。そのため、ドキュメントが開かれるときは単一のパラメーターセットが全体に適用されます。

異なるユーザー向けに異なるビュー状態を事前に定義できますか？

できません。設定はファイルに保存され、共有されます。ビューア アプリケーションはユーザーの好みを尊重することはありますが、ファイル自体には1つのビュー プロパティしか含まれません。

テンプレートに事前定義された View Properties を埋め込めば、新しいプレゼンテーションが同じ方法で開くようにできますか？

はい。view propertiesはプレゼンテーション レベルに保存されるため、テンプレートに埋め込んでおけば、そのテンプレートから作成された新しいドキュメントは同じ初期ビュー設定で開きます。

C++ でプレゼンテーション プロパティを管理する C++でプレゼンテーションコメントを管理する