.NET で PowerPoint のテキスト段落を管理

Aspose.Slides は、C# で PowerPoint のテキスト、段落、そしてポーションを操作するために必要なすべてのインターフェイスとクラスを提供します。

• Aspose.Slides は、段落を表すオブジェクトを追加できるようにするための ITextFrame インターフェイスを提供します。ITextFame オブジェクトは、1 つまたは複数の段落を持つことができます（各段落は改行で作成されます）。
• Aspose.Slides は、ポーションを表すオブジェクトを追加できるようにする IParagraph インターフェイスを提供します。IParagraph オブジェクトは、1 つまたは複数のポーション（iPortions オブジェクトのコレクション）を持つことができます。
• Aspose.Slides は、テキストとその書式設定プロパティを表すオブジェクトを追加できるようにする IPortion インターフェイスを提供します。

IParagraph オブジェクトは、基礎となる IPortion オブジェクトを通じて、異なる書式設定プロパティを持つテキストを処理できます。

複数のポーションを含む複数の段落を追加

以下の手順では、3 つの段落を含むテキストフレームを追加し、各段落が 3 つのポーションを含むようにする方法を示します。

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. スライドに長方形の IAutoShape を追加します。
4. IAutoShape に関連付けられた ITextFrame を取得します。
5. 2 つの IParagraph オブジェクトを作成し、それらを ITextFrame の IParagraphs コレクションに追加します。
6. 各新しい IParagraph に対して 3 つの IPortion オブジェクトを作成し（デフォルトの段落には 2 つの Portion オブジェクト）、各 IPortion オブジェクトを各 IParagraph の IPortion コレクションに追加します。
7. 各ポーションにテキストを設定します。
8. IPortion オブジェクトが提供する書式設定プロパティを使用して、各ポーションに希望の書式設定を適用します。
9. 修正したプレゼンテーションを保存します。

// PPTX ファイルを表す Presentation クラスのインスタンス化
using (Presentation pres = new Presentation())
{
    // 最初のスライドにアクセス
    ISlide slide = pres.Slides[0];

    // 四角形の IAutoShape を追加
    IAutoShape ashp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // AutoShape の TextFrame にアクセス
    ITextFrame tf = ashp.TextFrame;

    // 異なるテキスト形式で Paragraph と Portion を作成
    IParagraph para0 = tf.Paragraphs[0];
    IPortion port01 = new Portion();
    IPortion port02 = new Portion();
    para0.Portions.Add(port01);
    para0.Portions.Add(port02);

    IParagraph para1 = new Paragraph();
    tf.Paragraphs.Add(para1);
    IPortion port10 = new Portion();
    IPortion port11 = new Portion();
    IPortion port12 = new Portion();
    para1.Portions.Add(port10);
    para1.Portions.Add(port11);
    para1.Portions.Add(port12);

    IParagraph para2 = new Paragraph();
    tf.Paragraphs.Add(para2);
    IPortion port20 = new Portion();
    IPortion port21 = new Portion();
    IPortion port22 = new Portion();
    para2.Portions.Add(port20);
    para2.Portions.Add(port21);
    para2.Portions.Add(port22);

    for (int i = 0; i < 3; i++)
        for (int j = 0; j < 3; j++)
        {
            tf.Paragraphs[i].Portions[j].Text = "Portion0" + j.ToString();
            if (j == 0)
            {
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.FillType = FillType.Solid;
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.SolidFillColor.Color = Color.Red;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontBold = NullableBool.True;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontHeight = 15;
            }
            else if (j == 1)
            {
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.FillType = FillType.Solid;
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.SolidFillColor.Color = Color.Blue;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontItalic = NullableBool.True;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontHeight = 18;
            }
        }
    // 変更されたプレゼンテーションを保存
    pres.Save("multiParaPort_out.pptx", SaveFormat.Pptx);
}

段落の箇条書きの管理

