Präsentationseigenschaften - Zugriff auf oder Änderung der PowerPoint-Präsentationseigenschaften in C#
Live-Beispiel
Versuchen Sie die Aspose.Slides Metadata Online-App, um zu sehen, wie man mit Dokumenteigenschaften über die Aspose.Slides-API arbeitet:
Über Präsentationseigenschaften
Wie bereits beschrieben, unterstützt Aspose.Slides für .NET zwei Arten von Dokumenteigenschaften, die Eingebaut und Benutzerdefiniert sind. Entwickler können beide Arten von Eigenschaften über die Aspose.Slides für .NET API abrufen. Aspose.Slides für .NET bietet eine Klasse IDocumentProperties, die die mit einer Präsentationsdatei verbundenen Dokumenteigenschaften über die Presentation.DocumentProperties Eigenschaft darstellt. Entwickler können die von Objekt Presentation bereitgestellte IDocumentProperties Eigenschaft verwenden, um auf die Dokumenteigenschaften der Präsentationsdateien wie unten beschrieben zuzugreifen:
Verwalten von Präsentationseigenschaften
Microsoft PowerPoint bietet eine Funktion zum Hinzufügen einiger Eigenschaften zu den Präsentationsdateien. Diese Dokumenteigenschaften ermöglichen es, nützliche Informationen zusammen mit den Dokumenten (Präsentationsdateien) zu speichern. Es gibt zwei Arten von Dokumenteigenschaften:
- Systemdefinierte (Eingebaut) Eigenschaften
- Benutzerdefinierte (Benutzerdefiniert) Eigenschaften
Eingebaut Eigenschaften enthalten allgemeine Informationen über das Dokument, wie Dokumenttitel, Autorname, Dokumentstatistik usw. Benutzerdefiniert Eigenschaften sind diejenigen, die von den Benutzern als Name/Wert-Paare definiert werden, wobei sowohl Name als auch Wert vom Benutzer definiert werden. Mit Aspose.Slides für .NET können Entwickler die Werte der eingebauten Eigenschaften sowie der benutzerdefinierten Eigenschaften abrufen und ändern. Microsoft PowerPoint 2007 ermöglicht das Verwalten der Dokumenteigenschaften der Präsentationsdateien. Alles, was Sie tun müssen, ist, auf das Office-Symbol zu klicken und dann den Menüeintrag Vorbereiten | Eigenschaften | Erweiterte Eigenschaften von Microsoft PowerPoint 2007 auszuwählen. Nachdem Sie den Menüeintrag Erweiterte Eigenschaften ausgewählt haben, erscheint ein Dialogfeld, das es Ihnen ermöglicht, die Dokumenteigenschaften der PowerPoint-Datei zu verwalten. Im Eigenschaften-Dialog können Sie sehen, dass es viele Registerkarten wie Allgemein, Zusammenfassung, Statistiken, Inhalte und Benutzerdefiniert gibt. Alle diese Registerkarten ermöglichen die Konfiguration verschiedener Arten von Informationen in Bezug auf die PowerPoint-Dateien. Die Registerkarte Benutzerdefiniert wird verwendet, um die benutzerdefinierten Eigenschaften der PowerPoint-Dateien zu verwalten.
Zugriff auf Eingebaute Eigenschaften
Diese Eigenschaften, wie sie vom Objekt IDocumentProperties bereitgestellt werden, umfassen: Ersteller(Autor), Beschreibung, Schlüsselwörter, Erstellt (Erstellungsdatum), Änderung (Änderungsdatum), Gedruckt (Letztes Druckdatum), LastModifiedBy, Schlüsselwörter, SharedDoc (Ist geteilt zwischen verschiedenen Produzenten?), Präsentationsformat, Betreff und Titel.
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir_PresentationProperties(); | |
// Instantiate the Presentation class that represents the presentation | |
Presentation pres = new Presentation(dataDir + "AccessBuiltin Properties.pptx"); | |
// Create a reference to IDocumentProperties object associated with Presentation | |
IDocumentProperties documentProperties = pres.DocumentProperties; | |
// Display the builtin properties | |
System.Console.WriteLine("Category : " + documentProperties.Category); | |
System.Console.WriteLine("Current Status : " + documentProperties.ContentStatus); | |
System.Console.WriteLine("Creation Date : " + documentProperties.CreatedTime); | |
System.Console.WriteLine("Author : " + documentProperties.Author); | |
System.Console.WriteLine("Description : " + documentProperties.Comments); | |
System.Console.WriteLine("KeyWords : " + documentProperties.Keywords); | |
System.Console.WriteLine("Last Modified By : " + documentProperties.LastSavedBy); | |
System.Console.WriteLine("Supervisor : " + documentProperties.Manager); | |
System.Console.WriteLine("Modified Date : " + documentProperties.LastSavedTime); | |
System.Console.WriteLine("Presentation Format : " + documentProperties.PresentationFormat); | |
System.Console.WriteLine("Last Print Date : " + documentProperties.LastPrinted); | |
System.Console.WriteLine("Is Shared between producers : " + documentProperties.SharedDoc); | |
System.Console.WriteLine("Subject : " + documentProperties.Subject); | |
System.Console.WriteLine("Title : " + documentProperties.Title); |
Ändern von Eingebauten Eigenschaften
Das Ändern der eingebauten Eigenschaften von Präsentationsdateien ist genauso einfach wie der Zugriff darauf. Sie können einfach einen Stringwert einer gewünschten Eigenschaft zuweisen und der Eigenschaftswert wird geändert. Im folgenden Beispiel haben wir gezeigt, wie wir die eingebauten Dokumenteigenschaften der Präsentationsdatei ändern können.
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir_PresentationProperties(); | |
// Instantiate the Presentation class that represents the Presentation | |
Presentation presentation = new Presentation(dataDir + "ModifyBuiltinProperties.pptx"); | |
// Create a reference to IDocumentProperties object associated with Presentation | |
IDocumentProperties documentProperties = presentation.DocumentProperties; | |
// Set the builtin properties | |
documentProperties.Author = "Aspose.Slides for .NET"; | |
documentProperties.Title = "Modifying Presentation Properties"; | |
documentProperties.Subject = "Aspose Subject"; | |
documentProperties.Comments = "Aspose Description"; | |
documentProperties.Manager = "Aspose Manager"; | |
// Save your presentation to a file | |
presentation.Save(dataDir + "DocumentProperties_out.pptx", SaveFormat.Pptx); |
Hinzufügen von Benutzerdefinierten Präsentationseigenschaften
Aspose.Slides für .NET ermöglicht es Entwicklern auch, die benutzerdefinierten Werte für die Dokumenteigenschaften der Präsentation hinzuzufügen. Ein Beispiel, das zeigt, wie man die benutzerdefinierten Eigenschaften für eine Präsentation festlegt, wird unten gegeben.
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir_PresentationProperties(); | |
// Instantiate the Presentation class | |
Presentation presentation = new Presentation(); | |
// Getting Document Properties | |
IDocumentProperties documentProperties = presentation.DocumentProperties; | |
// Adding Custom properties | |
documentProperties["New Custom"] = 12; | |
documentProperties["My Name"] = "Mudassir"; | |
documentProperties["Custom"] = 124; | |
// Getting property name at particular index | |
String getPropertyName = documentProperties.GetCustomPropertyName(2); | |
// Removing selected property | |
documentProperties.RemoveCustomProperty(getPropertyName); | |
// Saving presentation | |
presentation.Save(dataDir + "CustomDocumentProperties_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx); |
Zugriff auf und Ändern von Benutzerdefinierten Eigenschaften
Aspose.Slides für .NET ermöglicht es Entwicklern auch, auf die Werte der benutzerdefinierten Eigenschaften zuzugreifen. Ein Beispiel, das zeigt, wie Sie auf all diese benutzerdefinierten Eigenschaften für eine Präsentation zugreifen und sie ändern können, wird unten gegeben.
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir_PresentationProperties(); | |
// Instanciate the Presentation class that represents the PPTX | |
Presentation presentation = new Presentation(dataDir + "AccessModifyingProperties.pptx"); | |
// Create a reference to DocumentProperties object associated with Prsentation | |
IDocumentProperties documentProperties = presentation.DocumentProperties; | |
// Access and modify custom properties | |
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++) | |
{ | |
// Display names and values of custom properties | |
System.Console.WriteLine("Custom Property Name : " + documentProperties.GetCustomPropertyName(i)); | |
System.Console.WriteLine("Custom Property Value : " + documentProperties[documentProperties.GetCustomPropertyName(i)]); | |
// Modify values of custom properties | |
documentProperties[documentProperties.GetCustomPropertyName(i)] = "New Value " + (i + 1); | |
} | |
// Save your presentation to a file | |
presentation.Save(dataDir + "CustomDemoModified_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx); |
Überprüfen, ob die Präsentation geändert oder erstellt wurde
Aspose.Slides für .NET bietet die Möglichkeit zu überprüfen, ob eine Präsentation geändert oder erstellt wurde. Ein Beispiel, das zeigt, wie man überprüft, ob die Präsentation erstellt oder geändert wurde, wird unten gegeben.
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir_PresentationProperties(); | |
IPresentationInfo info = | |
PresentationFactory.Instance.GetPresentationInfo(Path.Combine(RootFolder, "props.pptx")); | |
IDocumentProperties props = info.ReadDocumentProperties(); | |
string app = props.NameOfApplication; | |
string ver = props.AppVersion; |
Standard-Sprache festlegen
Korrektur Sprache festlegen
Aspose.Slides bietet die LanguageId Eigenschaft (bereitgestellt durch die PortionFormat Klasse), um Ihnen zu ermöglichen, die Korrektursprache für ein PowerPoint-Dokument festzulegen. Die Korrektursprache ist die Sprache, für die Rechtschreib- und Grammatikprüfungen in PowerPoint durchgeführt werden.
Dieser C#-Code zeigt Ihnen, wie Sie die Korrektursprache für ein PowerPoint-Dokument festlegen:
using (Presentation pres = new Presentation(pptxFileName))
{
AutoShape autoShape = (AutoShape)pres.Slides[0].Shapes[0];
IParagraph paragraph = autoShape.TextFrame.Paragraphs[0];
paragraph.Portions.Clear();
Portion newPortion = new Portion();
IFontData font = new FontData("SimSun");
IPortionFormat portionFormat = newPortion.PortionFormat;
portionFormat.ComplexScriptFont = font;
portionFormat.EastAsianFont = font;
portionFormat.LatinFont = font;
portionFormat.LanguageId = "zh-CN"; // festlegen der Id einer Korrektursprache
newPortion.Text = "1。";
paragraph.Portions.Add(newPortion);
}
Standard-Sprache festlegen
Dieser C#-Code zeigt Ihnen, wie Sie die Standardsprache für eine gesamte PowerPoint-Präsentation festlegen:
LoadOptions loadOptions = new LoadOptions();
loadOptions.DefaultTextLanguage = "en-US";
using (Presentation pres = new Presentation(loadOptions))
{
// Fügt eine neue Rechteckform mit Text hinzu
IAutoShape shp = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
shp.TextFrame.Text = "Neuer Text";
// Überprüft die Sprache der ersten Portion
Console.WriteLine(shp.TextFrame.Paragraphs[0].Portions[0].PortionFormat.LanguageId);
}