Update Paragraph Properties

Introduction

This article shows how you can update properties of a paragraph by index in PowerPoint presentations using Aspose.Slides for Cloud API. Using the paragraph settings, you can change the appearance of an entire block of text. These settings include alignments, indents, spacing, etc. Some settings allow you to create bulleted and numbered lists. 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/{paragraphIndex}	PUT	Updates properties of a paragraph in a shape.	UpdateParagraph

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.
paragraphIndex	integer	path	true	The 1-based index of the paragraph.
dto	object	body	true	The data transfer object of the paragraph.
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

Update the second paragraph in the first shape on the first slide. Set text alignment to Justify. Set Margin Left to 30pt. Set Space Before to 20pt. The storage name is Main. The folder name is Data.

Request

curl -v -X PUT "https://api.aspose.cloud/v3.0/slides/example.pptx/slides/1/shapes/1/paragraphs/2?folder=Data&storage=Main" -d "{'Alignment':'Justify','MarginLeft':30.0,'SpaceBefore':-20.0}" -H "Content-Type: application/json" -H "Authorization: Bearer <access_token>" --ssl-no-revoke

Response

{
    "marginLeft": 30.0,
    "spaceBefore": -20.0,
    "alignment": "Justify",
    "portionList": [
        {
            "text": "The second paragraph to demonstrate updating the paragraph settings.",
            "fontColor": "#FF000000",
            "highlightColor": "#0",
            "fontHeight": 18.0,
            "languageId": "en-US",
            "selfUri": {
                "href": "https://api.aspose.cloud/v3.0/slides/example.pptx/slides/1/shapes/1/paragraphs/2/portions/1?folder=Data",
                "relation": "self"
            }
        }
    ],
    "selfUri": {
        "href": "https://api.aspose.cloud/v3.0/slides/example.pptx/slides/1/shapes/1/paragraphs/2?folder=Data",
        "relation": "self"
    }
}

SDK Source

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

SDK Examples

The following code examples also use GetParagraph method.

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-dotnet

using Aspose.Slides.Cloud.Sdk;
using Aspose.Slides.Cloud.Sdk.Model;
using System;

class Test
{
    static void Main()
    {
        SlidesApi api = new SlidesApi("MyClientApi", "MyClientSecret");

        var fileName = "example.pptx";
        var slideIndex = 1;
        var shapeIndex = 1;
        var paragraphIndex = 1;
        
        // Get a paragraph from the presentation.
        var paragraph = api.GetParagraph(fileName, slideIndex, shapeIndex, paragraphIndex);

        // Change some paragraph settings.
        paragraph.Alignment = Paragraph.AlignmentEnum.Justify;
        paragraph.MarginLeft = 30;
        paragraph.SpaceBefore = -20; // The negative value means it is in points.

        // Update the paragraph settings.
        api.UpdateParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph);
    }
}

Java

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-java

import com.aspose.slides.api.SlidesApi;
import com.aspose.slides.model.Paragraph;
import com.aspose.slides.ApiException;

public class Main {
    public static void main(String[] args) throws ApiException {
        SlidesApi slidesApi = new SlidesApi("my_client_id", "my_client_key");

        String storageName = "Main";
        String folderName = "Data";
        String fileName = "example.pptx";
        int slideIndex = 1;
        int shapeIndex = 1;
        int paragraphIndex = 1;
        String password = "";

        // Get a paragraph from the presentation.
        Paragraph paragraph = slidesApi.getParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, password, folderName, storageName, null);

        // Change some paragraph settings.
        paragraph.setAlignment(Paragraph.AlignmentEnum.JUSTIFY);
        paragraph.setMarginLeft(30.0);
        paragraph.setSpaceBefore(-20.0); // The negative value means it is in points.

        // Update the paragraph settings.
        slidesApi.updateParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph, password, folderName, storageName, null);
    }
}

PHP

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-php

use Aspose\Slides\Cloud\Sdk\Api\Configuration;
use Aspose\Slides\Cloud\Sdk\Api\SlidesApi;
use Aspose\Slides\Cloud\Sdk\Model;

$configuration = new Configuration();
$configuration->setAppSid("my_client_id");
$configuration->setAppKey("my_client_key");

$slidesApi = new SlidesApi(null, $configuration);

$storageName = "Main";
$folderName = "Data";
$fileName = "example.pptx";
$slideIndex = 1;
$shapeIndex = 1;
$paragraphIndex = 1;
$password = "";

