.NET でプレゼンテーションの SmartArt シェイプノードを管理する

SmartArt ノードの追加

Aspose.Slides for .NET は、SmartArt 形状を最も簡単に管理できる API を提供しています。以下のサンプルコードは、SmartArt 形状内にノードと子ノードを追加する方法を示しています。

Presentation クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して最初のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArt に型キャストします。
SmartArt の NodeCollection に新しいノードを追加し、TextFrame にテキストを設定します。
追加した SmartArt ノードに子ノードを追加し、TextFrame にテキストを設定します。
プレゼンテーションを保存します。

// 目的のプレゼンテーションを読み込む
Presentation pres = new Presentation("AddNodes.pptx");

// 最初のスライド内のすべてのシェイプを走査する
foreach (IShape shape in pres.Slides[0].Shapes)
{

    // シェイプが SmartArt タイプか確認する
    if (shape is Aspose.Slides.SmartArt.SmartArt)
    {

        // シェイプを SmartArt に型キャストする
        Aspose.Slides.SmartArt.SmartArt smart = (Aspose.Slides.SmartArt.SmartArt)shape;

        // 新しい SmartArt ノードを追加する
        Aspose.Slides.SmartArt.SmartArtNode TemNode = (Aspose.Slides.SmartArt.SmartArtNode)smart.AllNodes.AddNode();

        // テキストを追加する
        TemNode.TextFrame.Text = "Test";

        // 親ノードに新しい子ノードを追加する。コレクションの末尾に追加される
        Aspose.Slides.SmartArt.SmartArtNode newNode = (Aspose.Slides.SmartArt.SmartArtNode)TemNode.ChildNodes.AddNode();

        // テキストを追加する
        newNode.TextFrame.Text = "New Node Added";

    }
}

// プレゼンテーションを保存する
pres.Save("AddSmartArtNode_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

特定の位置に SmartArt ノードを追加

以下のサンプルコードでは、SmartArt 形状のそれぞれのノードに属する子ノードを指定した位置に追加する方法を説明しています。

Presentation クラスのインスタンスを作成します。
インデックスを使用して最初のスライドの参照を取得します。
取得したスライドに StackedList タイプの SmartArt 形状を追加します。
追加した SmartArt 形状の最初のノードにアクセスします。
選択したノードの位置 2 に子ノードを追加し、テキストを設定します。
プレゼンテーションを保存します。

// プレゼンテーション インスタンスを作成する
Presentation pres = new Presentation();

// プレゼンテーション スライドにアクセスする
ISlide slide = pres.Slides[0];

// Smart Art IShape を追加する
ISmartArt smart = slide.Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);

// インデックス 0 の SmartArt ノードにアクセスする
ISmartArtNode node = smart.AllNodes[0];

// 親ノードの位置 2 に新しい子ノードを追加する
SmartArtNode chNode = (SmartArtNode)((SmartArtNodeCollection)node.ChildNodes).AddNodeByPosition(2);

// テキストを追加する
chNode.TextFrame.Text = "Sample Text Added";

