Textfelder in PowerPoint-Präsentationen in Java verwalten

Worum es auf dieser Seite geht

Erstellen, inspizieren, ändern und entfernen Sie Textfelder in PowerPoint-Präsentationen mit Aspose.Slides für Java. Formatierung beibehalten und gespeicherte PPTX- und PPT-Dateien überprüfen.

Übersicht

Ein Textabsatz besteht aus Portionen. Eine gewöhnliche IPortion enthält wörtlichen Text; eine Feldportion hat außerdem ein IField, dessen Typ einen automatisch aktualisierten Wert bezeichnet, z. B. eine Foliennummer oder ein Datum. Zwei Portionen können dieselben Zeichen anzeigen, während nur eine ein Feld enthält.

Verwenden Sie IPortion.getField , um sie zu unterscheiden: Sie ist null für gewöhnlichen Text. IPortion.addField wandelt eine vorhandene Portion in ein Feld um. Halten Sie Beschriftung und dynamischen Wert in separaten Portionen, damit das Konvertieren des Wertes nicht gleichzeitig die Beschriftung ersetzt.

Dieses Handbuch behandelt Felder innerhalb von Text, deren Formatierung und das Speichern in PPTX und PPT. Für Textfelder und Absätze siehe Text verwalten.

Erstellen eines Foliennummernfelds

Das folgende vollständige Beispiel erstellt ein Textfeld, das eine wörtliche Beschriftung Slide gefolgt von einer automatisch aktualisierten Nummer enthält. Es legt Größe, Gewicht und Farbe der Nummer fest, bevor das Feld hinzugefügt wird, öffnet anschließend die gespeicherte Präsentation wieder und prüft den Feldtyp, den Text und die Formatierung. Es ist keine Eingabedatei erforderlich.

import java.awt.Color;
import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 240, 50);
    shape.addTextFrame("Slide ");
    IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);

    Portion numberPortion = new Portion();
    Color numberColor = new Color(0, 0, 139);
    numberPortion.getPortionFormat().setFontHeight(24);
    numberPortion.getPortionFormat().setFontBold(NullableBool.True);
    numberPortion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    numberPortion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(numberColor);
    paragraph.getPortions().add(numberPortion);
    numberPortion.addField(FieldType.getSlideNumber());

    presentation.save("slide_number.pptx", SaveFormat.Pptx);

    Presentation reopened = new Presentation("slide_number.pptx");
    try {
        IAutoShape savedShape = (IAutoShape) reopened.getSlides().get_Item(0).getShapes().get_Item(0);
        IPortion savedNumber = savedShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1);
        IField savedField = savedNumber.getField();
        boolean hasNumberField = savedField != null && FieldType.getSlideNumber().getInternalString().equals(savedField.getType().getInternalString());
        IPortionFormat format = savedNumber.getPortionFormat();
        boolean formattingPreserved = format.getFontHeight() == 24 && format.getFontBold() == NullableBool.True;
        formattingPreserved &= format.getFillFormat().getSolidFillColor().getColor().getRGB() == numberColor.getRGB();

        System.out.println("Text: " + savedShape.getTextFrame().getText());
        System.out.println("Slide number field: " + hasNumberField);
        System.out.println("Formatting preserved: " + formattingPreserved);
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

Die neue Präsentation beginnt mit Foliennummer 1, sodass der Text Slide 1 lautet und beide Prüfungen true ausgeben. Die Nummer bleibt nach dem erneuten Öffnen ein Feld; sie ist kein wörtliches 1. Die Typumwandlungen und Indizes in der Verifikation beziehen sich auf die von diesem Beispiel erstellte Form und die Portionen.

Auswahl eines Feldtyps

FieldType implementiert IFieldType und stellt die folgenden Methoden zum Abrufen vordefinierter Werte bereit. Übergeben Sie den entsprechenden Wert an addField.

Methode	Zweck
getSlideNumber	Die aktuelle Foliennummer.
getDateTime	Datum/Uhrzeit im Standardformat der rendernden Anwendung.
getDateTime1–getDateTime9	Vordefinierte Datum- oder kombinierte Datum/Uhrzeit-Formate.
getDateTime10–getDateTime13	Vordefinierte Zeitformate, mit Optionen für Sekunden und einer 12‑Stunden‑Uhr.
getHeader	Ein Kopfzeilenfeld; siehe unten die Platzhalter‑ und Formatbeschränkungen.
getFooter	Ein Fußzeilenfeld.

