.NET でのプレゼンテーションのテキストボックスの管理

このページの概要

Aspose.Slides for .NET を使用して、PowerPoint および OpenDocument プレゼンテーション内のテキストボックスを作成、識別、書式設定、更新します。

はじめに

Aspose.Slides for .NET では、スライドのテキストはシェイプに属するテキストフレームに保存されます。IAutoShape インターフェイスは最も一般的なテキストを保持するシェイプを表し、テキストは IAutoShape.TextFrame プロパティを介して取得できます。

Note

すべてのオートシェイプはIShape を実装していますが、すべてのシェイプがオートシェイプであるわけでもテキストフレームをサポートしているわけでもありません。既存のプレゼンテーションを処理する際は、シェイプが IAutoShape を実装しているか確認してからテキストにアクセスしてください。

スライド上にテキストボックスを作成

テキストボックスを作成するには、スライドにオートシェイプを追加し、そのテキストフレームにテキストを設定してプレゼンテーションを保存します。以下の例は長方形のテキストボックスを作成します：

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

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 300, 50);
textBox.AddTextFrame("Aspose TextBox");

presentation.Save("TextBox.pptx", SaveFormat.Pptx);

IShapeCollection.AddAutoShape に渡される座標とサイズはポイントで測定されます。IAutoShape.AddTextFrame は指定されたテキストでテキストフレームを初期化します。

テキストボックスシェイプかどうかを確認

AutoShape.IsTextBox プロパティを使用して、オートシェイプがテキストボックスとして扱われるかどうかを判定します。プレゼンテーションにテキストを保持するシェイプと純粋にグラフィックだけのシェイプの両方が含まれる場合に便利です。

テキストボックスとシェイプ

以下の例はプレゼンテーション内のすべてのオートシェイプを検査します：

using System;
using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 120, 40);
textBox.AddTextFrame("Text box");
slide.Shapes.AddAutoShape(ShapeType.Ellipse, 150, 10, 40, 40);

foreach (var currentSlide in presentation.Slides)
{
    foreach (var shape in currentSlide.Shapes)
    {
        if (shape is IAutoShape autoShape)
        {
            Console.WriteLine(autoShape.IsTextBox ? "The shape is a text box." : "The shape is not a text box.");
        }
    }
}

新しく追加されたオートシェイプは、空でないテキストが設定されるまでテキストボックスとはみなされません。そのテキストはIAutoShape.AddTextFrame またはITextFrame.Textで提供できます。空文字列を追加または代入した場合、IsTextBox は false のままです：

using System;
using Aspose.Slides;

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

var shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
shape1.AddTextFrame("Shape 1");
Console.WriteLine(shape1.IsTextBox);

var shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 70, 100, 40);
shape2.TextFrame.Text = "Shape 2";
Console.WriteLine(shape2.IsTextBox);

var shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 130, 100, 40);
shape3.AddTextFrame("");
Console.WriteLine(shape3.IsTextBox);

var shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 190, 100, 40);
shape4.TextFrame.Text = "";
Console.WriteLine(shape4.IsTextBox);

最初の 2 回の呼び出しは True を出力し、最後の 2 回は False を出力します。

テキストフレームを所有するシェイプを見つける

汎用的なテキスト処理コードは、どのプレゼンテーションオブジェクトが所有しているか分からないままITextFrame を受け取ることがあります。読み取り専用のITextFrame.ParentShape プロパティを使用して、所有者であるIShape に遡ります。

オートシェイプや他のテキストを保持するシェイプが所有するテキストフレームの場合、ParentShape に所有者が格納され、ITextFrame.ParentCell は null です。アクセスする前に返された値を確認してください。シェイプとテーブルセルの両方の所有者（SmartArt ノードに関連付けられたシェイプを含む）を特定するには、Search and Replace Text を参照してください。

テキストボックスに列を追加

ITextFrameFormat.ColumnCount プロパティはテキストフレームを列に分割し、ITextFrameFormat.ColumnSpacing は列間の間隔をポイントで設定します。これらの設定はすべてITextFrameFormat に属し、既存のテキストボックスのテキストフレームを介して変更できます。同一シェイプ内で列間でテキストが再配置されますが、別のシェイプに続くことはありません。

以下の例は、列間 10 ポイントの 3 列テキストボックスを作成し、プレゼンテーションを保存して、出力ファイルから保存された設定を読み戻します：

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

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 200);
textBox.AddTextFrame("This text is distributed automatically across all columns in the text box.");

var textFrameFormat = textBox.TextFrame.TextFrameFormat;
textFrameFormat.ColumnCount = 3;
textFrameFormat.ColumnSpacing = 10;

presentation.Save("TextBoxColumns.pptx", SaveFormat.Pptx);

using var savedPresentation = new Presentation("TextBoxColumns.pptx");
var savedTextBox = (IAutoShape)savedPresentation.Slides[0].Shapes[0];
var savedFormat = savedTextBox.TextFrame.TextFrameFormat;
Console.WriteLine($"Columns: {savedFormat.ColumnCount}; spacing: {savedFormat.ColumnSpacing} points");

個別列からテキストを抽出

