Skip to main content
Skip table of contents

remove

Versionshinweise

22.1, 21.2.06, 21.1.11

Code

GROOVY
boolean remove(PresentationDocument document, String identifier, int pageIndex, int paragraphIndex, int portionIndex)

Beschreibung

Entfernen eines kompletten Textes, Absatz oder Textfragments aus einer Textkomponente der übergebenen Präsentationsdatei.
Eine Erläuterung zur Verwendung von paragraphIndex und portionIndex findest sich unter PresentationUtils.setValue.

Parameter

  • document

    Repräsentiert die Präsentatiosndatei
  • identifier
    Name der Textkomponente
  • pageIndex
    Index der Seite, auf der sich die Textkomponente befindet (erste Seite startet mit 1)
  • paragraphIndex
    Optionaler Parameter zur Adressierung auf Absatzebene
    Index des Absatzes (erster Absatz startet mit 1). Eine Textkomponente kann mehrere Absätze enthalten.
  • portionIndex 
    Optionaler Parameter zur Adressierung auf Ebene eines Textfragments
    Index eines formatierten Textfragments in einer Zeile (erstes Textfragment startet mit 1). Eine Zeile kann mehrere formatierte Textfragmente enthalten.

Rückgabe

Liefert true, wenn das Entfernen des Textes, Absatz oder Textfragments aus der Textkomponente erfolgreich war, ansonsten false.

Beispiele

GROOVY
IPresentationResult openResult = PresentationUtils.openFile("C:\\Work\\myFirstPresentation.ppsx");

if (!PresentationUtils.isSuccessful(openResult))
{
	/** handle error code */
    return;
}

PresentationDocument presentation = null;
try
{
  presentation = PresentationUtils.getPresentationDocument(openResult);

  String identifier = "myTitle";
  int pageIndex = 1;

  if (PresentationUtils.existsComponent(presentation, identifier, pageIndex))
  {
	   /** remove 2nd paragraph of text component "myTitle" */
       boolean success = PresentationUtils.remove(presentation, identifier, pageIndex, 2);
       ...
  }
}
finally
{
  PresentationUtils.close(presentation);
}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.