PHP でプレゼンテーションの描画ガイドを管理

このページの概要

Aspose.Slides for PHP via Java を使用して、PowerPoint プレゼンテーションに水平および垂直の描画ガイドを追加、取得、クリアします。

概要

描画ガイドは、調整可能な水平および垂直の線で、PowerPoint でプレゼンテーションを編集する際に図形を一貫して配置するのに役立ちます。アプリケーションが後で手動で調整されるプレゼンテーションを生成する場合に特に便利です。アプリケーションは、コンテンツを追加または移動する際に作者が従うべき同じ整列支援情報を保存できます。

描画ガイドは編集支援ツールであり、スライドコンテンツではありません。スライドショーやレンダリングされた出力には表示されません。Aspose.Slides for PHP via Java は、DrawingGuidesCollection クラスを介してこれらを提供します。ガイドは DrawingGuide で表され、方向、位置、色を持ちます。

位置は、対象スライドまたはマスターの左上隅からのポイントで測定されます。垂直ガイドは水平座標を使用し、通常は 0 からスライド幅までの範囲です。水平ガイドは垂直座標を使用し、通常は 0 からスライド高さまでの範囲です。

スライドビューにガイドを追加

CommonSlideViewProperties::getDrawingGuides を使用して、通常のスライドを編集しているときに表示されるガイドを管理します。DrawingGuidesCollection::add に Orientation の値とポイント単位の位置を指定して呼び出します。

次の例は、スライドの中心の右側に垂直ガイドを 1 本、下側に水平ガイドを 1 本追加します。

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