Bullet lists help you to organize and present information quickly and efficiently. Bulleted paragraphs are always easier to read and understand.

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. 選択したスライドに autoshape を追加します。
4. autoshape の TextFrame にアクセスします。
5. TextFrame のデフォルト段落を削除します。
6. Paragraph クラスを使用して最初の段落インスタンスを作成します。
7. 段落の箇条書き Type を Symbol に設定し、箇条書き文字を設定します。
8. 段落の Text を設定します。
9. 箇条書きのインデントとして段落の Indent を設定します。
10. 箇条書きの色を設定します。
11. 箇条書きの高さを設定します。
12. 新しい段落を TextFrame の段落コレクションに追加します。
13. 2 番目の段落を追加し、手順 7 から 13 のプロセスを繰り返します。
14. プレゼンテーションを保存します。

// PPTX ファイルを表す Presentation クラスのインスタンス化
using (Presentation pres = new Presentation())
{

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


    // AutoShape を追加してアクセス
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // AutoShape のテキストフレームにアクセス
    ITextFrame txtFrm = aShp.TextFrame;

    // デフォルトの段落を削除
    txtFrm.Paragraphs.RemoveAt(0);

    // 段落を作成
    Paragraph para = new Paragraph();

    // 段落の箇条書きスタイルと記号を設定
    para.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);

    // 段落テキストを設定
    para.Text = "Welcome to Aspose.Slides";

    // 箇条書きインデントを設定
    para.ParagraphFormat.Indent = 25;

    // 箇条書きの色を設定
    para.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // IsBulletHardColor を true に設定して独自の箇条書き色を使用

    // 箇条書きの高さを設定
    para.ParagraphFormat.Bullet.Height = 100;

    // 段落をテキストフレームに追加
    txtFrm.Paragraphs.Add(para);

    // 2 番目の段落を作成
    Paragraph para2 = new Paragraph();

    // 段落の箇条書きタイプとスタイルを設定
    para2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    para2.ParagraphFormat.Bullet.NumberedBulletStyle = NumberedBulletStyle.BulletCircleNumWDBlackPlain;

    // 段落テキストを追加
    para2.Text = "This is numbered bullet";

    // 箇条書きインデントを設定
    para2.ParagraphFormat.Indent = 25;

    para2.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para2.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para2.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // IsBulletHardColor を true に設定して独自の箇条書き色を使用

    // 箇条書きの高さを設定
    para2.ParagraphFormat.Bullet.Height = 100;

    // 段落をテキストフレームに追加
    txtFrm.Paragraphs.Add(para2);


    // 変更されたプレゼンテーションを保存
    pres.Save("Bullet_out.pptx", SaveFormat.Pptx);

}

画像箇条書きの管理

Bullet lists help you to organize and present information quickly and efficiently. Picture paragraphs are easy to read and understand.

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. スライドに autoshape を追加します。
4. autoshape の TextFrame にアクセスします。
5. TextFrame のデフォルト段落を削除します。
6. Paragraph クラスを使用して最初の段落インスタンスを作成します。
7. IPPImage で画像をロードします。
8. 箇条書きのタイプを Picture に設定し、画像を指定します。
9. 段落の Text を設定します。
10. 箇条書きのインデントとして段落の Indent を設定します。
11. 箇条書きの色を設定します。
12. 箇条書きの高さを設定します。
13. 新しい段落を TextFrame の段落コレクションに追加します。
14. 2 番目の段落を追加し、前述の手順を繰り返します。
15. 修正したプレゼンテーションを保存します。

// PPTX ファイルを表す Presentation クラスのインスタンス化
Presentation presentation = new Presentation();

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

// 箇条書き用画像をインスタンス化
IImage image = Images.FromFile("bullets.png");
IPPImage ippxImage = presentation.Images.AddImage(image);
image.Dispose();

// AutoShape を追加してアクセス
IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

// AutoShape のテキストフレームにアクセス
ITextFrame textFrame = autoShape.TextFrame;

// デフォルトの段落を削除
textFrame.Paragraphs.RemoveAt(0);

// 新しい段落を作成
Paragraph paragraph = new Paragraph();
paragraph.Text = "Welcome to Aspose.Slides";

// 段落の箇条書きスタイルと画像を設定
paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
paragraph.ParagraphFormat.Bullet.Picture.Image = ippxImage;

// 箇条書きの高さを設定
paragraph.ParagraphFormat.Bullet.Height = 100;

