Управляйте маркированными и нумерованными списками в презентациях с помощью PHP

В Microsoft PowerPoint вы можете создавать маркированные и нумерованные списки так же, как делаете это в Word и других текстовых редакторах. Aspose.Slides for PHP via Java также позволяет использовать маркеры и номера на слайдах ваших презентаций.

Зачем использовать маркированные списки?

Маркированные списки помогают быстро и эффективно организовывать и представлять информацию.

Пример маркированного списка

В большинстве случаев маркированный список выполняет три основные функции:

привлекает внимание ваших читателей или зрителей к важной информации
позволяет вашим читателям или зрителям легко просматривать ключевые моменты
сообщает и передаёт важные детали эффективно.

Зачем использовать нумерованные списки?

Нумерованные списки также помогают в организации и представлении информации. Желательно использовать цифры (вместо маркеров), когда порядок пунктов (например, шаг 1, шаг 2 и т.д.) имеет значение или когда необходимо сослаться на пункт (например, см. шаг 3).

Пример нумерованного списка

Это сводка шагов (шаг 1 до шага 15) в процедуре Создание маркеров ниже:

Создайте экземпляр класса презентации.
Выполните несколько задач (шаги 3‑14).
Сохраните презентацию.

Создание маркеров

Эта тема также является частью серии тем по управлению текстовыми абзацами. На этой странице будет показано, как управлять маркерами абзацев. Маркеры более полезны, когда что‑то описывается шаг за шагом. Кроме того, текст выглядит более организованным при использовании маркеров. Маркированные абзацы всегда легче читать и понимать. Мы увидим, как разработчики могут использовать эту небольшую, но мощную функцию Aspose.Slides for PHP via Java. Пожалуйста, выполните следующие шаги, чтобы управлять маркерами абзацев с помощью Aspose.Slides for PHP via Java:

Создайте экземпляр класса Presentation.
Получите доступ к нужному слайду в коллекции слайдов, используя объект ISlide.
Добавьте AutoShape на выбранный слайд.
Получите доступ к TextFrame добавленной формы.
Удалите абзац по умолчанию в TextFrame.
Создайте первый экземпляр абзаца с помощью класса Paragraph.
Установите тип маркера для абзаца.
Установите тип маркера в Symbol и задайте символ маркера.
Установите текст абзаца.
Установите отступ абзаца для задания маркера.
Установите цвет маркера.
Установите высоту маркеров.
Добавьте созданный абзац в коллекцию абзацев TextFrame.
Добавьте второй абзац и повторите процесс, указанный в шагах 7‑13.
Сохраните презентацию.

Этот пример кода — реализация вышеуказанных шагов — показывает, как создать маркированный список на слайде:

  # Создать экземпляр класса Presentation, представляющего файл PPTX
  $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].
Добавьте второй абзац и повторите процесс, указанный в предыдущих шагах.
Сохраните презентацию.

Этот 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.
Создайте первый экземпляр абзаца с помощью класса Paragraph и задайте глубину 0.
Создайте второй экземпляр абзаца с помощью класса Paragraph и задайте глубину 1.
Создайте третий экземпляр абзаца с помощью класса Paragraph и задайте глубину 2.
Создайте четвертый экземпляр абзаца с помощью класса Paragraph и задайте глубину 3.
Добавьте созданные абзацы в коллекцию абзацев [TextFrame].
Сохраните презентацию.

Этот код, являющийся реализацией вышеуказанных шагов, показывает, как создать многоуровневый маркированный список :

  # Создать экземпляр класса Presentation, представляющего файл PPTX
  $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);
    # Создание второго абзаца
    $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);
    # Создание третьего абзаца
    $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);
    # Создание четвертого абзаца
    $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 и установите NumberedBulletStartWith в 3.
Создайте третий экземпляр абзаца с помощью класса Paragraph и установите NumberedBulletStartWith в 7.
Добавьте созданные абзацы в коллекцию абзацев [TextFrame].
Сохраните презентацию.

Этот PHP‑код показывает, как создать нумерованный список на слайде:

  # Создать экземпляр класса Presentation, представляющего файл PPTX
  $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);
    # Второй список
    $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 полностью поддерживает многоязычные презентации, позволяя создавать маркированные и нумерованные списки на любом языке, включая использование специальных или нелатинских символов.

Форматировать текст PowerPoint в PHP Управление надстрочным и подстрочным текстом в презентациях с помощью PHP