$presentation = new Presentation();
try {
    $slideSize = $presentation->getSlideSize()->getSize();
    $slideWidth = java_values($slideSize->getWidth());
    $slideHeight = java_values($slideSize->getHeight());
    $guides = $presentation->getViewProperties()->getSlideViewProperties()->getDrawingGuides();

    $guides->add(Orientation::Vertical, $slideWidth / 2 + 12.5);
    $guides->add(Orientation::Horizontal, $slideHeight / 2 + 12.5);

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

描画ガイドへのアクセス

DrawingGuidesCollection::getCount および DrawingGuidesCollection::get_Item メソッドで既存のガイドにアクセスできます。DrawingGuide::getOrientation、DrawingGuide::getPosition、DrawingGuide::getColor メソッドは値を返し、対応するセッターで変更可能です。

次の例は、上記で作成したプレゼンテーションからスライドビューガイドを読み取ります。

use aspose\slides\Presentation;

$presentation = new Presentation("drawing-guides.pptx");
try {
    $guides = $presentation->getViewProperties()->getSlideViewProperties()->getDrawingGuides();
    $guideCount = java_values($guides->getCount());

    for ($index = 0; $index < $guideCount; $index++) {
        $guide = $guides->get_Item($index);
        $orientation = java_values($guide->getOrientation());
        $position = java_values($guide->getPosition());
        $color = java_values($guide->getColor()->toString());
        echo sprintf("Guide %d: orientation = %d, position = %.2f, color = %s", $index, $orientation, $position, $color) . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

マスターおよびレイアウトスライドにガイドを追加

スライドマスターとその各レイアウトスライドは、独自の描画ガイドコレクションを持つことができます。マスタースライドの場合は MasterSlide::getDrawingGuides、レイアウトスライドの場合は LayoutSlide::getDrawingGuides を使用します。

次の例は、最初のマスタースライドに垂直ガイドを、最初のレイアウトスライドに水平ガイドを追加します。

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

$presentation = new Presentation();
try {
    $slideSize = $presentation->getSlideSize()->getSize();
    $slideWidth = java_values($slideSize->getWidth());
    $slideHeight = java_values($slideSize->getHeight());
    $masterGuides = $presentation->getMasters()->get_Item(0)->getDrawingGuides();
    $layoutGuides = $presentation->getLayoutSlides()->get_Item(0)->getDrawingGuides();

    $masterGuides->add(Orientation::Vertical, $slideWidth / 2 - 20);
    $layoutGuides->add(Orientation::Horizontal, $slideHeight / 2 + 20);

    $presentation->save("master-layout-drawing-guides.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

ノートマスターおよび配布資料マスターにガイドを追加

ノートマスターと配布資料マスターも描画ガイドをサポートします。MasterNotesSlide::getDrawingGuides と MasterHandoutSlide::getDrawingGuides を使用してコレクションにアクセスします。プレゼンテーションにこれらのマスターが含まれていない場合は、Presentation::getMasterNotesSlideManager または Presentation::getMasterHandoutSlideManager で適切なマネージャーを取得し、setDefaultMasterNotesSlide または setDefaultMasterHandoutSlide でデフォルトマスターを作成します。

次の例は、ノートマスターに水平ガイドを、配布資料マスターに垂直ガイドを追加します。

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

$presentation = new Presentation();
try {
    $notesSize = $presentation->getNotesSize()->getSize();
    $notesWidth = java_values($notesSize->getWidth());
    $notesHeight = java_values($notesSize->getHeight());
    $notesMaster = $presentation->getMasterNotesSlideManager()->setDefaultMasterNotesSlide();
    $handoutMaster = $presentation->getMasterHandoutSlideManager()->setDefaultMasterHandoutSlide();

    $notesMaster->getDrawingGuides()->add(Orientation::Horizontal, $notesHeight / 2 + 50);
    $handoutMaster->getDrawingGuides()->add(Orientation::Vertical, $notesWidth / 2 - 50);

    $presentation->save("notes-handout-drawing-guides.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

描画ガイドのクリア

DrawingGuidesCollection::clear を呼び出すと、特定のコレクション内のすべてのガイドが削除されます。あるコレクションをクリアしても、別のスコープに保存されているガイドには影響しません。

次の例は、スライドビューガイドとスライドマスター、レイアウトスライド、ノートマスター、配布資料マスター上のすべてのガイドを、マスターが存在しない場合は作成せずにクリアします。

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

$presentation = new Presentation("presentation-with-guides.pptx");
try {
    $presentation->getViewProperties()->getSlideViewProperties()->getDrawingGuides()->clear();

    $masterCount = java_values($presentation->getMasters()->size());
    for ($index = 0; $index < $masterCount; $index++) {
        $presentation->getMasters()->get_Item($index)->getDrawingGuides()->clear();
    }

    $layoutCount = java_values($presentation->getLayoutSlides()->size());
    for ($index = 0; $index < $layoutCount; $index++) {
        $presentation->getLayoutSlides()->get_Item($index)->getDrawingGuides()->clear();
    }

    $notesMaster = $presentation->getMasterNotesSlideManager()->getMasterNotesSlide();
    if (!java_is_null($notesMaster)) {
        $notesMaster->getDrawingGuides()->clear();
    }

    $handoutMaster = $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide();
    if (!java_is_null($handoutMaster)) {
        $handoutMaster->getDrawingGuides()->clear();
    }

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

FAQ

描画ガイドはスライドショーやエクスポートされた画像に表示されますか？

いいえ。描画ガイドは編集時の整列支援であり、プレゼンテーションコンテンツとしてはレンダリングされません。

描画ガイドを個々の通常スライドに直接追加できますか？

通常スライドの編集ガイドはプレゼンテーションのスライドビュープロパティに保存されます。スライドマスター、レイアウトスライド、ノートマスター、配布資料マスター用の別個のガイドコレクションも利用可能です。

ガイド位置の単位は何ですか？

位置はポイントで指定され、72 ポイントが 1 インチに相当します。垂直位置は左端から、水平位置は上端から測定されます。

描画ガイドをクリアするとシェイプやスライドコンテンツが削除または変更されますか？

いいえ。DrawingGuidesCollection::clear メソッドは選択されたコレクション内のガイドのみを削除します。シェイプやその他のスライドコンテンツは変更されません。

PHP を使用したプレゼンテーションのスライド遷移の管理 PHP でプレゼンテーションのスライドセクションを管理する