TextFrame.SplitTextByColumns を使用して、既存のテキストフレーム内の各視覚列に割り当てられたテキストを取得します。このメソッドは列ごとに 1 つの文字列を、列ベースの読み順で返します。1 列のテキストフレームは要素が 1 つの配列を生成し、空の列は空文字列で表されます。文字列はプレーンテキストのみを含み、部分レベルの書式設定は保持されません。

これは次のような場合に便利です：

列ベースの読み順を保持したままテキストを抽出する。
複数列スライドの内容をインデックス化または比較する。
各列を別々のファイル、データベースフィールド、または他の宛先にエクスポートする。
ITextFrameFormat.ColumnCount、ITextFrameFormat.ColumnSpacing、フォント、またはテキストフレームのサイズを変更した後、テキストがどのように再配分されるかを確認する。

このメソッドは現在のITextFrame 内に分布しているテキストを報告します。別々のシェイプやテキストボックス間で自動的にテキストを流すことはありません。列の分布は使用可能なフォントやその他のテキスト配置設定に依存するため、結果の一貫性が重要な場合は必要なフォントが利用可能であることを確認してください。

以下の例はプレゼンテーションを読み込み、テキストフレームを持つ最初の複数列オートシェイプを検索し、設定された列数を取得して、各列のテキストを別々のファイルに書き出します。テキストフレームを提供しないシェイプはスキップされます。

using System;
using System.IO;
using Aspose.Slides;

using var presentation = new Presentation("MultiColumnText.pptx");

IAutoShape? textBox = null;
foreach (var shape in presentation.Slides[0].Shapes)
{
    if (shape is IAutoShape autoShape && autoShape.TextFrame is not null)
    {
        var columnCount = autoShape.TextFrame.TextFrameFormat.ColumnCount;
        if (columnCount > 1)
        {
            textBox = autoShape;
            break;
        }
    }
}

if (textBox is null)
{
    Console.WriteLine("No multi-column text frame was found.");
}
else
{
    var textFrame = textBox.TextFrame;
    var configuredColumnCount = textFrame.TextFrameFormat.ColumnCount;
    var columnTexts = textFrame.SplitTextByColumns();

    Console.WriteLine($"Configured columns: {configuredColumnCount}");

    for (var columnIndex = 0; columnIndex < columnTexts.Length; columnIndex++)
    {
        var columnNumber = columnIndex + 1;
        var columnText = columnTexts[columnIndex];
        Console.WriteLine($"Column {columnNumber}: {columnText}");
        File.WriteAllText($"Column-{columnNumber}.txt", columnText);
    }
}

テキストを更新

プレゼンテーション全体のテキストを更新するには、スライドとシェイプを反復処理し、オートシェイプを選択してからテキストの部分を編集します。部分レベルで作業することで、テキストと文字書式の両方を変更できます。

以下の例はオートシェイプのテキスト内のすべての years を months に置換し、影響を受けた各部分を太字にします：

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

using var presentation = new Presentation("Text.pptx");

foreach (var slide in presentation.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is not IAutoShape autoShape)
        {
            continue;
        }

        foreach (var paragraph in autoShape.TextFrame.Paragraphs)
        {
            foreach (var portion in paragraph.Portions)
            {
                portion.Text = portion.Text.Replace("years", "months");
                portion.PortionFormat.FontBold = NullableBool.True;
            }
        }
    }
}

presentation.Save("TextChanged.pptx", SaveFormat.Pptx);

この走査はオートシェイプのテキストのみを更新します。テーブル、チャート、SmartArt、またはグループ化されたシェイプに格納されたテキストは、それらオブジェクトのコレクションを走査する必要があります。

ハイパーリンク付きテキストボックスを追加

ハイパーリンクは特定のテキスト部分に割り当てることができ、そのテキストだけがクリック可能なリンクとして機能します。IHyperlinkManager.SetExternalHyperlinkClick を使用して、部分を外部 URL に関連付けます。

以下の例はリンク付きテキストを作成し、プレゼンテーションに保存します：

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

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 200, 50);
textBox.AddTextFrame("Aspose.Slides");

var textPortion = textBox.TextFrame.Paragraphs[0].Portions[0];
textPortion.PortionFormat.HyperlinkManager.SetExternalHyperlinkClick("https://www.aspose.com/");

presentation.Save("Hyperlink.pptx", SaveFormat.Pptx);

FAQ

マスタースライドまたはレイアウトスライド上のテキストボックスとテキストプレースホルダーの違いは何ですか？

placeholder は master slide または layout slide から位置と書式を継承できます。通常のテキストボックスは作成されたスライド上の独立したシェイプであり、レイアウトが変更されてもプレースホルダーの動作は取得しません。

チャート、テーブル、SmartArt のテキストを変更せずにテキストを置換するにはどうすればよいですか？

Update Text の例に示すように、IAutoShape を実装しているシェイプのみに走査を限定してください。チャート、テーブル、SmartArt はそれぞれのオブジェクトモデルにテキストを保持しているため、そのループでは変更されません。

.NET でプレゼンテーションのプレースホルダーを管理する .NET の AutoFit でプレゼンテーションを強化

.NET でのプレゼンテーションのテキスト ボックスの管理

このページの概要

はじめに

Note

スライド上にテキスト ボックスを作成

テキスト ボックス シェイプかどうかを確認

テキスト フレームを所有するシェイプを見つける

テキスト ボックスに列を追加