PHP を使用したプレゼンテーションにおける箇条書きと番号付きリストの管理

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

箇条書きリストを使用する理由

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

箇条書きリストの例

ほとんどの場合、箇条書きリストは以下の 3 つの主要な機能を果たします。

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

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

番号付きリストも情報の整理・提示に役立ちます。エントリの順序（例: step 1, step 2 など）が重要な場合や、エントリを参照する必要がある場合（例: see step 3）は、箇条書きの代わりに番号を使用すべきです。

番号付きリストの例

以下は Creating Bullets 手順のステップ（step 1 から step 15）をまとめたものです。

Presentation クラスのインスタンスを作成します。
複数のタスクを実行します（step 3 から step 14）。
プレゼンテーションを保存します。

箇条書きの作成

このトピックは、テキスト段落の管理に関するシリーズの一部です。このページでは、段落の箇条書きを管理する方法を示します。箇条書きは手順を説明する際に便利で、テキストが整理された外観になります。箇条書き段落は常に読みやすく理解しやすいです。以下の手順に従って、Aspose.Slides for PHP via Java を使用して段落の箇条書きを管理してください。

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

このサンプルコード（上記手順の実装）は、スライドで箇条書きリストを作成する方法を示しています：

  # PPTX ファイルを表す Presentation クラスをインスタンス化
  $pres = new Presentation();
  try {
    # 最初のスライドにアクセス
    $slide = $pres->getSlides()->get_Item(0);
    # Autoshape を追加し、アクセス
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # 作成された Autoshape のテキストフレームにアクセス
    $txtFrm = $aShp->getTextFrame();
    # デフォルトの既存段落を削除
    $txtFrm->getParagraphs()->removeAt(0);
    # 段落を作成
    $para = new Paragraph();
    # 段落の箇条書きスタイルとシンボルを設定
    $para->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para->getParagraphFormat()->getBullet()->setChar(8226);
    # 段落テキストを設定
    $para->setText("Welcome to Aspose.Slides");
    # 箇条書きインデントを設定
    $para->getParagraphFormat()->setIndent(25);
    # 箇条書きの色を設定
    $para->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    # IsBulletHardColor を true に設定して独自の箇条書き色を使用
    $para->getParagraphFormat()->getBullet()->isBulletHardColor();
    # 箇条書きの高さを設定
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # 段落をテキストフレームに追加
    $txtFrm->getParagraphs()->add($para);
    # プレゼンテーションを PPTX ファイルとして保存
    $pres->save("Bullet.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

画像箇条書きの作成

Aspose.Slides for PHP via Java は、箇条書きリストの箇条書きをカスタム記号や画像に置き換えることができます。リストに視覚的な興味を加えたり、エントリへの注意をさらに引き付けたい場合は、独自の画像を箇条書きとして使用できます。

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

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

画像箇条書きを作成する手順は以下の通りです。

Presentation クラスのインスタンスを作成します。
ISlide オブジェクトを使用してスライドコレクションから目的のスライドにアクセスします。
選択したスライドに autoshape を追加します。
追加したシェイプの TextFrame にアクセスします。
TextFrame 内のデフォルト段落を削除します。
Paragraph クラスを使用して最初の段落インスタンスを作成します。
IPPImage からディスク上の画像をロードします。
箇条書きタイプを Picture に設定し、画像を指定します。
段落テキストを設定します。
箇条書きを設定するために段落インデントを設定します。
箇条書きの色を設定します。
箇条書きの高さを設定します。
作成した段落を TextFrame の段落コレクションに追加します。
2 番目の段落を追加し、前の手順を繰り返します。
プレゼンテーションを保存します。

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

  $pres = new Presentation();
  try {
    # 最初のスライドにアクセス
    $slide = $pres->getSlides()->get_Item(0);
    # 箇条書き用画像をインスタンス化
    $picture;
    $image = Images->fromFile("asp1.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Autoshape を追加し、アクセス
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # 作成された Autoshape のテキストフレームにアクセス
    $txtFrm = $aShp->getTextFrame();
    # デフォルトの既存段落を削除
    $txtFrm->getParagraphs()->removeAt(0);
    # 新しい段落を作成
    $para = new Paragraph();
    $para->setText("Welcome to Aspose.Slides");
    # 段落の箇条書きスタイルと画像を設定
    $para->getParagraphFormat()->getBullet()->setType(BulletType::Picture);
    $para->getParagraphFormat()->getBullet()->getPicture()->setImage($picture);
    # 箇条書きの高さを設定
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # 段落をテキストフレームに追加
    $txtFrm->getParagraphs()->add($para);
    # プレゼンテーションを PPTX ファイルとして保存
    $pres->save("Bullet.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

階層型箇条書きの作成

メイン箇条書きリストの下に追加リストを持つ、異なるレベルの項目を含む箇条書きリストを作成する手順は以下の通りです。

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

このコード（上記手順の実装）は、階層型箇条書きリストを作成する方法を示しています：

  # PPTX ファイルを表す Presentation クラスをインスタンス化
  $pres = new Presentation();
  try {
    # 最初のスライドにアクセス
    $slide = $pres->getSlides()->get_Item(0);
    # Autoshape を追加し、アクセス
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # 作成された Autoshape のテキストフレームにアクセス
    $txtFrm = $aShp->addTextFrame("");
    # デフォルトの既存段落を削除
    $txtFrm->getParagraphs()->clear();
    # 最初の段落を作成
    $para1 = new Paragraph();
    # 段落の箇条書きスタイルとシンボルを設定
    $para1->setText("Content");
    $para1->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para1->getParagraphFormat()->getBullet()->setChar(8226);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # 箇条書きレベルを設定
    $para1->getParagraphFormat()->setDepth(0);
    # 2 番目の段落を作成
    $para2 = new Paragraph();
    # 段落の箇条書きスタイルとシンボルを設定
    $para2->setText("Second level");
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para2->getParagraphFormat()->getBullet()->setChar('-');
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # 箇条書きレベルを設定
    $para2->getParagraphFormat()->setDepth(1);
    # 3 番目の段落を作成
    $para3 = new Paragraph();
    # 段落の箇条書きスタイルとシンボルを設定
    $para3->setText("Third level");
    $para3->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para3->getParagraphFormat()->getBullet()->setChar(8226);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # 箇条書きレベルを設定
    $para3->getParagraphFormat()->setDepth(2);
    # 4 番目の段落を作成
    $para4 = new Paragraph();
    # 段落の箇条書きスタイルとシンボルを設定
    $para4->setText("Fourth Level");
    $para4->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para4->getParagraphFormat()->getBullet()->setChar('-');
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # 箇条書きレベルを設定
    $para4->getParagraphFormat()->setDepth(3);
    # テキストフレームに段落を追加
    $txtFrm->getParagraphs()->add($para1);
    $txtFrm->getParagraphs()->add($para2);
    $txtFrm->getParagraphs()->add($para3);
    $txtFrm->getParagraphs()->add($para4);
    # プレゼンテーションを PPTX ファイルとして保存
    $pres->save("MultilevelBullet.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

カスタム番号付きリストの作成

Aspose.Slides for PHP via Java は、カスタム番号書式設定で段落を管理するシンプルな API を提供します。段落にカスタム番号リストを追加するには、以下の手順に従ってください。

Presentation クラスのインスタンスを作成します。
ISlide オブジェクトを使用してスライドコレクションから目的のスライドにアクセスします。
選択したスライドに autoshape を追加します。
追加したシェイプの TextFrame にアクセスします。
TextFrame 内のデフォルト段落を削除します。
Paragraph クラスを使用して最初の段落インスタンスを作成し、NumberedBulletStartWith を 2 に設定します。
Paragraph クラスを使用して2番目の段落インスタンスを作成し、NumberedBulletStartWith を 3 に設定します。
Paragraph クラスを使用して3番目の段落インスタンスを作成し、NumberedBulletStartWith を 7 に設定します。
作成した段落を TextFrame の段落コレクションに追加します。
プレゼンテーションを保存します。

この PHP コードは、スライドで番号付きリストを作成する方法を示しています：

  # PPTX ファイルを表す Presentation クラスをインスタンス化
  $pres = new Presentation();
  try {
    # 最初のスライドにアクセス
    $slide = $pres->getSlides()->get_Item(0);
    # Autoshape を追加し、アクセス
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # 作成された Autoshape のテキストフレームにアクセス
    $txtFrm = $aShp->addTextFrame("");
    # デフォルトの既存段落を削除
    $txtFrm->getParagraphs()->clear();
    # 最初のリスト
    $paragraph1 = new Paragraph();
    $paragraph1->setText("bullet 2");
    $paragraph1->getParagraphFormat()->setDepth(4);
    $paragraph1->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(2);
    $paragraph1->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph1);
    $paragraph2 = new Paragraph();
    $paragraph2->setText("bullet 3");
    $paragraph2->getParagraphFormat()->setDepth(4);
    $paragraph2->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(3);
    $paragraph2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph2);
    # 2 番目のリスト
    $paragraph5 = new Paragraph();
    $paragraph5->setText("bullet 5");
    $paragraph5->getParagraphFormat()->setDepth(4);
    $paragraph5->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(5);
    $paragraph5->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph5);
    $pres->save($resourcesOutputPath . "SetCustomBulletsNumber-slides.pptx.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Aspose.Slides で作成した箇条書きおよび番号付きリストは、PDF や画像など他の形式にエクスポートできますか？

はい、Aspose.Slides は、プレゼンテーションを PDF、画像、その他の形式にエクスポートする際に、箇条書きと番号付きリストの書式と構造を完全に保持し、一貫した結果を提供します。

既存のプレゼンテーションから箇条書きや番号付きリストをインポートできますか？

はい、Aspose.Slides は、既存のプレゼンテーションから箇条書きや番号付きリストをインポートして編集でき、元の書式と外観を保持します。

Aspose.Slides は、多言語で作成されたプレゼンテーションの箇条書きおよび番号付きリストをサポートしていますか？

はい、Aspose.Slides は多言語プレゼンテーションを完全にサポートし、特殊文字や非ラテン文字を含む任意の言語で箇条書きおよび番号付きリストを作成できます。

PHPでPowerPointテキストの書式設定プレゼンテーションで PHP を使用した上付き文字と下付き文字の管理