// プレゼンテーションを保存する
pres.Save("AddSmartArtNodeByPosition_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

SmartArt ノードへのアクセス

以下のサンプルコードは、SmartArt 形状内のノードにアクセスする方法を示します。SmartArt の LayoutType は読み取り専用で、SmartArt 形状を追加したときにのみ設定されることに注意してください。

Presentation クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して最初のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArt に型キャストします。
SmartArt 形状内のすべてのノードを走査します。

SmartArt ノードの位置、階層、テキストなどの情報を取得して表示します。

// 必要なプレゼンテーションを読み込む
 Presentation pres = new Presentation("AccessSmartArt.pptx");
  
// 最初のスライド内のすべてのシェイプを走査する
foreach (IShape shape in pres.Slides[0].Shapes)
{
    // シェイプが SmartArt タイプか確認する
    if (shape is Aspose.Slides.SmartArt.SmartArt)
    {
  
        // シェイプを SmartArt に型キャストする
        Aspose.Slides.SmartArt.SmartArt smart = (Aspose.Slides.SmartArt.SmartArt)shape;
  
        // SmartArt 内のすべてのノードを走査する
        for (int i = 0; i < smart.AllNodes.Count; i++)
        {
            // インデックス i の SmartArt ノードにアクセスする
            Aspose.Slides.SmartArt.SmartArtNode node = (Aspose.Slides.SmartArt.SmartArtNode)smart.AllNodes[i];
  
            // SmartArt ノードのパラメータを出力する
            string outString = string.Format("i = {0}, Text = {1},  Level = {2}, Position = {3}", i, node.TextFrame.Text, node.Level, node.Position);
            Console.WriteLine(outString);
        }
    }
}

SmartArt 子ノードへのアクセス

以下のサンプルコードは、SmartArt 形状のそれぞれのノードに属する子ノードにアクセスする方法を示します。

PresentationEx クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して最初のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArtEx に型キャストします。
SmartArt 形状内のすべてのノードを走査します。
各 SmartArt ノードについて、該当ノード内のすべての子ノードを走査します。
子ノードの位置、階層、テキストなどの情報を取得して表示します。

 // 指定されたプレゼンテーションを読み込む
 Presentation pres = new Presentation("AccessChildNodes.pptx");

 // 最初のスライド内のすべてのシェイプを走査する
 foreach (IShape shape in pres.Slides[0].Shapes)
 {

     // シェイプが SmartArt タイプか確認する
     if (shape is Aspose.Slides.SmartArt.SmartArt)
     {

         // シェイプを SmartArt に型キャストする
         Aspose.Slides.SmartArt.SmartArt smart = (Aspose.Slides.SmartArt.SmartArt)shape;

         // SmartArt 内のすべてのノードを走査する
         for (int i = 0; i < smart.AllNodes.Count; i++)
         {
             // インデックス i の SmartArt ノードにアクセスする
             Aspose.Slides.SmartArt.SmartArtNode node0 = (Aspose.Slides.SmartArt.SmartArtNode)smart.AllNodes[i];

             // インデックス i の SmartArt ノードの子ノードを走査する
             for (int j = 0; j < node0.ChildNodes.Count; j++)
             {
                 // SmartArt ノードの子ノードにアクセスする
                 Aspose.Slides.SmartArt.SmartArtNode node = (Aspose.Slides.SmartArt.SmartArtNode)node0.ChildNodes[j];

                 // SmartArt 子ノードのパラメータを出力する
                 string outString = string.Format("j = {0}, Text = {1},  Level = {2}, Position = {3}", j, node.TextFrame.Text, node.Level, node.Position);
                 Console.WriteLine(outString);
             }
         }
     }
 }

特定の位置にある SmartArt 子ノードへのアクセス

この例では、SmartArt 形状のそれぞれのノードに属する子ノードを特定の位置で取得する方法を学びます。

Presentation クラスのインスタンスを作成します。
インデックスを使用して最初のスライドの参照を取得します。
StackedList タイプの SmartArt 形状を追加します。
追加した SmartArt 形状にアクセスします。
インデックス 0 のノードにアクセスします。
GetNodeByPosition() メソッドを使用して、取得した SmartArt ノードの位置 1 にある子ノードにアクセスします。
子ノードの位置、階層、テキストなどの情報を取得して表示します。

// プレゼンテーションをインスタンス化する
Presentation pres = new Presentation();

// 最初のスライドにアクセスする
ISlide slide = pres.Slides[0];

// 最初のスライドに SmartArt 形状を追加する
ISmartArt smart = slide.Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);

// インデックス 0 の SmartArt ノードにアクセスする
ISmartArtNode node = smart.AllNodes[0];

// 親ノードの位置 1 の子ノードにアクセスする
int position = 1;
SmartArtNode chNode = (SmartArtNode)node.ChildNodes[position]; 

// SmartArt 子ノードのパラメータを出力する
string outString = string.Format("j = {0}, Text = {1},  Level = {2}, Position = {3}", position, chNode.TextFrame.Text, chNode.Level, chNode.Position);
Console.WriteLine(outString);

SmartArt ノードの削除

この例では、SmartArt 形状内のノードを削除する方法を学びます。

Presentation クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して最初のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArt に型キャストします。
SmartArt に 0 以上のノードがあるか確認します。
削除対象の SmartArt ノードを選択します。
RemoveNode() メソッドを使用して選択したノードを削除し、プレゼンテーションを保存します。

