Verwalten von Präsentationseigenschaften in C++
Zugriff auf Präsentationseigenschaften
Wie bereits beschrieben, unterstützt Aspose.Slides für C++ zwei Arten von Dokumenteneigenschaften: eingebaute und benutzerdefinierte Eigenschaften. Entwickler können beide Arten von Eigenschaften über die Aspose.Slides‑C++‑API abrufen. Aspose.Slides für C++ stellt die Klasse IDocumentProperties bereit, die die Dokumenteneigenschaften einer Präsentationsdatei über die Methode Presentation::get_DocumentProperties() repräsentiert. Entwickler können die durch das Presentation‑Objekt bereitgestellte Methode get_DocumentProperties() verwenden, um die Dokumenteneigenschaften von Präsentationsdateien wie unten beschrieben zu erhalten:
Microsoft PowerPoint bietet die Möglichkeit, einigen Präsentationsdateien Eigenschaften hinzuzufügen. Diese Dokumenteneigenschaften ermöglichen das Speichern nützlicher Informationen zusammen mit den Dokumenten (Präsentationsdateien). Es gibt die folgenden zwei Arten von Dokumenteneigenschaften:
- Systemdefinierte (eingebaute) Eigenschaften
- Benutzerdefinierte (eigene) Eigenschaften
Eingebaute Eigenschaften enthalten allgemeine Informationen über das Dokument, wie Dokumenttitel, Autorname, Dokumentstatistiken usw. Benutzerdefinierte Eigenschaften sind vom Benutzer als Name/Wert‑Paare definiert, wobei sowohl Name als auch Wert vom Benutzer festgelegt werden. Mit Aspose.Slides für C++ können Entwickler sowohl eingebaute als auch benutzerdefinierte Eigenschaften lesen und ändern. Microsoft PowerPoint 2007 ermöglicht die Verwaltung der Dokumenteneigenschaften von Präsentationsdateien. Klicken Sie dazu einfach auf das Office‑Symbol und anschließend auf Prepare | Properties | Advanced Properties in Microsoft PowerPoint 2007. Nach der Auswahl von Advanced Properties erscheint ein Dialog, in dem Sie die Dokumenteneigenschaften der PowerPoint‑Datei verwalten können. Im Properties Dialog sehen Sie mehrere Registerkarten wie General, Summary, Statistics, Contents und Custom. Alle diese Registerkarten erlauben die Konfiguration verschiedener Informationsarten zu den PowerPoint‑Dateien. Die Registerkarte Custom dient zur Verwaltung benutzerdefinierter Eigenschaften der PowerPoint‑Dateien.
Zugriff auf eingebaute Eigenschaften
Die von dem IDocumentProperties‑Objekt bereitgestellten Eigenschaften umfassen: Creator(Author), Description, KeyWords, Created (Erstellungsdatum), Modified (Änderungsdatum), Printed (Letztes Druckdatum), LastModifiedBy, Keywords, SharedDoc (Wird zwischen verschiedenen Produzenten geteilt?), PresentationFormat, Subject und Title.
Eingebaute Eigenschaften ändern
Das Ändern der eingebauten Eigenschaften von Präsentationsdateien ist genauso einfach wie ihr Zugriff. Sie können einfach einem gewünschten Property einen Zeichenkettenwert zuweisen und der Wert wird geändert. Im nachfolgenden Beispiel zeigen wir, wie man die eingebauten Dokumenteneigenschaften einer Präsentationsdatei ändern kann.
Benutzerdefinierte Präsentationseigenschaften hinzufügen
Aspose.Slides für C++ ermöglicht Entwicklern zudem das Hinzufügen benutzerdefinierter Werte zu den Dokumenteneigenschaften einer Präsentation. Das folgende Beispiel zeigt, wie benutzerdefinierte Eigenschaften für eine Präsentation gesetzt werden können.
// Instanziieren der Presentation-Klasse
auto presentation = System::MakeObject<Presentation>();
// Abrufen der Dokumenteigenschaften
auto documentProperties = presentation->get_DocumentProperties();
// Hinzufügen benutzerdefinierter Eigenschaften
documentProperties->idx_set(u"New Custom", ObjectExt::Box<int32_t>(12));
documentProperties->idx_set(u"My Name", ObjectExt::Box<String>(u"Mudassir"));
documentProperties->idx_set(u"Custom", ObjectExt::Box<int32_t>(124));
// Abrufen des Eigenschaftsnamens an einem bestimmten Index
String getPropertyName = documentProperties->GetCustomPropertyName(2);
// Entfernen der ausgewählten Eigenschaft
documentProperties->RemoveCustomProperty(getPropertyName);
// Präsentation speichern
presentation->Save(u"CustomDocumentProperties_out.pptx", SaveFormat::Pptx);
Benutzerdefinierte Eigenschaften anzeigen und ändern
Aspose.Slides für C++ erlaubt Entwicklern außerdem das Auslesen und Ändern benutzerdefinierter Eigenschaften. Das nachstehende Beispiel demonstriert, wie Sie alle benutzerdefinierten Eigenschaften einer Präsentation abrufen und ändern können.
Korrektursprache festlegen
Aspose.Slides stellt die Eigenschaft LanguageId (exponiert durch die Klasse PortionFormat) bereit, mit der Sie die Korrektursprache für ein PowerPoint‑Dokument festlegen können. Die Korrektursprache ist die Sprache, für die Rechtschreibung und Grammatik im PowerPoint geprüft werden.
Der folgende C++‑Code zeigt, wie Sie die Korrektursprache für ein PowerPoint‑Dokument setzen:
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(pptxFileName);
System::SharedPtr<AutoShape> autoShape = System::ExplicitCast<AutoShape>(pres->get_Slide(0)->get_Shape(0));
System::SharedPtr<IParagraph> paragraph = autoShape->get_TextFrame()->get_Paragraph(0);
System::SharedPtr<IPortionCollection> portions = paragraph->get_Portions();
portions->Clear();
System::SharedPtr<Portion> newPortion = System::MakeObject<Portion>();
System::SharedPtr<IFontData> font = System::MakeObject<FontData>(u"SimSun");
System::SharedPtr<IPortionFormat> portionFormat = newPortion->get_PortionFormat();
portionFormat->set_ComplexScriptFont(font);
portionFormat->set_EastAsianFont(font);
portionFormat->set_LatinFont(font);
portionFormat->set_LanguageId(u"zh-CN");
// set the Id of a proofing language
newPortion->set_Text(u"1。");
portions->Add(newPortion);
Standardsprache festlegen
Der folgende C++‑Code zeigt, wie Sie die Standardsprache für eine gesamte PowerPoint‑Präsentation festlegen:
System::SharedPtr<LoadOptions> loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_DefaultTextLanguage(u"en-US");
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(loadOptions);
// Fügt eine neue Rechteckform mit Text hinzu
System::SharedPtr<IAutoShape> shp = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 150.0f, 50.0f);
System::SharedPtr<ITextFrame> textFrame = shp->get_TextFrame();
textFrame->set_Text(u"New Text");
// Überprüft die Sprache des ersten Abschnitts
System::Console::WriteLine(textFrame->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->get_LanguageId());
Live‑Beispiel
Probieren Sie die Online‑App Aspose.Slides Metadata aus, um zu sehen, wie Sie mit Dokumenteneigenschaften über die Aspose.Slides‑API arbeiten können:
*FAQ
Wie kann ich eine eingebaute Eigenschaft aus einer Präsentation entfernen?
Eingebaute Eigenschaften sind integraler Bestandteil einer Präsentation und können nicht vollständig entfernt werden. Sie können jedoch deren Werte ändern oder, sofern die jeweilige Eigenschaft es zulässt, auf einen leeren Wert setzen.
Was passiert, wenn ich eine benutzerdefinierte Eigenschaft hinzufüge, die bereits existiert?
Wird eine bereits vorhandene benutzerdefinierte Eigenschaft hinzugefügt, wird ihr vorhandener Wert durch den neuen überschrieben. Ein vorheriges Entfernen oder Prüfen der Eigenschaft ist nicht erforderlich, da Aspose.Slides den Wert automatisch aktualisiert.
Kann ich Präsentationseigenschaften abrufen, ohne die gesamte Präsentation zu laden?
Ja. Sie können Präsentationseigenschaften abrufen, ohne die gesamte Präsentation zu laden, indem Sie die Methode GetPresentationInfo der Klasse PresentationFactory verwenden. Anschließend nutzen Sie die Methode ReadDocumentProperties des Interfaces IPresentationInfo, um die Eigenschaften effizient auszulesen, Speicher zu sparen und die Leistung zu verbessern.