Create a New Paragraph

Introduction

This article shows how you can create a new paragraph in PowerPoint presentations using Aspose.Slides for Cloud API. You can use our REST API with any language: .NET, Java, PHP, Ruby, Python, С++, and much more.

API Information

API	Type	Description	Resource
/slides/{name}/slides/{slideIndex}/shapes/{shapeIndex}/paragraphs	POST	Creates a new paragraph in a shape.	CreateParagraph

Request Parameters

Name	Type	Location	Required	Description
name	string	path	true	The presentation file name.
slideIndex	integer	path	true	The 1-based index of the presentation slide.
shapeIndex	integer	path	true	The 1-based index of the shape.
dto	object	body	true	The data transfer object of the paragraph.
position	integer	query	false	The position of the new paragraph in the list. Default is at the end of the list.
password	string	header	false	The password to open the presentation.
folder	string	query	false	The folder where the presentation file is located.
storage	string	query	false	The storage where the presentation file is located.

In case of Amazon S3 storage folder path starts with Amazon S3 bucket name.

cURL Example

You can add an empty paragraph or paragraph with portions.

Request


curl -v "https://api.aspose.cloud/connect/token" -X POST -d "grant_type=client_credentials&client_id=XXXX&client_secret=XXXX-XX" -H "Content-Type: application/x-www-form-urlencoded" -H "Accept: application/json"


curl  -v -X POST "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/shapes/2/paragraphs" -d @"paragraph.json" -H "Content-Type: text/json" -H "Authorization: Bearer [Access Token]

paragraph.json

{
    "marginLeft": 2,
    "marginRight" : 2, 
    "alignment" : "center",
    "portionList":[
        {
            "text" :"portion 1 text"
        },
        {
            "text": "portion 2 text",
            "fontBold": true
        }
    ]
}

Response

Code: 201
Returns paragraph info.

SDK Source

The Aspose for Cloud SDKs can be downloaded from the following page: Available SDKs.

SDK Examples

SlidesApi api = new SlidesApi("MyClientId", "MyClientSecret");
Paragraph dto = new Paragraph()
{
    MarginLeft = 2,
    MarginRight = 2,
    Alignment = Paragraph.AlignmentEnum.Center,
    PortionList = new List<Portion>()
    {
        new Portion()
        {
            Text = "Portion1"
        },
        new Portion()
        {
            Text = "Portion2",
            FontBold = Portion.FontBoldEnum.True
        }
    }
};

Paragraph response = api.CreateParagraph("MyPresentation.pptx", 1, 2, dto, null, null, null);

Java

PHP

Ruby

Python

Node.js

Android

C++

Perl

Swift

Read Paragraph Properties Update Paragraph Properties