Delete Text Portions Introduction Aspose.Slides Cloud API allows you to read, add, and modify text portions on special slides (Master, Layout, Notes) in PowerPoint presentations. Use the following methods to delete text portions within paragraphs.
DeleteSpecialSlidePortions
API Type Description Resource
/slides/{name}/slides/{slideIndex}/{slideType}/shapes/{shapeIndex}/paragraphs/{paragraphIndex}/portions
DELETE
Deletes text portions from a paragraph in a shape located on a special slide in a presentation saved in a storage.
DeleteSpecialSlidePortions
Request Parameters
Name Type Location Required Description
name
string
path
true
The name of a presentation file.
slideIndex
integer
path
true
The 1-based index of a regular slide.
slideType
SpecialSlideTypepath
true
The type of a special slide.
shapeIndex
integer
path
true
The 1-based index of a shape.
paragraphIndex
integer
path
true
The 1-based index of a paragraph.
portions
string
query
false
The indices of the text portions to be deleted. Delete all by default.
password
string
header
false
The password to open the presentation.
folder
string
query
false
The path to the folder containing the presentation.
storage
string
query
false
The name of the storage contaning the folder.
subShape
string
query
false
The path to a child shape (e.g. “3”, “3/shapes/2”).
DeleteSpecialSlidePortion
API Type Description Resource
/slides/{name}/slides/{slideIndex}/{slideType}/shapes/{shapeIndex}/paragraphs/{paragraphIndex}/portions/{portionIndex}
DELETE
Deletes a text portion from a paragraph in a shape located on a special slide in a presentation saved in a storage.
DeleteSpecialSlidePortion
Request Parameters
Name Type Location Required Description
name
string
path
true
The name of a presentation file.
slideIndex
integer
path
true
The 1-based index of a regular slide.
slideType
SpecialSlideTypepath
true
The type of a special slide.
shapeIndex
integer
path
true
The 1-based index of a shape.
paragraphIndex
integer
path
true
The 1-based index of a paragraph.
portionIndex
integer
path
true
The 1-based index of a text portion to be deleted.
password
string
header
false
The password to open the presentation.
folder
string
query
false
The path to the folder containing the presentation.
storage
string
query
false
The name of the storage contaning the folder.
subShape
string
query
false
The path to a child shape (e.g. “3”, “3/shapes/2”).
Examples The document MyPresentation.pptx saved in the default storage contains two text boxes on the Layout of the first slide. The second text box contains three paragraphs. Delete the first text portion from the first paragraph.
cURL Solution
Request
Get an Access Token
curl POST "https://api.aspose.cloud/connect/token" \
"grant_type=client_credentials&client_id=MyClientId&client_secret=MyClientSecret" \
"Content-Type: application/x-www-form-urlencoded"
Delete the Text Portion
curl -X DELETE "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/LayoutSlide/shapes/2/paragraphs/1/portions/1" \
"authorization: Bearer MyAccessToken"
Response
Response Example
{
"items" : [
{
"text" : "The third paragraph" ,
"highlightColor" : "#0" ,
"fontHeight" : "NaN" ,
"languageId" : "en-US" ,
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/layoutSlides/1/shapes/2/paragraphs/1/portions/1" ,
"relation" : "self" ,
"shapeIndex" : 2
}
},
{
"text" : "." ,
"highlightColor" : "#0" ,
"fontHeight" : "NaN" ,
"languageId" : "en-US" ,
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/layoutSlides/1/shapes/2/paragraphs/1/portions/1" ,
"relation" : "self" ,
"shapeIndex" : 2
}
}
],
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/layoutSlides/1/shapes/1/paragraphs/1/portions" ,
"relation" : "self" ,
"shapeIndex" : 2
}
}
SDK Solutions
C#
using System ;
using Aspose.Slides.Cloud.Sdk ;
using Aspose.Slides.Cloud.Sdk.Model ;
class Application
{
static void Main ( string [] args )
{
SlidesApi slidesApi = new SlidesApi ( "MyClientId" , "MyClientSecret" );
string fileName = "MyPresentation.pptx" ;
int slideIndex = 1 ;
SpecialSlideType slideType = SpecialSlideType . LayoutSlide ;
int shapeIndex = 2 ;
int paragraphIndex = 1 ;
int portionIndex = 1 ;
Portions textPortions = slidesApi . DeleteSpecialSlidePortion ( fileName , slideIndex , slideType , shapeIndex , paragraphIndex , portionIndex );
int portionCount = textPortions . Items . Count ;
Console . WriteLine ( "Number of text portions: " + portionCount ); // 2
}
}
Java
import com.aspose.slides.ApiException ;
import com.aspose.slides.api.SlidesApi ;
import com.aspose.slides.model.Portions ;
import com.aspose.slides.model.SpecialSlideType ;
public class Application {
public static void main ( String [] args ) throws ApiException {
SlidesApi slidesApi = new SlidesApi ( "MyClientId" , "MyClientSecret" );
String fileName = "MyPresentation.pptx" ;
int slideIndex = 1 ;
SpecialSlideType slideType = SpecialSlideType . LAYOUTSLIDE ;
int shapeIndex = 2 ;
int paragraphIndex = 1 ;
int portionIndex = 1 ;
Portions textPortions = slidesApi . deleteSpecialSlidePortion ( fileName , slideIndex , slideType , shapeIndex , paragraphIndex , portionIndex , null , null , null , null );
int portionCount = textPortions . getItems (). size ();
System . out . println ( "Number of text portions: " + portionCount ); // 2
}
}
PHP
use Aspose\Slides\Cloud\Sdk\Api\Configuration ;
use Aspose\Slides\Cloud\Sdk\Api\SlidesApi ;
use Aspose\Slides\Cloud\Sdk\Model\SpecialSlideType ;
$configuration = new Configuration ();
$configuration -> setAppSid ( "MyClientId" );
$configuration -> setAppKey ( "MyClientSecret" );
$slidesApi = new SlidesApi ( null , $configuration );
$fileName = "MyPresentation.pptx" ;
$slideIndex = 1 ;
$slideType = SpecialSlideType :: LAYOUT_SLIDE ;
$shapeIndex = 2 ;
$paragraphIndex = 1 ;
$portionIndex = 1 ;
$textPortions = $slidesApi -> deleteSpecialSlidePortion ( $fileName , $slideIndex , $slideType , $shapeIndex , $paragraphIndex , $portionIndex );
$portionCount = count ( $textPortions -> getItems ());
echo "Number of text portions: " , $portionCount ; // 2
Ruby
require "aspose_slides_cloud"
include AsposeSlidesCloud
configuration = Configuration . new
configuration . app_sid = "MyClientId"
configuration . app_key = "MyClientSecret"
slides_api = SlidesApi . new ( configuration )
file_name = "MyPresentation.pptx"
slide_index = 1
slide_type = SpecialSlideType :: LAYOUT_SLIDE
shape_index = 2
paragraph_index = 1
portion_index = 1
text_portions = slides_api . delete_special_slide_portion ( file_name , slide_index , slide_type , shape_index , paragraph_index , portion_index )
portion_count = text_portions . items . length ()
print "Number of text portions: " , portion_count # 2
Python
from asposeslidescloud.apis import SlidesApi
from asposeslidescloud.models import SpecialSlideType
slides_api = SlidesApi ( None , "MyClientId" , "MyClientSecret" )
file_name = "MyPresentation.pptx"
slide_index = 1
slide_type = SpecialSlideType . LAYOUTSLIDE
shape_index = 2
paragraph_index = 1
portion_index = 1
text_portions = slides_api . delete_special_slide_portion ( file_name , slide_index , slide_type , shape_index , paragraph_index , portion_index )
portion_count = len ( text_portions . items )
print ( "Number of text portions:" , portion_count ) # 2
Node.js
const cloudSdk = require ( "asposeslidescloud" );
const slidesApi = new cloudSdk . SlidesApi ( "MyClientId" , "MyClientSecret" );
fileName = "MyPresentation.pptx" ;
slideIndex = 1 ;
slideType = cloudSdk . SpecialSlideType . LayoutSlide ;
shapeIndex = 2 ;
paragraphIndex = 1 ;
portionIndex = 1 ;
slidesApi . deleteSpecialSlidePortion ( fileName , slideIndex , slideType , shapeIndex , paragraphIndex , portionIndex ). then ( textPortions => {
portionCount = textPortions . body . items . length ;
console . log ( "Number of text portions:" , portionCount ); // 2
});
C++
#include "asposeslidescloud/api/SlidesApi.h"
using namespace asposeslidescloud :: api ;
int main ()
{
std :: shared_ptr < SlidesApi > slidesApi = std :: make_shared < SlidesApi > ( L "MyClientId" , L "MyClientSecret" );
const wchar_t * fileName = L "MyPresentation.pptx" ;
int slideIndex = 1 ;
const wchar_t * slideType = L "LayoutSlide" ;
int shapeIndex = 2 ;
int paragraphIndex = 1 ;
int portionIndex = 1 ;
std :: shared_ptr < Portions > textPortions = slidesApi -> deleteSpecialSlidePortion ( fileName , slideIndex , slideType , shapeIndex , paragraphIndex , portionIndex ). get ();
int portionCount = textPortions -> getItems (). size ();
std :: wcout << L "Number of text portions: " << portionCount ; // 2
}
Perl
use AsposeSlidesCloud::Configuration ;
use AsposeSlidesCloud::SlidesApi ;
my $configuration = AsposeSlidesCloud::Configuration -> new ();
$configuration -> { app_sid } = "MyClientId" ;
$configuration -> { app_key } = "MyClientSecret" ;
my $slides_api = AsposeSlidesCloud::SlidesApi -> new ( config => $configuration );
my $file_name = "MyPresentation.pptx" ;
my $slide_index = 1 ;
my $slide_type = "LayoutSlide" ;
my $shape_index = 2 ;
my $paragraph_index = 1 ;
my $portion_index = 1 ;
my $text_portions = $slides_api -> delete_special_slide_portion (
name => $file_name , slide_index => $slide_index , slide_type => $slide_type , shape_index => $shape_index , paragraph_index => $paragraph_index , portion_index => $portion_index );
my $portion_count = @ { $text_portions -> { items }};
print ( "Number of text portions: " , $portion_count ); # 2
Swift
Go
import (
"fmt"
asposeslidescloud "github.com/aspose-slides-cloud/aspose-slides-cloud-go/v24"
)
func main () {
configuration := asposeslidescloud . NewConfiguration ()
configuration . AppSid = "MyClientId"
configuration . AppKey = "MyClientSecret"
slidesApi := asposeslidescloud . NewAPIClient ( configuration ). SlidesApi
fileName := "MyPresentation.pptx"
var slideIndex int32 = 1
slideType := string ( asposeslidescloud . SpecialSlideType_LayoutSlide )
var shapeIndex int32 = 2
var paragraphIndex int32 = 1
var portionIndex int32 = 1
textPortions , _ , _ := slidesApi . DeleteSpecialSlidePortion ( fileName , slideIndex , slideType , shapeIndex , paragraphIndex , portionIndex , "" , "" , "" , "" )
portionCount := len ( textPortions . GetItems ())
fmt . Println ( "Number of text portions:" , portionCount ) // 2
}
The result:
SDKs Check Available SDKs to learn how to add an SDK to your project.