Zum Beispiel stellt getDateTime3 einen Tag, den vollständigen Monatsnamen und das Jahr in Englisch dar. Dies sind vordefinierte Feldformate, keine beliebigen Java‑Datum‑Format‑Zeichenfolgen. Die mit setLanguageId festgelegte Sprache und die Anwendung, die die Präsentation verarbeitet, können das angezeigte Ergebnis beeinflussen.

Erstellen eines Feldes aus einem internen String

Die String‑Überladung von addField akzeptiert einen internen Feld‑Bezeichner. Verwenden Sie sie, wenn Sie einen von einer anderen Anwendung bereitgestellten Bezeichner erhalten wollen, für den es keinen vordefinierten Wert gibt. Sie können auch ein FieldType aus dem Bezeichner erstellen. IFieldType.getInternalString legt diesen Bezeichner zur Inspektion offen.

Dieses Beispiel speichert ein anwendungsspezifisches Feld custom-report-id mit dem Ersatztext Report-042. Der Bezeichner registriert keine Berechnung: Aspose.Slides generiert keine Bericht‑IDs für einen unbekannten Typ. Die Anwendung, die diesen Bezeichner versteht, muss seine Bedeutung bereitstellen und seinen Wert aktualisieren.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    IAutoShape shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 300, 50);
    shape.addTextFrame("Report-042");
    IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
    portion.addField("custom-report-id");

    presentation.save("custom_field.pptx", SaveFormat.Pptx);

    Presentation reopened = new Presentation("custom_field.pptx");
    try {
        IAutoShape savedShape = (IAutoShape) reopened.getSlides().get_Item(0).getShapes().get_Item(0);
        IPortion savedPortion = savedShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
        IField savedField = savedPortion.getField();
        String typeName = savedField == null ? "ordinary text" : savedField.getType().getInternalString();
        System.out.println("Type: " + typeName);
        System.out.println("Text: " + savedPortion.getText());
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

Nach diesem PPTX‑Rundlauf ist der Typ custom-report-id und der Text Report-042. Das Übergeben einer Zeichenkette wie yyyy-MM-dd würde einen Feldtyp benennen; es würde kein benutzerdefiniertes Datumsformat konfigurieren. Verwenden Sie für ein festes Datum in einem beliebigen Format normalen Text.

Untersuchen, Ändern und Entfernen von Datum/Uhrzeit‑Feldern

Ändern Sie ein vorhandenes Feld über IField.setType. Prüfen Sie, ob das Feld existiert, bevor Sie auf seinen Typ zugreifen. Um automatische Aktualisierungen zu stoppen, rufen Sie IPortion.removeField auf. Dadurch bleibt die Portion und ihr aktueller Text erhalten, während die Feldzuordnung entfernt wird. Falls Sie einen bestimmten festen Wert benötigen, weisen Sie nach dem Entfernen des Feldes diesen Text zu.

Zur API‑Einstellung, die die Verarbeitung von Datum/Uhrzeit‑Feldern betrifft, siehe Presentation.setCurrentDateTime. Das untenstehende Beispiel verwendet ein explizites Genehmigungsdatum, wenn ein Feld in gewöhnlichen Text umgewandelt wird.

Laden Sie sample.pptx herunter und legen Sie es im Arbeitsverzeichnis ab. Es enthält zwei benannte Textformen, UpdatedAt und ApprovedDate, jeweils mit einem Datum/Uhrzeit‑Feld sowie gewöhnliche Textbeschriftungen. Das folgende Beispiel durchläuft die Textformen der obersten Ebene auf regulären Folien. Es ändert Datum/Uhrzeit‑Felder in ein Langdatumsformat und macht sie kursiv, wobei die übrige Formatierung erhalten bleibt. Nur Felder in ApprovedDate werden zu festem Text.

Das Beispiel erkennt die integrierten internen Bezeichner datetime und datetime1 bis datetime13. Gruppen, Tabellen, Notizen, Layouts und Master erfordern das Durchlaufen ihrer eigenen Textcontainer und liegen außerhalb des Umfangs dieses Beispiels.

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    LocalDate approvalDate = LocalDate.of(2030, 4, 5);
    DateTimeFormatter dateFormat = DateTimeFormatter.ofPattern("dd MMMM yyyy", Locale.US);

    for (ISlide slide : presentation.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (!(shape instanceof IAutoShape)) {
                continue;
            }
            IAutoShape textShape = (IAutoShape) shape;
            if (textShape.getTextFrame() == null) {
                continue;
            }

            for (IParagraph paragraph : textShape.getTextFrame().getParagraphs()) {
                for (IPortion portion : paragraph.getPortions()) {
                    IField field = portion.getField();
                    if (field == null) {
                        continue;
                    }

                    String typeName = field.getType().getInternalString();
                    boolean isDateTime = typeName != null && typeName.matches("datetime([1-9]|1[0-3])?");
                    if (!isDateTime) {
                        continue;
                    }

                    field.setType(FieldType.getDateTime3());
                    portion.getPortionFormat().setLanguageId("en-US");
                    portion.getPortionFormat().setFontItalic(NullableBool.True);

                    if ("ApprovedDate".equals(textShape.getName())) {
                        portion.removeField();
                        String fixedDate = approvalDate.format(dateFormat);
                        portion.setText(fixedDate);
                    }
                }
            }
        }
    }

    presentation.save("updated_dates.pptx", SaveFormat.Pptx);

    Presentation reopened = new Presentation("updated_dates.pptx");
    try {
        for (IShape shape : reopened.getSlides().get_Item(0).getShapes()) {
            if (!(shape instanceof IAutoShape)) {
                continue;
            }
            IAutoShape textShape = (IAutoShape) shape;
            if (textShape.getTextFrame() == null) {
                continue;
            }
            if (!"UpdatedAt".equals(textShape.getName()) && !"ApprovedDate".equals(textShape.getName())) {
                continue;
            }

            IPortion portion = textShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
            IField field = portion.getField();
            String typeName = field == null ? "ordinary text" : field.getType().getInternalString();
            System.out.println(textShape.getName() + ": " + typeName + "; " + portion.getText());
            System.out.println("Italic: " + portion.getPortionFormat().getFontItalic());
        }
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

Nach dem erneuten Öffnen hat UpdatedAt den Typ datetime3 und bleibt dynamisch. ApprovedDate hat kein Feld und enthält 05 April 2030. Beide Datumsportionen sind kursiv, und ihre ursprüngliche Schriftgröße, Fettdruck‑Einstellung und Farbe bleiben erhalten. Die gewöhnlichen Textbeschriftungen bleiben unverändert. Die Verifikation liest die erste Portion der beiden bekannten Formen im bereitgestellten Beispiel.

Textformatierung beibehalten

Arbeiten Sie mit der bestehenden Portion, wenn Sie ein Feld hinzufügen, dessen Typ ändern oder es entfernen. Diese Vorgänge behalten die Formatierung dieser Portion bei. Verwenden Sie IPortion.getPortionFormat , um nur die erforderlichen Eigenschaften zu ändern, wie die Beispiele für Farbe oder Kursivschrift zeigen.

Vermeiden Sie das Neuaufbauen eines gesamten Textrahmens nur zum Aktualisieren eines Feldes: Das kann die ursprünglichen Portionsgrenzen und deren individuelle Formatierung verlieren. Unterscheiden Sie zudem explizit gesetzte Formatierungen von denen, die vom Absatz, Layout oder Theme geerbt werden. Siehe Textformatierung für umfassendere Formatierungsoptionen.

Felder und Platzhalter für Kopf‑/Fußzeilen

Ein Feld ist Teil einer Textportion. Ein Platzhalter ist eine Form mit einer Präsentationsrolle, z. B. Fußzeile oder Foliennummer. Das Hinzufügen eines Feldes zu einem gewöhnlichen Textfeld macht diese Form nicht zu einem Platzhalter.

Die Header‑/Footer‑Manager steuern den Platzhalter‑Text und die Sichtbarkeit auf Folien, Layouts und Master, einschließlich der Weitergabe an abhängige Folien. Ein Zahlenfeld in einem benutzerdefinierten Textfeld kann daher nützlich sein, selbst wenn Sie den Foliennummern‑Platzhalter nicht verwenden. Umgekehrt entfernt das Ändern der Platzhalter‑Sichtbarkeit kein Feld aus einem nicht zugehörigen Textfeld.

Die vordefinierten Header‑ und Footer‑Typen erzeugen nicht die entsprechenden Platzhalter und stellen deren Inhalt nicht bereit. Insbesondere hat eine reguläre PowerPoint‑Folie keinen Header‑Platzhalter; Header gehören zu Notizseiten und Handouts. Gehen Sie nicht davon aus, dass ein Header‑ oder Footer‑Feld in einer beliebigen Form automatisch den durch einen Platzhalter‑Manager konfigurierten Text übernimmt. Für diesen Workflow siehe Präsentations‑Header und‑Footer.

Einschränkungen für PPTX und PPT

Überprüfen Sie sowohl den Feldtyp als auch den resultierenden Text nach dem Speichern und erneuten Öffnen. Das Beibehalten eines Bezeichners beweist nicht, dass eine Anwendung dessen Wert berechnen oder anzeigen kann.

Format	Verhalten des Feldes und Einschränkungen
PPTX	Speichert interne Feld‑Bezeichner zusammen mit dem Feldtext. Bei Rundlauf‑Prüfungen überlebten die vordefinierten Typen und der oben verwendete benutzerdefinierte Bezeichner das Speichern und erneute Öffnen. Der unbekannte benutzerdefinierte Typ behielt seinen Ersatztext bei; er erlangte keine automatische Berechnungslogik. Eine andere Anwendung kann nicht unterstützte Bezeichner anders behandeln.
PPT	Verwendet veraltete Felddarstellungen und hat eine eingeschränktere Kompatibilität. Bei Rundlauf‑Prüfungen überlebten Folien‑Nummern‑ und vordefinierte Datum/Uhrzeit‑Felder das Speichern und erneute Öffnen. Ein benutzerdefiniertes Feld in einem gewöhnlichen Folientextfeld wurde mit seinem Bezeichner, aber mit * als Text wieder geöffnet; ein Header‑Feld im selben Kontext erzeugte ebenfalls *. Verlassen Sie sich nicht darauf, dass benutzerdefinierte Felder oder nicht unterstützte Feldkontexte ihren sichtbaren Text behalten.

Für portable, feste Ausgaben konvertieren Sie nicht unterstützte Felder in gewöhnlichen Text und weisen Sie vor dem Speichern explizit den gewünschten Wert zu. Dadurch wird der gewählte Text beibehalten, aber automatische Aktualisierungen bewusst gestoppt. Testen Sie auch die Zielanwendung, wenn deren eigene Feldneuberechnung Teil Ihres Workflows ist.

FAQ

Wie kann ich feststellen, ob eine angezeigte Nummer oder ein Datum ein Feld ist?
Untersuchen Sie IPortion.getField. Ein Wert ungleich null identifiziert ein Feld; der angezeigte Text allein kann das nicht ergeben.

Entfernt das Entfernen eines Feldes dessen Text oder Formatierung?
Nein. removeField wandelt die bestehende Portion in gewöhnlichen Text um. Weisen Sie danach einen expliziten Wert zu, wenn Sie ein bestimmtes eingefrorenes Datum oder einen Ersatzwert benötigen.

Kann ein interner String ein neues Datumsformat oder eine Formel definieren?
Nein. Er identifiziert einen Feldtyp. Ein unbekannter Bezeichner liefert keinen Evaluator oder ein Java‑Datum‑Format‑Muster. Verwenden Sie einen unterstützten vordefinierten Typ oder formatieren Sie einen Wert selbst als gewöhnlichen Text.

Warum sollte man eine Präsentation nach dem Speichern erneut überprüfen?
Feld‑Bezeichner, berechneter Text und Formatierung sind getrennte Dinge, die überprüft werden müssen. Eine Formatkonvertierung kann das sichtbare Ergebnis ändern, auch wenn der Feld‑Bezeichner weiterhin vorhanden ist.