// 指定されたプレゼンテーションを読み込む
using (Presentation pres = new Presentation("RemoveNode.pptx"))
{

    // 最初のスライド内のすべてのシェイプを走査する
    foreach (IShape shape in pres.Slides[0].Shapes)
    {

        // シェイプが SmartArt タイプか確認する
        if (shape is ISmartArt)
        {
            // シェイプを SmartArtEx に型キャストする
            ISmartArt smart = (ISmartArt)shape;

            if (smart.AllNodes.Count > 0)
            {
                // インデックス 0 の SmartArt ノードにアクセスする
                ISmartArtNode node = smart.AllNodes[0];

                // 選択したノードを削除する
                smart.AllNodes.RemoveNode(node);

            }
        }
    }

    // プレゼンテーションを保存する
    pres.Save("RemoveSmartArtNode_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

特定の位置にある SmartArt ノードの削除

この例では、SmartArt 形状内のノードを特定の位置で削除する方法を学びます。

Presentation クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して最初のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArt に型キャストします。
インデックス 0 の SmartArt ノードを選択します。
選択した SmartArt ノードに 2 つ以上の子ノードがあるか確認します。
RemoveNodeByPosition() メソッドを使用して位置 1 のノードを削除します。
プレゼンテーションを保存します。

 // 指定されたプレゼンテーションを読み込む             
 Presentation pres = new Presentation("RemoveNodeSpecificPosition.pptx");

// 最初のスライド内のすべてのシェイプを走査する
foreach (IShape shape in pres.Slides[0].Shapes)
{
    // シェイプが SmartArt タイプか確認する
    if (shape is Aspose.Slides.SmartArt.SmartArt)
    {
        // シェイプを SmartArt に型キャストする
        Aspose.Slides.SmartArt.SmartArt smart = (Aspose.Slides.SmartArt.SmartArt)shape;

        if (smart.AllNodes.Count > 0)
        {
            // インデックス 0 の SmartArt ノードにアクセスする
            Aspose.Slides.SmartArt.ISmartArtNode node = smart.AllNodes[0];

            if (node.ChildNodes.Count >= 2)
            {
                // 位置 1 の子ノードを削除する
                ((Aspose.Slides.SmartArt.SmartArtNodeCollection)node.ChildNodes).RemoveNode(1);
            }

        }
    }
}

// プレゼンテーションを保存する
pres.Save("RemoveSmartArtNodeByPosition_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

SmartArt オブジェクト内の子ノードにカスタム位置を設定

現在、Aspose.Slides for .NET は SmartArtShape の X と Y プロパティの設定をサポートしています。以下のコードスニペットは、カスタム位置、サイズ、回転を設定する方法を示します。新しいノードを追加すると、すべてのノードの位置とサイズが再計算されることに注意してください。

// 指定されたプレゼンテーションを読み込む
Presentation pres = new Presentation("AccessChildNodes.pptx");

{
	ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart);

	// SmartArt 形状を新しい位置に移動する
	ISmartArtNode node = smart.AllNodes[1];
	ISmartArtShape shape = node.Shapes[1];
	shape.X += (shape.Width * 2);
	shape.Y -= (shape.Height / 2);

	// SmartArt 形状の幅を変更する
	node = smart.AllNodes[2];
	shape = node.Shapes[1];
	shape.Width += (shape.Width / 2);

	// SmartArt 形状の高さを変更する
	node = smart.AllNodes[3];
	shape = node.Shapes[1];
	shape.Height += (shape.Height / 2);

	// SmartArt 形状の回転を変更する
	node = smart.AllNodes[4];
	shape = node.Shapes[1];
	shape.Rotation = 90;

	pres.Save("SmartArt.pptx", SaveFormat.Pptx);
}

アシスタントノードの確認

以下のサンプルコードでは、SmartArt ノードコレクション内のアシスタントノードを特定し、状態を変更する方法を調査します。

PresentationEx クラスのインスタンスを作成し、SmartArt 形状を含むプレゼンテーションを読み込みます。
インデックスを使用して 2 番目のスライドの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば SmartArtEx に型キャストします。
SmartArt 形状内のすべてのノードを走査し、アシスタントノードかどうかをチェックします。
アシスタントノードのステータスを通常ノードに変更します。
プレゼンテーションを保存します。

// プレゼンテーション インスタンスを作成する
using (Presentation pres = new Presentation("AssistantNode.pptx"))
{
    // 最初のスライド内のすべてのシェイプを走査する
    foreach (IShape shape in pres.Slides[0].Shapes)
    {
        // シェイプが SmartArt タイプか確認する
        if (shape is Aspose.Slides.SmartArt.ISmartArt)
        {
            // シェイプを SmartArtEx に型キャストする
            Aspose.Slides.SmartArt.ISmartArt smart = (Aspose.Slides.SmartArt.SmartArt)shape;
            // SmartArt 形状のすべてのノードを走査する

            foreach (Aspose.Slides.SmartArt.ISmartArtNode node in smart.AllNodes)
            {
                String tc = node.TextFrame.Text;
                // ノードがアシスタント ノードか確認する
                if (node.IsAssistant)
                {
                    // アシスタント ノードを false に設定し、通常ノードにする
                    node.IsAssistant = false;
                }
            }
        }
    }
    // プレゼンテーションを保存する
    pres.Save("ChangeAssitantNode_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

ノードの塗りつぶし形式の設定

Aspose.Slides for .NET を使用すると、カスタム SmartArt 形状を追加し、その塗りつぶし形式を設定できます。この記事では、SmartArt 形状の作成とアクセス、および塗りつぶし形式の設定方法を説明します。

以下の手順に従ってください。

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドの参照を取得します。
LayoutType を設定して SmartArt 形状を追加します。
SmartArt 形状ノードの FillFormat を設定します。
修正したプレゼンテーションを PPTX ファイルとして保存します。

using (Presentation presentation = new Presentation())
{
    // スライドにアクセスする
    ISlide slide = presentation.Slides[0];

    // SmartArt 形状とノードを追加する
    var chevron = slide.Shapes.AddSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess);
    var node = chevron.AllNodes.AddNode();
    node.TextFrame.Text = "Some text";

    // ノードの塗りつぶし色を設定する
    foreach (var item in node.Shapes)
    {
        item.FillFormat.FillType = FillType.Solid;
        item.FillFormat.SolidFillColor.Color = Color.Red;
    }

    // プレゼンテーションを保存する
    presentation.Save("FillFormat_SmartArt_ShapeNode_out.pptx", SaveFormat.Pptx);
}

SmartArt 子ノードのサムネイル生成

開発者は以下の手順で SmartArt の子ノードのサムネイルを生成できます。

PPTX ファイルを表す Presentation クラスのインスタンスを作成します。
SmartArt を追加します。
インデックスを使用してノードの参照を取得します。
サムネイル画像を取得します。
任意の画像形式でサムネイルを保存します。

以下の例は SmartArt 子ノードのサムネイルを生成するものです。

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    ISmartArt smartArt = slide.Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle);
    ISmartArtNode node = smartArt.Nodes[1];

    using (IImage image = node.Shapes[0].GetImage())
    {
        image.Save("SmartArt_ChildNote_Thumbnail_out.jpeg", ImageFormat.Jpeg);
    }
}

FAQ

SmartArt アニメーションはサポートされていますか？

はい。SmartArt は通常のシェイプとして扱われるため、apply standard animations（出入り、強調、モーションパス）を適用したり、タイミングを調整したりできます。また、必要に応じて SmartArt ノード内のシェイプを個別にアニメーション化することも可能です。

スライド上で内部 ID が不明な特定の SmartArt を確実に検索するにはどうすればよいですか？

alternative text を設定して検索します。SmartArt に固有の AltText を付与すれば、内部識別子に依存せずプログラムから容易に見つけることができます。

プレゼンテーションを PDF に変換した際、SmartArt の外観は保持されますか？

はい。Aspose.Slides は PDF export 時に SmartArt を高い視覚忠実度でレンダリングし、レイアウト、色、効果を保持します。

SmartArt 全体の画像（プレビューやレポート用）を抽出できますか？

はい。SmartArt 形状を raster formats または SVG にレンダリングできるため、サムネイル、レポート、Web 用に適した画像を取得できます。

.NET でプレゼンテーションの SmartArt グラフィックを管理

.NET でプレゼンテーションの SmartArt シェイプ ノードを管理する