// 段落をテキストフレームに追加
textFrame.Paragraphs.Add(paragraph);

// プレゼンテーションを PPTX ファイルとして保存
presentation.Save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

// プレゼンテーションを PPT ファイルとして保存
presentation.Save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);

多階層箇条書きの管理

Bullet lists help you to organize and present information quickly and efficiently. Multilevel bullets are easy to read and understand.

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. 新しいスライドに autoshape を追加します。
4. autoshape の TextFrame にアクセスします。
5. TextFrame のデフォルト段落を削除します。
6. Paragraph クラスを使用して最初の段落インスタンスを作成し、深さを 0 に設定します。
7. Paragraph クラスを使用して2番目の段落インスタンスを作成し、深さを 1 に設定します。
8. Paragraph クラスを使用して3番目の段落インスタンスを作成し、深さを 2 に設定します。
9. Paragraph クラスを使用して4番目の段落インスタンスを作成し、深さを 3 に設定します。
10. 新しい段落を TextFrame の段落コレクションに追加します。
11. 修正したプレゼンテーションを保存します。

// PPTX ファイルを表す Presentation クラスのインスタンス化
using (Presentation pres = new Presentation())
{

    // 最初のスライドにアクセス
    ISlide slide = pres.Slides[0];
    
    // AutoShape を追加してアクセス
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 作成した AutoShape のテキストフレームにアクセス
    ITextFrame text = aShp.AddTextFrame("");
    
    // デフォルトの段落をクリア
    text.Paragraphs.Clear();

    // 最初の段落を追加
    IParagraph para1 = new Paragraph();
    para1.Text = "Content";
    para1.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para1.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
    para1.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para1.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // 箇条書きレベルを設定
    para1.ParagraphFormat.Depth = 0;

    // 2 番目の段落を追加
    IParagraph para2 = new Paragraph();
    para2.Text = "Second Level";
    para2.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para2.ParagraphFormat.Bullet.Char = '-';
    para2.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para2.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // 箇条書きレベルを設定
    para2.ParagraphFormat.Depth = 1;

    // 3 番目の段落を追加
    IParagraph para3 = new Paragraph();
    para3.Text = "Third Level";
    para3.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para3.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
    para3.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para3.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // 箇条書きレベルを設定
    para3.ParagraphFormat.Depth = 2;

    // 4 番目の段落を追加
    IParagraph para4 = new Paragraph();
    para4.Text = "Fourth Level";
    para4.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para4.ParagraphFormat.Bullet.Char = '-';
    para4.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para4.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // 箇条書きレベルを設定
    para4.ParagraphFormat.Depth = 3;

    // 段落をコレクションに追加
    text.Paragraphs.Add(para1);
    text.Paragraphs.Add(para2);
    text.Paragraphs.Add(para3);
    text.Paragraphs.Add(para4);

    // プレゼンテーションを PPTX ファイルとして保存
    pres.Save("MultilevelBullet.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

カスタム番号付きリストを持つ段落の管理

The IBulletFormat interface provides the NumberedBulletStartWith property and others that allow you to manage paragraphs with custom numbering or formatting.

1. Presentation クラスのインスタンスを作成します。
2. 段落を含むスライドにアクセスします。
3. スライドに autoshape を追加します。
4. autoshape の TextFrame にアクセスします。
5. TextFrame のデフォルト段落を削除します。
6. Paragraph クラスを使用して最初の段落インスタンスを作成し、NumberedBulletStartWith を 2 に設定します。
7. Paragraph クラスを使用して2番目の段落インスタンスを作成し、NumberedBulletStartWith を 3 に設定します。
8. Paragraph クラスを使用して3番目の段落インスタンスを作成し、NumberedBulletStartWith を 7 に設定します。
9. 新しい段落を TextFrame の段落コレクションに追加します。
10. 修正したプレゼンテーションを保存します。

using (var presentation = new Presentation())
{
	var shape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

	// 作成した AutoShape のテキストフレームにアクセス
	ITextFrame textFrame = shape.TextFrame;

	// 既存のデフォルト段落を削除
	textFrame.Paragraphs.RemoveAt(0);

	// 最初のリスト
	var paragraph1 = new Paragraph { Text = "bullet 2" };
	paragraph1.ParagraphFormat.Depth = 4; 
	paragraph1.ParagraphFormat.Bullet.NumberedBulletStartWith = 2;
	paragraph1.ParagraphFormat.Bullet.Type = BulletType.Numbered;
	textFrame.Paragraphs.Add(paragraph1);

	var paragraph2 = new Paragraph { Text = "bullet 3" };
	paragraph2.ParagraphFormat.Depth = 4;
	paragraph2.ParagraphFormat.Bullet.NumberedBulletStartWith = 3; 
	paragraph2.ParagraphFormat.Bullet.Type = BulletType.Numbered;  
	textFrame.Paragraphs.Add(paragraph2);

	
	var paragraph5 = new Paragraph { Text = "bullet 7" };
	paragraph5.ParagraphFormat.Depth = 4;
	paragraph5.ParagraphFormat.Bullet.NumberedBulletStartWith = 7;
	paragraph5.ParagraphFormat.Bullet.Type = BulletType.Numbered;
	textFrame.Paragraphs.Add(paragraph5);

	presentation.Save("SetCustomBulletsNumber-slides.pptx", SaveFormat.Pptx);
}

段落インデントの設定

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. スライドに長方形の autoshape を追加します。
4. 長方形の autoshape に 3 つの段落を持つ TextFrame を追加します。
5. 長方形の枠線を非表示にします。
6. 各 Paragraph の BulletOffset プロパティを使用してインデントを設定します。
7. 修正したプレゼンテーションを PPT ファイルとして書き出します。

// Presentation クラスをインスタンス化
Presentation pres = new Presentation();

// 最初のスライドを取得
ISlide sld = pres.Slides[0];

// 長方形シェイプを追加
IAutoShape rect = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 500, 150);

// 長方形に TextFrame を追加
ITextFrame tf = rect.AddTextFrame("This is first line \rThis is second line \rThis is third line");

// テキストをシェイプに合わせて設定
tf.TextFrameFormat.AutofitType = TextAutofitType.Shape;

// 長方形の線を非表示にする
rect.LineFormat.FillFormat.FillType = FillType.Solid;

// TextFrame の最初の段落を取得しインデントを設定
IParagraph para1 = tf.Paragraphs[0];

// 段落の箇条書きスタイルと記号を設定
para1.ParagraphFormat.Bullet.Type = BulletType.Symbol;
para1.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
para1.ParagraphFormat.Alignment = TextAlignment.Left;

para1.ParagraphFormat.Depth = 2;
para1.ParagraphFormat.Indent = 30;

// TextFrame の 2 番目の段落を取得しインデントを設定
IParagraph para2 = tf.Paragraphs[1];
para2.ParagraphFormat.Bullet.Type = BulletType.Symbol;
para2.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
para2.ParagraphFormat.Alignment = TextAlignment.Left;
para2.ParagraphFormat.Depth = 2;
para2.ParagraphFormat.Indent = 40;

// TextFrame の 3 番目の段落を取得しインデントを設定
IParagraph para3 = tf.Paragraphs[2];
para3.ParagraphFormat.Bullet.Type = BulletType.Symbol;
para3.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
para3.ParagraphFormat.Alignment = TextAlignment.Left;
para3.ParagraphFormat.Depth = 2;
para3.ParagraphFormat.Indent = 50;

// プレゼンテーションをディスクに保存
pres.Save("InOutDent_out.pptx", SaveFormat.Pptx);

段落のハンギングインデントの設定

この C# コードは、段落のハンギングインデントを設定する方法を示しています:

using (Presentation pres = new Presentation())
{
    var autoShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 50, 250, 550, 150);

    Paragraph para1 = new Paragraph
    {
        Text = "Example"
    };
    Paragraph para2 = new Paragraph
    {
        Text = "Set Hanging Indent for Paragraph"
    };
    Paragraph para3 = new Paragraph
    {
        Text = "This C# code shows you how to set the hanging indent for a paragraph: "
    };

    para2.ParagraphFormat.MarginLeft = 10f;
    para3.ParagraphFormat.MarginLeft = 20f;
    
    autoShape.TextFrame.Paragraphs.Add(para1);
    autoShape.TextFrame.Paragraphs.Add(para2);
    autoShape.TextFrame.Paragraphs.Add(para3);
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

段落末端の実行プロパティの管理

1. Presentation クラスのインスタンスを作成します。
2. 位置を使用して段落を含むスライドへの参照を取得します。
3. スライドに長方形の autoshape を追加します。
4. 長方形に 2 つの段落を持つ TextFrame を追加します。
5. 段落の FontHeight とフォント種別を設定します。
6. 段落の End プロパティを設定します。
7. 修正したプレゼンテーションを PPTX ファイルとして書き出します。

using (Presentation pres = new Presentation("Test.pptx"))
{
	IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);

	Paragraph para1 = new Paragraph();
	para1.Portions.Add(new Portion("Sample text"));

	Paragraph para2 = new Paragraph();
	para2.Portions.Add(new Portion("Sample text 2"));
	PortionFormat endParagraphPortionFormat = new PortionFormat();
	endParagraphPortionFormat.FontHeight = 48;
	endParagraphPortionFormat.LatinFont = new FontData("Times New Roman");
	para2.EndParagraphPortionFormat = endParagraphPortionFormat;

	shape.TextFrame.Paragraphs.Add(para1);
	shape.TextFrame.Paragraphs.Add(para2);

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

HTML テキストを段落にインポート

Aspose.Slides は、HTML テキストを段落にインポートするための強化されたサポートを提供します。

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用して対象スライドへの参照にアクセスします。
3. スライドに autoshape を追加します。
4. autoshape の ITextFrame を追加してアクセスします。
5. ITextFrame のデフォルト段落を削除します。
6. TextReader でソース HTML ファイルを読み取ります。
7. Paragraph クラスを使用して最初の段落インスタンスを作成します。
8. 読み取った TextReader の HTML ファイル内容を TextFrame の ParagraphCollection に追加します。
9. 修正したプレゼンテーションを保存します。

// 空のプレゼンテーション インスタンスを作成
using (Presentation pres = new Presentation())
{
    // プレゼンテーションのデフォルトの最初のスライドにアクセス
    ISlide slide = pres.Slides[0];

    // HTML コンテンツを格納する AutoShape を追加
    IAutoShape ashape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, pres.SlideSize.Size.Width - 20, pres.SlideSize.Size.Height - 10);

    ashape.FillFormat.FillType = FillType.NoFill;

    // シェイプにテキストフレームを追加
    ashape.AddTextFrame("");

    // 追加したテキストフレームのすべての段落をクリア
    ashape.TextFrame.Paragraphs.Clear();

    // ストリームリーダーで HTML ファイルをロード
    TextReader tr = new StreamReader("file.html");

    // HTML ストリームリーダーからテキストをテキストフレームに追加
    ashape.TextFrame.Paragraphs.AddFromHtml(tr.ReadToEnd());

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

段落テキストを HTML にエクスポート

Aspose.Slides は、段落に含まれるテキストを HTML にエクスポートするための強化されたサポートを提供します。

1. Presentation クラスのインスタンスを作成し、目的のプレゼンテーションを読み込む。
2. インデックスを使用して対象スライドへの参照にアクセスする。
3. HTML にエクスポートするテキストを含むシェイプにアクセスする。
4. シェイプの TextFrame にアクセスする。
5. StreamWriter のインスタンスを作成し、新しい HTML ファイルを追加する。
6. StreamWriter に開始インデックスを指定し、希望する段落をエクスポートする。

// プレゼンテーション ファイルをロード
using (Presentation pres = new Presentation("ExportingHTMLText.pptx"))
{

    // プレゼンテーションのデフォルトの最初のスライドにアクセス
    ISlide slide = pres.Slides[0];

    // 必要なインデックスにアクセス
    int index = 0;

    // 追加されたシェイプにアクセス
    IAutoShape ashape = (IAutoShape)slide.Shapes[index];

    StreamWriter sw = new StreamWriter("output_out.html", false, Encoding.UTF8);

    // 段落の開始インデックスとコピーする段落数を指定して、段落データを HTML に書き込む
    sw.Write(ashape.TextFrame.Paragraphs.ExportToHtml(0, ashape.TextFrame.Paragraphs.Count, null));

    sw.Close();
}

段落を画像として保存

In this section, we will explore two examples that demonstrate how to save a text paragraph, represented by the IParagraph interface, as an image. Both examples include obtaining the image of a shape containing the paragraph using the GetImage methods from the IShape interface, calculating the bounds of the paragraph within the shape, and exporting it as a bitmap image. These approaches allow you to extract specific parts of the text from PowerPoint presentations and save them as separate images, which can be useful for further use in various scenarios.

Let’s assume we have a presentation file called sample.pptx with one slide, where the first shape is a text box containing three paragraphs.

Example 1

In this example, we obtain the second paragraph as an image. To do this, we extract the image of the shape from the first slide of the presentation and then calculate the bounds of the second paragraph in the shape’s text frame. The paragraph is then redrawn onto a new bitmap image, which is saved in PNG format. This method is especially useful when you need to save a specific paragraph as a separate image while preserving the exact dimensions and formatting of the text.

using var presentation = new Presentation("sample.pptx");
var firstShape = presentation.Slides[0].Shapes[0] as IAutoShape;

// Save the shape in memory as a bitmap.
using var shapeImage = firstShape.GetImage();
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Create a shape bitmap from memory.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Calculate the boundaries of the second paragraph.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();

// Calculate the size for the output image (minimum size - 1x1 pixel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Prepare a bitmap for the paragraph.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
using var imageGraphics = Graphics.FromImage(paragraphBitmap);
var drawingRectangle = new RectangleF(0, 0, paragraphRectangle.Width, paragraphRectangle.Height);
imageGraphics.DrawImage(shapeBitmap, drawingRectangle, paragraphRectangle, GraphicsUnit.Pixel);

paragraphBitmap.Save("paragraph.png", System.Drawing.Imaging.ImageFormat.Png);

The result:

Example 2

In this example, we extend the previous approach by adding scaling factors to the paragraph image. The shape is extracted from the presentation and saved as an image with a scaling factor of 2. This allows for a higher resolution output when exporting the paragraph. The paragraph bounds are then calculated considering the scale. Scaling can be particularly useful when a more detailed image is needed, for example, for use in high-quality printed materials.

var imageScaleX = 2f;
var imageScaleY = imageScaleX;

using var presentation = new Presentation("sample.pptx");
var firstShape = presentation.Slides[0].Shapes[0] as IAutoShape;

// Save the shape in memory as a bitmap with scaling.
using var shapeImage = firstShape.GetImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Create a shape bitmap from memory.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Calculate the boundaries of the second paragraph.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();
paragraphRectangle.X *= imageScaleX;
paragraphRectangle.Y *= imageScaleY;
paragraphRectangle.Width *= imageScaleX;
paragraphRectangle.Height *= imageScaleY;

// Calculate the size for the output image (minimum size - 1x1 pixel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Prepare a bitmap for the paragraph.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
using var imageGraphics = Graphics.FromImage(paragraphBitmap);
var drawingRectangle = new RectangleF(0, 0, paragraphRectangle.Width, paragraphRectangle.Height);
imageGraphics.DrawImage(shapeBitmap, drawingRectangle, paragraphRectangle, GraphicsUnit.Pixel);

paragraphBitmap.Save("paragraph.png", System.Drawing.Imaging.ImageFormat.Png);

FAQ

テキストフレーム内で改行を完全に無効にできますか？

はい。テキストフレームの折り返し設定（WrapText）をオフにすると、行はフレームの端で改行されません。

特定の段落のスライド上での正確な境界を取得するにはどうすればよいですか？

段落（または単一のポーション）のバウンディング矩形を取得すれば、スライド上での正確な位置とサイズが分かります。

段落の配置（左寄せ/右寄せ/中央揃え/均等割り付け）はどこで制御されますか？

Alignment は ParagraphFormat の段落レベル設定で、個々のポーションの書式設定に関係なく段落全体に適用されます。

段落の一部（例：単語）のみスペルチェック言語を設定できますか？

はい。言語はポーションレベル（PortionFormat.LanguageId）で設定されるため、段落内で複数の言語を共存させることが可能です。