// Get a paragraph from the presentation.
$paragraph = $slidesApi->getParagraph($fileName, $slideIndex, $shapeIndex, $paragraphIndex, $password, $folderName, $storageName);

// Change some paragraph settings.
$paragraph->setAlignment(Model\Paragraph::ALIGNMENT_JUSTIFY);
$paragraph->setMarginLeft(30);
$paragraph->setSpaceBefore(-20); // The negative value means it is in points.

// Update the paragraph settings.
$slidesApi->updateParagraph($fileName, $slideIndex, $shapeIndex, $paragraphIndex, $paragraph, $password, $folderName, $storageName);

Ruby

Python

# For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-python

import asposeslidescloud

from asposeslidescloud.apis.slides_api import SlidesApi
from asposeslidescloud.models.paragraph import Paragraph

slides_api = SlidesApi(None, "my_client_id", "my_client_key")

storageName = "Main"
folderName = "Data"
fileName = "example.pptx"
slideIndex = 1
shapeIndex = 1
paragraphIndex = 1
password = ""

# Get a paragraph from the presentation.
paragraph = slides_api.get_paragraph(fileName, slideIndex, shapeIndex, paragraphIndex, password, folderName, storageName)

# Change some paragraph settings.
paragraph.alignment = "Justify"
paragraph.margin_left = 30
paragraph.space_before = -20 # The negative value means it is in points.

# Update the paragraph settings.
slides_api.update_paragraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph, password, folderName, storageName)

Node.js

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-nodejs

const api = require("asposeslidescloud");

const slidesApi = new api.SlidesApi("my_client_id", "my_client_key");

const storageName = "Main";
const folderName = "Data";
const fileName = "example.pptx";
const slideIndex = 1;
const shapeIndex = 1;
const paragraphIndex = 1;
const password = "";

// Get a paragraph from the presentation.
slidesApi.getParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, password, folderName, storageName).then(getResponse => {
    const paragraph = getResponse.body;
    // Change some paragraph settings.
    paragraph.alignment = "Justify";
    paragraph.marginLeft = 30;
    paragraph.spaceBefore = -20; // The negative value means it is in points.

    // Update the paragraph settings.
    slidesApi.updateParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph, password, folderName, storageName).then(updateResponse => {
        console.log(updateResponse.body);
    });
});

Android

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-android

import com.aspose.slides.api.SlidesApi;
import com.aspose.slides.model.Paragraph;
import com.aspose.slides.ApiException;

public class Main {
    public static void main(String[] args) throws ApiException {
        SlidesApi slidesApi = new SlidesApi("my_client_id", "my_client_key");

        String storageName = "Main";
        String folderName = "Data";
        String fileName = "example.pptx";
        int slideIndex = 1;
        int shapeIndex = 1;
        int paragraphIndex = 1;
        String password = "";

        // Get a paragraph from the presentation.
        Paragraph paragraph = slidesApi.getParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, password, folderName, storageName, null);

        // Change some paragraph settings.
        paragraph.setAlignment(Paragraph.AlignmentEnum.JUSTIFY);
        paragraph.setMarginLeft(30.0);
        paragraph.setSpaceBefore(-20.0); // The negative value means it is in points.

        // Update the paragraph settings.
        slidesApi.updateParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph, password, folderName, storageName, null);
    }
}

C++

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-cpp

#include "asposeslidescloud/api/SlidesApi.h"

using namespace utility::conversions;
using namespace asposeslidescloud::api;

int main()
{
	auto slidesApi = std::make_shared<SlidesApi>(to_string_t("my_client_id"), to_string_t("my_client_key"));

	auto storageName = to_string_t("Main");
	auto folderName = to_string_t("Data");
	auto fileName = to_string_t("example.pptx");
	auto slideIndex = 1;
	auto shapeIndex = 1;
	auto paragraphIndex = 1;
	auto password = to_string_t("");

    // Get a paragraph from the presentation.
    auto paragraph = slidesApi->getParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, password, folderName, storageName).get();

    // Change some paragraph settings.
    paragraph->setAlignment(to_string_t("Justify"));
    paragraph->setMarginLeft(30);
    paragraph->setSpaceBefore(-20); // The negative value means it is in points.

    // Update the paragraph settings.
    slidesApi->updateParagraph(fileName, slideIndex, shapeIndex, paragraphIndex, paragraph, password, folderName, storageName).get();
	
	return 0;
}

Perl

Swift

To see all available paragraph settings, go to Paragraph Properties section.

Create a New Paragraph Get Paragraph Effective Values