プレゼンテーションビューのプロパティ
通常のビューは、スライド自体、サイドコンテンツ領域、ボトムコンテンツ領域の3つのコンテンツ領域で構成されています。さまざまなコンテンツ領域の配置に関するプロパティです。この情報により、アプリケーションは、ファイルにビューステートを保存できるため、再オープンした際に、プレゼンテーションが最後に保存された時と同じ状態で表示されます。
メソッド IViewProperties.getNormalViewPropertiesが追加され、プレゼンテーションの通常のビューのプロパティにアクセスできるようになりました。
INormalViewProperties、INormalViewRestoredPropertiesインターフェイスとその子孫、SplitterBarStateType列挙型が追加されました。
INormalViewPropertiesについて
通常のビューのプロパティを表します。
メソッド getShowOutlineIcons と setShowOutlineIcons は、アプリケーションが通常のビュー モードのいずれかのコンテンツ領域でアウトライン コンテンツを表示する場合にアイコンを表示するかどうかを指定します。
メソッド getSnapVerticalSplitter と setSnapVerticalSplitter は、サイド領域が十分に小さい場合に、垂直スプリッタが最小化された状態にスナップするかどうかを指定します。
プロパティ getPreferSingleView と setPreferSingleView は、ユーザーが 3 つのコンテンツ領域のある標準の通常ビューよりもフルウィンドウの単一コンテンツ領域を表示することを好むかどうかを指定します。これが有効になっている場合、アプリケーションはウィンドウ全体でコンテンツ領域のいずれかを表示することを選択できます。
メソッド getVerticalBarState と getHorizontalBarState は、水平分割バーまたは垂直分割バーが表示されるべき状態を指定します。水平スプリッタバーはスライドをその下のコンテンツ領域から、垂直スプリッタバーはスライドをサイドコンテンツ領域から分離します。可能な値は、SplitterBarStateType::Minimized、SplitterBarStateType::Maximized、および SplitterBarStateType::Restoredです。
メソッド getRestoredLeft と getRestoredTop は、通常のビューの上部またはサイドスライド領域のサイズを指定します。SplitterBarStateType::Restored の値が getVerticalBarState および getHorizontalBarState に適用されます。
INormalViewPropertiesの復元について
通常のビューのスライド領域(getRestoredTop の子の場合は幅、getRestoredLeft の子の場合は高さ)のサイズを指定します。領域が変動する復元サイズ(最小化も最大化もされていない)の場合です。
メソッド getDimensionSize は、スライド領域のサイズ(復元された上部の子の場合の幅、復元された左の子の場合の高さ)を指定します。
メソッド getAutoAdjust は、ウィンドウサイズを変更する際にサイドコンテンツ領域のサイズが新しいサイズに補正されるべきかどうかを指定します。
以下の例では、ViewProperties.getNormalViewProperties のプロパティにアクセスする方法を示します。
# プレゼンテーションファイルを表すPresentationオブジェクトをインスタンス化
$pres = new Presentation();
try {
$pres->getViewProperties()->getNormalViewProperties()->setHorizontalBarState(SplitterBarStateType::Restored);
$pres->getViewProperties()->getNormalViewProperties()->setVerticalBarState(SplitterBarStateType::Maximized);
# プレゼンテーションのビュー設定を復元
$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();
}
デフォルトズーム値の設定
ビューのプロパティを設定するために、以下の手順に従ってください:
- Presentation クラスのインスタンスを作成します。
- Presentation の View Properties を設定します。
- プレゼンテーションを PPTXファイルとして書き込みます。 以下の例では、スライドビューとノートビューの両方のズーム値を設定しています。
# プレゼンテーションファイルを表すPresentationオブジェクトをインスタンス化
$presentation = new Presentation();
try {
# プレゼンテーションのビュー設定
$presentation->getViewProperties()->getSlideViewProperties()->setScale(100);// スライドビューのズーム値(パーセンテージ)
$presentation->getViewProperties()->getNotesViewProperties()->setScale(100);// ノートビューのズーム値(パーセンテージ)
$presentation->save("Zoom_out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}