# Управление маркированными и нумерованными списками в презентациях на Java > Узнайте, как создавать и форматировать маркированные, маркер‑изображения, многоуровневые и нумерованные списки в презентациях PowerPoint и OpenDocument с помощью Aspose.Slides for Java. Source: https://docs.aspose.com/slides/ru/java/manage-lists/ Updated: 2026-06-06 ## **Обзор** Aspose.Slides for Java позволяет создавать и форматировать маркированные и нумерованные списки в презентациях PowerPoint и OpenDocument. Элемент списка представляет собой абзац, настройки маркеров которого управляются через формат абзаца. Используйте метод [IParagraph.getParagraphFormat](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraph/#getParagraphFormat--) для доступа к настройкам списка уровня абзаца. Основной точкой входа является [IParagraphFormat.getBullet](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraphformat/#getBullet--), который возвращает объект [IBulletFormat](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/). С помощью этого объекта можно задать тип маркера, символ, изображение, цвет, размер, стиль нумерации и начальное число. This article shows how to: - создать маркированный список с пользовательским символом - создать маркер‑изображение - создать многоуровневый список, задав глубину абзаца - создать нумерованный список - просмотреть и изменить форматирование списка в существующей презентации ## **Создание маркированного списка** Чтобы создать маркированный список, добавьте объекты [IParagraph](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraph/) в [ITextFrame](https://reference.aspose.com/slides/ru/java/com.aspose.slides/itextframe/) и установите [IBulletFormat.setType](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setType-byte-) в значение [BulletType.Symbol](https://reference.aspose.com/slides/ru/java/com.aspose.slides/bullettype/#Symbol). Затем можно задать [IBulletFormat.setChar](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setChar-char-), [IBulletFormat.getColor](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#getColor--) и [IBulletFormat.setHeight](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setHeight-float-) для управления внешним видом маркера. Следующий код Java демонстрирует, как создать маркированный список на слайде: ```java Presentation presentation = new Presentation(); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 200, 50); ITextFrame textFrame = autoShape.getTextFrame(); textFrame.getParagraphs().clear(); Color bulletColor = new Color(205, 92, 92); Paragraph paragraph1 = new Paragraph(); paragraph1.getParagraphFormat().getBullet().setType(BulletType.Symbol); paragraph1.getParagraphFormat().getBullet().setChar('*'); paragraph1.getParagraphFormat().setIndent(15); paragraph1.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); paragraph1.getParagraphFormat().getBullet().getColor().setColor(bulletColor); paragraph1.getParagraphFormat().getBullet().setHeight(100); paragraph1.setText("The first paragraph"); textFrame.getParagraphs().add(paragraph1); Paragraph paragraph2 = new Paragraph(); paragraph2.getParagraphFormat().getBullet().setType(BulletType.Symbol); paragraph2.getParagraphFormat().getBullet().setChar('*'); paragraph2.getParagraphFormat().setIndent(15); paragraph2.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); paragraph2.getParagraphFormat().getBullet().getColor().setColor(bulletColor); paragraph2.getParagraphFormat().getBullet().setHeight(100); paragraph2.setText("The second paragraph"); textFrame.getParagraphs().add(paragraph2); presentation.save("symbol_bullets.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` Результат: ![Символьные маркеры](symbol_bullets.png) ## **Создание нумерованного списка** Используйте нумерованные списки, когда важен порядок элементов. Установите [IBulletFormat.setType](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setType-byte-) в значение [BulletType.Numbered](https://reference.aspose.com/slides/ru/java/com.aspose.slides/bullettype/#Numbered). Также можно выбрать формат нумерации с помощью [IBulletFormat.setNumberedBulletStyle](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setNumberedBulletStyle-byte-) или задать [IBulletFormat.setNumberedBulletStartWith](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setNumberedBulletStartWith-short-), если список должен начинаться с значения, отличного от 1. Следующий код Java показывает, как создать нумерованный список на слайде: ```java Presentation presentation = new Presentation(); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 90, 80); ITextFrame textFrame = autoShape.getTextFrame(); textFrame.getParagraphs().clear(); Paragraph paragraph1 = new Paragraph(); paragraph1.getParagraphFormat().getBullet().setType(BulletType.Numbered); paragraph1.setText("Apple"); textFrame.getParagraphs().add(paragraph1); Paragraph paragraph2 = new Paragraph(); paragraph2.getParagraphFormat().getBullet().setType(BulletType.Numbered); paragraph2.setText("Orange"); textFrame.getParagraphs().add(paragraph2); Paragraph paragraph3 = new Paragraph(); paragraph3.getParagraphFormat().getBullet().setType(BulletType.Numbered); paragraph3.setText("Banana"); textFrame.getParagraphs().add(paragraph3); presentation.save("numbered_bullets.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` Результат: ![Нумерованные маркеры](numbered_bullets.png) ## **Создание маркера‑изображения** Aspose.Slides позволяет заменить обычный символ маркера изображением. Маркеры‑изображения лучше всего работают с простыми картинками, которые остаются разборчивыми при небольшом размере, например иконками или небольшими прозрачными PNG‑файлами. {{% alert color="primary" %}} Идеально, если вы планируете заменить обычный символ маркера изображением, выбрать простую графику с прозрачным фоном. Такие изображения хорошо подходят в качестве пользовательских символов маркеров. Имейте в виду, что изображение будет масштабировано до очень небольшого размера. По этой причине мы настоятельно рекомендуем выбирать изображение, которое остаётся чётким и визуально эффективным, когда используется в качестве маркера в списке. {{% /alert %}} Для создания маркера‑изображения добавьте изображение в [Presentation.getImages](https://reference.aspose.com/slides/ru/java/com.aspose.slides/presentation/#getImages--) и присвойте полученный объект изображения [IBulletFormat.getPicture](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#getPicture--). Установите [IBulletFormat.setType](https://reference.aspose.com/slides/ru/java/com.aspose.slides/ibulletformat/#setType-byte-) в значение [BulletType.Picture](https://reference.aspose.com/slides/ru/java/com.aspose.slides/bullettype/#Picture) перед присвоением изображения. Допустим, у нас есть файл "image.png": ![Изображение для маркеров](picture_for_bullets.png) Следующий код Java показывает, как создать маркеры‑изображения на слайде: ```java Presentation presentation = new Presentation(); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 200, 50); ITextFrame textFrame = autoShape.getTextFrame(); textFrame.getParagraphs().clear(); IPPImage bulletImage = presentation.getImages().addImage(Images.fromFile("image.png")); Paragraph paragraph1 = new Paragraph(); paragraph1.getParagraphFormat().getBullet().setType(BulletType.Picture); paragraph1.getParagraphFormat().getBullet().getPicture().setImage(bulletImage); paragraph1.getParagraphFormat().setIndent(15); paragraph1.getParagraphFormat().getBullet().setHeight(100); paragraph1.setText("The first paragraph"); textFrame.getParagraphs().add(paragraph1); Paragraph paragraph2 = new Paragraph(); paragraph2.getParagraphFormat().getBullet().setType(BulletType.Picture); paragraph2.getParagraphFormat().getBullet().getPicture().setImage(bulletImage); paragraph2.getParagraphFormat().setIndent(15); paragraph2.getParagraphFormat().getBullet().setHeight(100); paragraph2.setText("The second paragraph"); textFrame.getParagraphs().add(paragraph2); presentation.save("picture_bullets.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` Результат: ![Маркер‑изображения](picture_bullets.png) ## **Создание многоуровневого списка** Используйте [IParagraphFormat.setDepth](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraphformat/#setDepth-short-) для размещения элементов списка на разных уровнях. Уровень 0 — верхний уровень, уровень 1 — вложенный под ним, и т.д. Следующий код Java показывает, как создать многоуровневый маркированный список: ```java Presentation presentation = new Presentation(); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 260, 110); ITextFrame textFrame = autoShape.getTextFrame(); textFrame.getParagraphs().clear(); Paragraph paragraph1 = new Paragraph(); paragraph1.getParagraphFormat().setDepth((short) 0); paragraph1.setText("My text - Depth 0"); textFrame.getParagraphs().add(paragraph1); Paragraph paragraph2 = new Paragraph(); paragraph2.getParagraphFormat().setDepth((short) 1); paragraph2.setText("My text - Depth 1"); textFrame.getParagraphs().add(paragraph2); Paragraph paragraph3 = new Paragraph(); paragraph3.getParagraphFormat().setDepth((short) 2); paragraph3.setText("My text - Depth 2"); textFrame.getParagraphs().add(paragraph3); Paragraph paragraph4 = new Paragraph(); paragraph4.getParagraphFormat().setDepth((short) 3); paragraph4.setText("My text - Depth 3"); textFrame.getParagraphs().add(paragraph4); presentation.save("multilevel_bullets.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` Результат: ![Многоуровневый список](multilevel_list.png) ## **Изменение существующего списка** Чтобы изменить форматирование списка в существующей презентации, получите доступ к целевому абзацу и обновите его настройки [IParagraphFormat.getBullet](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraphformat/#getBullet--). Те же свойства, которые использовались для создания списков, можно применять для проверки или изменения списков, загруженных из файлов PPT, PPTX или ODP. Следующий код Java изменяет первый абзац в текстовом фрейме, чтобы использовать стиль нумерованного списка: ```java Presentation presentation = new Presentation("input.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = (IAutoShape) slide.getShapes().get_Item(0); IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0); paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered); paragraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletRomanUCPeriod); paragraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 1); paragraph.getParagraphFormat().setMarginLeft(30); paragraph.getParagraphFormat().setIndent(-20); presentation.save("updated_list.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` ## **Вопросы и ответы** **Можно ли экспортировать маркированные и нумерованные списки в PDF или изображения?** Да. Aspose.Slides сохраняет форматирование списков, если целевой формат поддерживает соответствующее расположение текста и функции маркеров. **Могу ли я редактировать списки в существующих презентациях?** Да. Загрузите презентацию, получите доступ к целевому абзацу, проверьте или обновите его настройки [IParagraphFormat.getBullet](https://reference.aspose.com/slides/ru/java/com.aspose.slides/iparagraphformat/#getBullet--), и сохраните презентацию. **Могут ли списки содержать нелатинский текст?** Да. Текст элементов списка может содержать символы Unicode, поэтому вы можете создавать списки в многоязычных презентациях. Убедитесь, что шрифты, используемые в презентации, поддерживают необходимые вам символы.