.NET のプレゼンテーションで描画ガイドを管理する

このページの概要

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

概要

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

描画ガイドは編集支援ツールであり、スライドコンテンツではありません。スライドショーやレンダリングされた出力には表示されません。Aspose.Slides for .NET はこれらを IDrawingGuidesCollection インターフェイスで提供します。ガイドは IDrawingGuide で表され、向き、位置、色を持ちます。

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

スライドビューへのガイドの追加

通常のスライドを編集している間に表示されるガイドは、ICommonSlideViewProperties.DrawingGuides を使用して管理します。IDrawingGuidesCollection.Add に Orientation の値とポイント単位の位置を渡して呼び出します。

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

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var slideSize = presentation.SlideSize.Size;
var guides = presentation.ViewProperties.SlideViewProperties.DrawingGuides;

guides.Add(Orientation.Vertical, slideSize.Width / 2 + 12.5f);
guides.Add(Orientation.Horizontal, slideSize.Height / 2 + 12.5f);

presentation.Save("drawing-guides.pptx", SaveFormat.Pptx);

描画ガイドへのアクセス

IDrawingGuidesCollection.Count プロパティとインデクサーで既存のガイドにアクセスできます。IDrawingGuide.Orientation、IDrawingGuide.Position、および IDrawingGuide.Color プロパティは読み取りまたは変更可能です。

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

using Aspose.Slides;

using var presentation = new Presentation("drawing-guides.pptx");

var guides = presentation.ViewProperties.SlideViewProperties.DrawingGuides;

for (var index = 0; index < guides.Count; index++)
{
    var guide = guides[index];
    Console.WriteLine($"Guide {index}: orientation = {guide.Orientation}, position = {guide.Position}, color = {guide.Color}");
}

マスタとレイアウトスライドへのガイドの追加

スライドマスタとその各レイアウトスライドは、それぞれ独自の描画ガイドコレクションを持つことができます。マスタスライドの場合は IMasterSlide.DrawingGuides、レイアウトスライドの場合は ILayoutSlide.DrawingGuides を使用します。

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

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var slideSize = presentation.SlideSize.Size;
var masterGuides = presentation.Masters[0].DrawingGuides;
var layoutGuides = presentation.LayoutSlides[0].DrawingGuides;

masterGuides.Add(Orientation.Vertical, slideSize.Width / 2 - 20f);
layoutGuides.Add(Orientation.Horizontal, slideSize.Height / 2 + 20f);

presentation.Save("master-layout-drawing-guides.pptx", SaveFormat.Pptx);

ノートマスタとハンドアウトマスタへのガイドの追加

ノートマスタとハンドアウトマスタも描画ガイドをサポートします。各コレクションへは IMasterNotesSlide.DrawingGuides と IMasterHandoutSlide.DrawingGuides を使用してアクセスします。プレゼンテーションにこれらのマスタが含まれていない場合は、IMasterNotesSlideManager.SetDefaultMasterNotesSlide または IMasterHandoutSlideManager.SetDefaultMasterHandoutSlide がデフォルトマスタを作成し、返します。

次の例は、ノートマスタに水平ガイドを、ハンドアウトマスタに垂直ガイドを追加します。

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var notesSize = presentation.NotesSize.Size;
var notesMaster = presentation.MasterNotesSlideManager.SetDefaultMasterNotesSlide();
var handoutMaster = presentation.MasterHandoutSlideManager.SetDefaultMasterHandoutSlide();

notesMaster.DrawingGuides.Add(Orientation.Horizontal, notesSize.Height / 2 + 50f);
handoutMaster.DrawingGuides.Add(Orientation.Vertical, notesSize.Width / 2 - 50f);

presentation.Save("notes-handout-drawing-guides.pptx", SaveFormat.Pptx);

描画ガイドのクリア

IDrawingGuidesCollection.Clear を呼び出すと、特定のコレクション内のすべてのガイドが削除されます。1 つのコレクションをクリアしても、別のスコープに保存されたガイドには影響しません。

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

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation-with-guides.pptx");

presentation.ViewProperties.SlideViewProperties.DrawingGuides.Clear();

foreach (var masterSlide in presentation.Masters)
{
    masterSlide.DrawingGuides.Clear();
}

foreach (var layoutSlide in presentation.LayoutSlides)
{
    layoutSlide.DrawingGuides.Clear();
}

var notesMaster = presentation.MasterNotesSlideManager.MasterNotesSlide;
if (notesMaster != null)
{
    notesMaster.DrawingGuides.Clear();
}

var handoutMaster = presentation.MasterHandoutSlideManager.MasterHandoutSlide;
if (handoutMaster != null)
{
    handoutMaster.DrawingGuides.Clear();
}

presentation.Save("presentation-without-guides.pptx", SaveFormat.Pptx);

FAQ

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

いいえ。描画ガイドは編集用の配置補助であり、プレゼンテーションコンテンツとしてレンダリングされません。

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

通常スライドの編集ガイドはプレゼンテーションのスライドビュープロパティに保存されます。スライドマスタ、レイアウトスライド、ノートマスタ、ハンドアウトマスタ用の別個のガイドコレクションが用意されています。

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

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

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

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

.NET でプレゼンテーションスライドマスターを管理するスライドトランジション