箇条書きと番号付きリストの管理

Microsoft PowerPointでは、Wordや他のテキストエディタと同様に箇条書きや番号付きリストを作成できます。 Aspose.Slides for .NETでも、プレゼンテーションのスライドで箇条書きや番号を使用できます。

箇条書きを使用する理由

箇条書きは、情報を迅速かつ効率的に整理し、提示するのに役立ちます。

箇条書きの例

ほとんどの場合、箇条書きは次の3つの主要な機能を果たします：

読者や視聴者の注意を重要な情報に引き付ける
読者や視聴者が重要なポイントを簡単にスキャンできるようにする
重要な詳細を効率的に伝達する

番号付きリストを使用する理由

番号付きリストも情報を整理し提示するのに役立ちます。理想的には、項目の順序（例：ステップ1、ステップ2）が重要な場合や、項目に参照を付ける必要がある場合（例：ステップ3を参照）、番号（箇条書きの代わりに）を使用すべきです。

番号付きリストの例

以下は、箇条書き作成手順のステップ（ステップ1からステップ15）の概要です：

プレゼンテーションクラスのインスタンスを作成する。
いくつかのタスクを実行する（ステップ3からステップ14）。
プレゼンテーションを保存する。

箇条書きの作成

箇条書きを作成するには、次の手順に従います：

Presentationクラスのインスタンスを作成する。
スライドコレクション内の箇条書きリストを追加したいスライドにISlideオブジェクトを介してアクセスする。
選択したスライドにAutoShapeを追加する。
追加した形状のTextFrameにアクセスする。
TextFrame内のデフォルトの段落を削除する。
Paragraphクラスを使用して最初の段落インスタンスを作成する。
箇条書きの種類を記号に設定し、箇条書き文字を設定する。
段落のテキストを設定する。
箇条書きを設定するために段落のインデントを設定する。
箇条書きの色を設定する。
箇条書きの高さを設定する。
作成した段落をTextFrameの段落コレクションに追加する。
2番目の段落を追加し、手順7-12を繰り返す。
プレゼンテーションを保存する。

以下のC#のサンプルコードは、上記の手順を実装したもので、スライドに箇条書きを作成する方法を示します：

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    paragraph.ParagraphFormat.Bullet.Char = '*';
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True;
    paragraph.ParagraphFormat.Bullet.Color.Color = Color.Red;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = "My text";

    textFrame.Paragraphs.Add(paragraph);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

画像の箇条書きの作成

Aspose.Slides for .NETでは、箇条書きリストの箇条書きを変更できます。箇条書きをカスタム記号や画像に置き換えることができます。リストに視覚的な興味を追加したり、リスト内の項目にさらに注意を引いたりしたい場合は、自分の画像を箇条書きとして使用できます。

理想的には、通常の箇条書き記号を画像に置き換える意図がある場合は、透過的な背景を持つシンプルなグラフィック画像を選択した方が良いでしょう。このような画像はカスタム箇条書き記号として最適です。

いずれにせよ、選択した画像は非常に小さなサイズに縮小されるため、箇条書き記号の代わりとしてリストで見栄えの良い画像を選択することを強くお勧めします。

画像の箇条書きを作成するには、次の手順に従います：

Presentationクラスのインスタンスを作成する。
スライドコレクション内の任意のスライドにISlideオブジェクトを使用してアクセスする。
選択したスライドにAutoShapeを追加する。
追加した形状のTextFrameにアクセスする。
TextFrame内のデフォルトの段落を削除する。
Paragraphクラスを使用して最初の段落インスタンスを作成する。
ディスクから画像を読み込み、Presentation.Imagesに追加し、AddImageメソッドから返されたIPPImageインスタンスを使用する。
箇条書きの種類を画像に設定し、画像を設定する。
段落のテキストを設定する。
箇条書きを設定するために段落のインデントを設定する。
箇条書きの色を設定する。
箇条書きの高さを設定する。
作成した段落をTextFrameの段落コレクションに追加する。
2番目の段落を追加し、手順7-13を繰り返す。
プレゼンテーションを保存する。

このC#コードは、スライドに画像の箇条書きを作成する方法を示しています：

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
    IPPImage image = pres.Images.AddImage(File.ReadAllBytes("image.png"));
    paragraph.ParagraphFormat.Bullet.Picture.Image = image;
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = "My text";

    textFrame.Paragraphs.Add(paragraph);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

階層付き箇条書きの作成

異なるレベルの項目を含む箇条書きリスト—メインの箇条書きリストの下にある追加リスト—を作成するには、次の手順に従います：

Presentationクラスのインスタンスを作成する。
スライドコレクション内の任意のスライドにISlideオブジェクトを使用してアクセスする。
選択したスライドにAutoShapeを追加する。
追加した形状のTextFrameにアクセスする。
TextFrame内のデフォルトの段落を削除する。
Paragraphクラスを使用して深さを0に設定した最初の段落インスタンスを作成する。
[Paragraph]クラスを使用して深さを1に設定した2番目の段落インスタンスを作成する。
[Paragraph]クラスを使用して深さを2に設定した3番目の段落インスタンスを作成する。
[Paragraph]クラスを使用して深さを3に設定した4番目の段落インスタンスを作成する。
作成した段落をTextFrameの段落コレクションに追加する。
プレゼンテーションを保存する。

以下のコードは、上記の手順を実装したもので、C#で階層付き箇条書きリストを作成する方法を示しています：

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 300, 300);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Depth = 0;
    paragraph.Text = "My text Depth 0";
    textFrame.Paragraphs.Add(paragraph);
    
    Paragraph paragraph2 = new Paragraph();
    paragraph2.ParagraphFormat.Depth = 0;
    paragraph2.Text = "My text Depth 1";
    textFrame.Paragraphs.Add(paragraph2);
    
    Paragraph paragraph3 = new Paragraph();
    paragraph3.ParagraphFormat.Depth = 2;
    paragraph3.Text = "My text Depth 2";
    textFrame.Paragraphs.Add(paragraph3);
    
    Paragraph paragraph4 = new Paragraph();
    paragraph4.ParagraphFormat.Depth = 3;
    paragraph4.Text = "My text Depth 3";
    textFrame.Paragraphs.Add(paragraph4);
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

番号の作成

以下のC#コードは、スライドに番号付きリストを作成する方法を示しています：

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    paragraph.Text = "My text 1";
    textFrame.Paragraphs.Add(paragraph);
    
    Paragraph paragraph2 = new Paragraph();
    paragraph2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    paragraph2.Text = "My text 2";
    textFrame.Paragraphs.Add(paragraph2);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

アニメーションテキスト上付き文字と下付き文字