Διαχείριση placeholders παρουσίασης σε C++
Επισκόπηση
Ένα placeholder είναι ένα σχήμα που κρατά μια θέση για ένα συγκεκριμένο είδος περιεχομένου σε ένα πρότυπο παρουσίασης. Συνηθισμένα παραδείγματα είναι οι χώροι κράτησης για τίτλο, κύριο κείμενο, εικόνα, γράφημα και γενικού σκοπού περιεχόμενο. Σε αντίθεση με ένα κανονικό σχήμα, ένα placeholder μπορεί να κληρονομήσει τη θέση, το μέγεθος, τη μορφοποίηση και άλλες ρυθμίσεις από μια διαφάνεια διάταξης ή μια κύρια διαφάνεια.
Aspose.Slides εκθέτει πληροφορίες placeholder μέσω της μεθόδου IShape::get_Placeholder. Η μέθοδος επιστρέφει ένα αντικείμενο IPlaceholder ή nullptr για ένα κανονικό σχήμα. Χρησιμοποιήστε το IPlaceholder::get_Type για να προσδιορίσετε τι προβλέπεται να περιέχει το placeholder.
Η διεπαφή σχήματος παραμένει σημαντική αφού γνωρίζετε τον τύπο του placeholder:
- Ένα κενό placeholder κειμένου, εικόνας, γραφήματος ή περιεχομένου αντιπροσωπεύεται συνήθως από ένα IAutoShape.
- Ένα γεμάτο placeholder εικόνας μπορεί να αντιπροσωπεύεται από ένα IPictureFrame.
- Ένα γεμάτο placeholder γραφήματος μπορεί να αντιπροσωπεύεται από ένα IChart.
- Ένα placeholder περιεχομένου μπορεί να περιέχει διάφορα είδη περιεχομένου. Ελέγξτε τόσο το IPlaceholder::get_Type όσο και τη διεπαφή σχήματος χρόνου εκτέλεσης αντί να υποθέτετε ότι κάθε placeholder είναι ένα IAutoShape.
Warning
IPlaceholder::get_Type περιγράφει το ρόλο ενός placeholder· δεν εγγυάται τον τύπο σχήματος χρόνου εκτέλεσης. Πάντα να κάνετε έλεγχο τύπου πριν αποκτήσετε πρόσβαση σε κείμενο, εικόνα, γράφημα, πίνακα ή ειδικά μέλη πολυμέσων.Κατανόηση Κληρονόμησης Placeholder
Τα placeholders σχηματίζουν μια ιεραρχία:
- Μια κύρια διαφάνεια ορίζει επαναχρησιμοποιούμενα στυλ και, σε ορισμένες περιπτώσεις, placeholders επιπέδου master.
- Μια διαφάνεια διάταξης ορίζει τη διάταξη που χρησιμοποιείται από μία ή περισσότερες κανονικές διαφάνειες και μπορεί να κληρονομήσει από το master.
- Μια κανονική διαφάνεια περιέχει τα placeholders για εκείνη τη διαφάνεια και μπορεί να κληρονομήσει από τη διάταξή της.
Καλέστε το IShape::GetBasePlaceholder για να ανεβείτε ένα επίπεδο στην ιεραρχία. Ένα placeholder διαφάνειας συνήθως επιστρέφει το placeholder της διάταξής του· ένα placeholder διάταξης μπορεί να επιστρέψει το placeholder του master. Η μέθοδος επιστρέφει nullptr όταν το σχήμα δεν έχει βασικό placeholder.
Το παρακάτω παράδειγμα καταγράφει τα placeholders στην πρώτη διαφάνεια και αναφέρει τα βασικά τους placeholders:
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <system/type_info.h>
using namespace Aspose::Slides;
using namespace System;
auto presentation = MakeObject<Presentation>(u"template.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : slide->get_Shapes())
{
auto placeholder = shape->get_Placeholder();
if (placeholder == nullptr)
{
continue;
}
auto placeholderType = placeholder->get_Type();
auto typeName = shape->GetType().get_Name();
Console::WriteLine(u"Slide placeholder: {0}; shape interface: {1}", placeholderType, typeName);
auto layoutPlaceholder = shape->GetBasePlaceholder();
if (layoutPlaceholder != nullptr)
{
auto layoutPlaceholderInfo = layoutPlaceholder->get_Placeholder();
if (layoutPlaceholderInfo != nullptr)
{
auto layoutPlaceholderType = layoutPlaceholderInfo->get_Type();
Console::WriteLine(u" Layout placeholder: {0}", layoutPlaceholderType);
}
auto masterPlaceholder = layoutPlaceholder->GetBasePlaceholder();
if (masterPlaceholder != nullptr)
{
auto masterPlaceholderInfo = masterPlaceholder->get_Placeholder();
if (masterPlaceholderInfo != nullptr)
{
auto masterPlaceholderType = masterPlaceholderInfo->get_Type();
Console::WriteLine(u" Master placeholder: {0}", masterPlaceholderType);
}
}
}
}
Η επεξεργασία ενός placeholder σε μια κανονική διαφάνεια δημιουργεί ή αλλάζει μια τοπική παράκαμψη για εκείνη τη διαφάνεια. Η επεξεργασία της σχετικής διάταξης ή του master μπορεί να επηρεάσει όλες τις διαφάνειες που εξακολουθούν να κληρονομούν αυτή τη ρύθμιση. Ένα τοπικό κανονικό σχήμα δεν έχει βασικό placeholder και δεν αρχίζει να κληρονομεί απλώς επειδή καταλαμβάνει τις ίδιες συντεταγμένες.
Αφαίρεση Κατάστασης Placeholder
Κατά την προσαρμογή ενός προτύπου, χρησιμοποιήστε το IShape::RemovePlaceholder για να διατηρήσετε ένα υπάρχον αντικείμενο ως κανονικό σχήμα. Η μέθοδος IShape::get_Placeholder του επιστρέφει nullptr, αλλά το σχήμα παραμένει στη συλλογή της διαφάνειας. Αντιθέτως, το IShapeCollection::Remove διαγράφει το σχήμα από αυτή τη συλλογή.
Το παρακάτω παράδειγμα απαιτεί το template.pptx με τουλάχιστον μία διαφάνεια και ένα μη κενό placeholder κειμένου στην πρώτη διαφάνεια. Χρησιμοποιήστε ένα placeholder με μορφοποίηση κληρονομημένη από τη διάταξη ή το master για να δείτε το αποτέλεσμα της αφαίρεσης αυτής της σχέσης. Το παράδειγμα ελέγχει ότι το ίδιο σχήμα παραμένει, καλεί τη μέθοδο ξανά στο πλέον κανονικό σχήμα και αποθηκεύει το αποτέλεσμα.
Warning
Η αφαίρεση της κατάστασης placeholder δεν διατηρεί αυτόματα τις κληρονομημένες ρυθμίσεις εμφάνισης. Το παρακάτω παράδειγμα αφήνει σκόπιμα αυτές τις ρυθμίσεις αμετάβλητες, επομένως η έξοδος μπορεί να φαίνεται διαφορετική. Ένα σχήμα του οποίου η θέση και το μέγεθος είναι εξ ολοκλήρου κληρονομημένα μπορεί να έχει μηδενικές συντεταγμένες και διαστάσεις μετά την κλήση και να καταστεί αόρατο, παρόλο που παραμένει στη συλλογή.#include <DOM/IAutoShape.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/string.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"template.pptx");
auto slide = presentation->get_Slide(0);
auto found = false;
for (auto index = 0; index < slide->get_Shapes()->get_Count(); index++)
{
auto currentShape = slide->get_Shape(index);
if (!ObjectExt::Is<IAutoShape>(currentShape))
{
continue;
}
auto shape = ExplicitCast<IAutoShape>(currentShape);
auto textFrame = shape->get_TextFrame();
if (shape->get_Placeholder() == nullptr ||
textFrame == nullptr ||
String::IsNullOrEmpty(textFrame->get_Text()))
{
continue;
}
auto shapeCount = slide->get_Shapes()->get_Count();
shape->RemovePlaceholder();
Console::WriteLine(u"Placeholder removed: {0}", shape->get_Placeholder() == nullptr);
Console::WriteLine(u"Same shape retained: {0}", slide->get_Shape(index) == currentShape);
Console::WriteLine(u"Shape count unchanged: {0}", slide->get_Shapes()->get_Count() == shapeCount);
// Η κλήση της μεθόδου σε ένα κανονικό σχήμα δεν έχει αποτέλεσμα.
shape->RemovePlaceholder();
found = true;
break;
}
if (found)
{
presentation->Save(u"placeholder-status-removed.pptx", SaveFormat::Pptx);
}
else
{
Console::WriteLine(u"No nonempty text placeholder was found on the first slide.");
}
Για ένα αντιστοιχούν placeholder, και οι τρεις έλεγχοι εκτυπώνουν True. Το κείμενο παραμένει, αλλά η κληρονομημένη θέση, το μέγεθος, η περιστροφή, η γραμματοσειρά, η στοίχιση παραγράφων, τα περιθώρια του πλαισίου κειμένου, η κάθετη αγκύρωση, η γέμιση και οι ρυθμίσεις γραμμής μπορεί να αλλάξουν όταν αφαιρεθεί η σχέση placeholder. Για παράδειγμα, η κληρονομημένη μορφοποίηση τίτλου μπορεί να επανέλθει σε απλή μορφοποίηση κειμένου. Δείτε το Slide Layout για περισσότερα σχετικά με τις διατάξεις.
Για να διατηρήσετε την προγραμματισμένη εμφάνιση, καταγράψτε τη διασ resolved θέση, μέγεθος και περιστροφή πριν την κλήση και αντιγράψτε τις απαιτούμενες αποδοτικές τιμές μορφοποίησης σε ξεχωριστές μεταβλητές. Ανακτήστε αυτές τις τιμές μέσω των IPortionFormat::GetEffective, IParagraphFormat::GetEffective, ITextFrameFormat::GetEffective, IFillFormat::GetEffective, και ILineFormat::GetEffective. Μην βασίζεστε μόνο στα αντικείμενα αποδοτικής μορφοποίησης, επειδή οι τιμές μορφοποίησης κειμένου τους μπορούν να αλλάξουν μετά την αφαίρεση της σχέσης. Εφαρμόστε ρητά τις καταγραφείσες τιμές στο κανονικό σχήμα μετά, συμπεριλαμβανομένων της οικογένειας γραμματοσειράς, μεγέθους, στυλ, χρώματος, ρυθμίσεων παραγράφου, ρυθμίσεων πλαισίου κειμένου, γεμίσματος και γραμμής που χρησιμοποιεί το πρότυπό σας.
Η κληρονομημένη γεωμετρία σχήματος μπορεί επίσης να χρειαστεί να οριστεί ρητά μέσω του IGeometryShape::set_ShapeType. Για ένα ορθογώνιο placeholder κειμένου, αυτό σημαίνει την ανάθεση του ShapeType::Rectangle; η επαναφορά μόνο του γεμίσματος και της γραμμής ενδέχεται να μην επαναφέρει το ορατό ορθογώνιο. Τα πρότυπα με πρόσθετα εφέ ή πιο πολύπλοκη μορφοποίηση απαιτούν επίσης τη διαχείριση αυτών των ρυθμίσεων.
Αλλαγή Κειμένου σε Placeholder
Οι placeholders τίτλου, κεντρακού τίτλου, υποτίτλου, σώματος και κειμένου υποστηρίζουν κανονικά κείμενο. Ελέγξτε για IAutoShape πριν χρησιμοποιήσετε τη μέθοδο get_TextFrame.
Αυτό το παράδειγμα ενημερώνει το πρώτο placeholder τίτλου στην πρώτη διαφάνεια και αποθηκεύει το αποτέλεσμα:
#include <DOM/IAutoShape.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/exceptions.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"template.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IAutoShape> titleShape;
for (auto&& shape : slide->get_Shapes())
{
if (!ObjectExt::Is<IAutoShape>(shape))
{
continue;
}
auto autoShape = ExplicitCast<IAutoShape>(shape);
auto placeholder = autoShape->get_Placeholder();
if (placeholder == nullptr)
{
continue;
}
auto placeholderType = placeholder->get_Type();
if (placeholderType == PlaceholderType::Title || placeholderType == PlaceholderType::CenteredTitle)
{
titleShape = autoShape;
break;
}
}
if (titleShape == nullptr)
{
throw InvalidOperationException(u"The first slide does not contain a title placeholder.");
}
titleShape->get_TextFrame()->set_Text(u"Quarterly Business Review");
presentation->Save(u"title-placeholder-updated.pptx", SaveFormat::Pptx);
Αυτό το μοτίβο αποφεύγει την μετατροπή placeholder εικόνας, γραφήματος, πίνακα ή πολυμέσων σε IAutoShape. Επίσης ταυτοποιεί το placeholder με βάση τον σκοπό του αντί να βασίζεται σε ευαίσθητο δείκτη σχήματος.
Ορισμός Κειμένου Προτροπής σε Διάταξη
Το κείμενο προτροπής είναι η οδηγία σχεδίασης που εμφανίζεται σε ένα κενό placeholder, όπως Click to add title. Ορίστε προσαρμοσμένο κείμενο προτροπής στο placeholder της διάταξης αντί να το προσπαθήσετε να το προσεγγίσετε μέσω της συλλογής σχήματος μιας κανονικής διαφάνειας. Πρόσβαση στη διάταξη μέσω του ISlide::get_LayoutSlide και επανάληψη πάνω στο IBaseSlide::get_Shapes.
Το παρακάτω παράδειγμα αλλάζει τις προτροπές τίτλου και υποτίτλου στη διάταξη που χρησιμοποιείται από την πρώτη διαφάνεια:
#include <DOM/IAutoShape.h>
#include <DOM/ILayoutSlide.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"template.pptx");
auto layoutSlide = presentation->get_Slide(0)->get_LayoutSlide();
for (auto&& shape : layoutSlide->get_Shapes())
{
if (!ObjectExt::Is<IAutoShape>(shape))
{
continue;
}
auto autoShape = ExplicitCast<IAutoShape>(shape);
auto placeholder = autoShape->get_Placeholder();
if (placeholder == nullptr)
{
continue;
}
switch (placeholder->get_Type())
{
case PlaceholderType::Title:
case PlaceholderType::CenteredTitle:
autoShape->get_TextFrame()->set_Text(u"Enter a concise slide title");
break;
case PlaceholderType::Subtitle:
autoShape->get_TextFrame()->set_Text(u"Enter a subtitle or reporting period");
break;
default:
break;
}
}
presentation->Save(u"custom-placeholder-prompts.pptx", SaveFormat::Pptx);
Το κείμενο προτροπής δεν είναι κανονικό περιεχόμενο διαφάνειας. Απευθύνεται σε κενά placeholders σε εφαρμογές επεξεργασίας όπως το PowerPoint. Μόλις ένας χρήστης ή πρόγραμμα παρέχει πραγματικό περιεχόμενο, η προτροπή δεν εμφανίζεται πλέον. Η αλλαγή μιας προτροπής δεν αντικαθιστά επίσης το υπάρχον κείμενο στις διαφάνειες που χρησιμοποιούν τη διάταξη.
Ενημέρωση Placeholder Εικόνας
Υπάρχουν δύο περιπτώσεις προς διαχείριση:
- Εάν το placeholder εικόνας είναι ήδη γεμάτο και αντιπροσωπεύεται από ένα IPictureFrame, αντικαταστήστε την εικόνα μέσω του IPictureFillFormat::get_Picture και του ISlidesPicture::set_Image.
- Εάν είναι ακόμη κενό placeholder, προσθέστε ένα πλαίσιο εικόνας στις συντεταγμένες του placeholder με το IShapeCollection::AddPictureFrame και αφαιρέστε το κενό placeholder.
Το επόμενο παράδειγμα υποστηρίζει και τις δύο περιπτώσεις και αποθηκεύει την παρουσίαση:
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <Export/SaveFormat.h>
#include <system/exceptions.h>
#include <system/io/file.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"picture-template.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IShape> picturePlaceholder;
for (auto&& shape : slide->get_Shapes())
{
auto placeholder = shape->get_Placeholder();
if (placeholder != nullptr && placeholder->get_Type() == PlaceholderType::Picture)
{
picturePlaceholder = shape;
break;
}
}
if (picturePlaceholder == nullptr)
{
throw InvalidOperationException(u"The first slide does not contain a picture placeholder.");
}
auto imageBytes = File::ReadAllBytes(u"replacement.png");
auto image = presentation->get_Images()->AddImage(imageBytes);
if (ObjectExt::Is<IPictureFrame>(picturePlaceholder))
{
auto pictureFrame = ExplicitCast<IPictureFrame>(picturePlaceholder);
pictureFrame->get_PictureFormat()->get_Picture()->set_Image(image);
}
else
{
auto x = picturePlaceholder->get_X();
auto y = picturePlaceholder->get_Y();
auto width = picturePlaceholder->get_Width();
auto height = picturePlaceholder->get_Height();
auto shapes = slide->get_Shapes();
shapes->AddPictureFrame(ShapeType::Rectangle, x, y, width, height, image);
shapes->Remove(picturePlaceholder);
}
presentation->Save(u"picture-placeholder-updated.pptx", SaveFormat::Pptx);
Η αντικατάσταση που δημιουργείται για ένα κενό placeholder είναι ένα τοπικό πλαίσιο εικόνας, όχι ένα νέο placeholder, επειδή το IShape::get_Placeholder είναι μόνο για ανάγνωση. Διατηρεί τη διατηρημένη θέση αλλά δεν κληρονομεί πλέον τη συμπεριφορά ειδική του placeholder. Εάν είναι απαραίτητη η διατήρηση της σχέσης placeholder, προετοιμάστε και γεμίστε το placeholder στο PowerPoint πρώτα, έπειτα ενημερώστε το προκύπτον IPictureFrame με το Aspose.Slides.
Για διαφάνεια εικόνας, περικοπή και άλλα εφέ ειδικά για εικόνες, δείτε το Manage Picture Frames. Αυτές οι λειτουργίες αφορούν το πλαίσιο εικόνας ή το γέμισμα εικόνας, όχι τα μεταδεδομένα του placeholder.
Εργασία με Placeholder Γραφήματος και Περιεχομένου
Ένα γεμάτο placeholder γραφήματος μπορεί να αντιπροσωπεύεται από ένα IChart. Αυτό το παράδειγμα εντοπίζει ένα τέτοιο γράφημα με βάση τόσο τον τύπο του placeholder όσο και τη διεπαφή χρόνου εκτέλεσης, αλλάζει τον τίτλο του και αποθηκεύει το αρχείο:
#include <DOM/IChart.h>
#include <DOM/Chart/IChartTitle.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/exceptions.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Charts;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"chart-template.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IChart> placeholderChart;
for (auto&& shape : slide->get_Shapes())
{
if (!ObjectExt::Is<IChart>(shape))
{
continue;
}
auto chart = ExplicitCast<IChart>(shape);
auto placeholder = chart->get_Placeholder();
if (placeholder != nullptr && placeholder->get_Type() == PlaceholderType::Chart)
{
placeholderChart = chart;
break;
}
}
if (placeholderChart == nullptr)
{
throw InvalidOperationException(u"The first slide does not contain a populated chart placeholder.");
}
placeholderChart->set_HasTitle(true);
placeholderChart->get_ChartTitle()->AddTextFrameForOverriding(u"Quarterly Revenue");
presentation->Save(u"chart-placeholder-updated.pptx", SaveFormat::Pptx);
Ένα γενικό placeholder περιεχομένου έχει συνήθως τον PlaceholderType::Object. Στο PowerPoint λειτουργεί ως εκκινητής για πολλαπλούς τύπους περιεχομένου, όπως γραφήματα, πίνακες, διαγράμματα, εικόνες και πολυμέσα. Αφού γεμίσει, ελέγξτε την πραγματική διεπαφή σχήματος για να μάθετε τι περιέχει. Εξειδικευμένες διατάξεις μπορούν επίσης να εκθέτουν τα PlaceholderType::Chart, PlaceholderType::Table, PlaceholderType::Picture, PlaceholderType::Media, ή PlaceholderType::Diagram.
Το Aspose.Slides δεν μετατρέπει ένα κενό placeholder IAutoShape σε IChart απλώς αλλάζοντας το IPlaceholder::get_Type; ο τύπος είναι μόνο για ανάγνωση. Για να γεμίσετε ένα κενό γράφημα ή περιοχή περιεχομένου προγραμματιστικά, προσθέστε το απαιτούμενο αντικείμενο στις συντεταγμένες του placeholder και, στη συνέχεια, αφαιρέστε το κενό placeholder. Το παρακάτω παράδειγμα το κάνει για ένα γράφημα:
#include <DOM/Chart/ChartType.h>
#include <DOM/IChart.h>
#include <DOM/Chart/IChartTitle.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/exceptions.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Charts;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"content-template.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IShape> targetPlaceholder;
for (auto&& shape : slide->get_Shapes())
{
auto placeholder = shape->get_Placeholder();
if (placeholder == nullptr)
{
continue;
}
auto placeholderType = placeholder->get_Type();
if (placeholderType == PlaceholderType::Chart || placeholderType == PlaceholderType::Object)
{
targetPlaceholder = shape;
break;
}
}
if (targetPlaceholder == nullptr)
{
throw InvalidOperationException(u"The first slide does not contain a chart or content placeholder.");
}
auto x = targetPlaceholder->get_X();
auto y = targetPlaceholder->get_Y();
auto width = targetPlaceholder->get_Width();
auto height = targetPlaceholder->get_Height();
auto shapes = slide->get_Shapes();
auto chart = shapes->AddChart(ChartType::ClusteredColumn, x, y, width, height);
chart->set_HasTitle(true);
chart->get_ChartTitle()->AddTextFrameForOverriding(u"Quarterly Revenue");
shapes->Remove(targetPlaceholder);
presentation->Save(u"content-placeholder-replaced-with-chart.pptx", SaveFormat::Pptx);
Το προστιθέμενο γράφημα είναι ένα κανονικό τοπικό γράφημα. Καταλαμβάνει την περιοχή του placeholder αλλά δεν κληρονομεί από το placeholder της διάταξης. Χρησιμοποιήστε τα ειδικά άρθρα διαχείρισης γραφημάτων chart management articles όταν χρειάζεται να αντικαταστήσετε τις κατηγορίες, σειρές ή τα δεδομένα του φύλλου εργασίας.
Πλήρες Παράδειγμα: Ενημέρωση Κειμένου ή Εικόνας Περιεχομένου
Το παρακάτω παράδειγμα από άκρο σε άκρο ανοίγει ένα πρότυπο, ψάχνει την πρώτη διαφάνεια για είτε placeholder τίτλου είτε εικόνας, ελέγχει τους τύπους placeholder και σχήματος, ενημερώνει το κατάλληλο περιεχόμενο και αποθηκεύει το αποτέλεσμα. Το παράδειγμα αποφεύγει σκόπιμα την υπόθεση δείκτη σχήματος ή τη μετατροπή κάθε placeholder στην ίδια διεπαφή.
#include <DOM/IAutoShape.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IPlaceholder.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/ITextFrame.h>
#include <DOM/PlaceholderType.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <Export/SaveFormat.h>
#include <system/exceptions.h>
#include <system/io/file.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"template.pptx");
auto slide = presentation->get_Slide(0);
auto updated = false;
for (auto&& shape : slide->get_Shapes())
{
auto placeholder = shape->get_Placeholder();
if (placeholder == nullptr)
{
continue;
}
auto placeholderType = placeholder->get_Type();
if ((placeholderType == PlaceholderType::Title || placeholderType == PlaceholderType::CenteredTitle) && ObjectExt::Is<IAutoShape>(shape))
{
auto titleShape = ExplicitCast<IAutoShape>(shape);
titleShape->get_TextFrame()->set_Text(u"Quarterly Business Review");
updated = true;
break;
}
if (placeholderType == PlaceholderType::Picture)
{
auto imageBytes = File::ReadAllBytes(u"replacement.png");
auto image = presentation->get_Images()->AddImage(imageBytes);
if (ObjectExt::Is<IPictureFrame>(shape))
{
auto pictureFrame = ExplicitCast<IPictureFrame>(shape);
pictureFrame->get_PictureFormat()->get_Picture()->set_Image(image);
}
else
{
auto x = shape->get_X();
auto y = shape->get_Y();
auto width = shape->get_Width();
auto height = shape->get_Height();
auto shapes = slide->get_Shapes();
shapes->AddPictureFrame(ShapeType::Rectangle, x, y, width, height, image);
shapes->Remove(shape);
}
updated = true;
break;
}
}
if (!updated)
{
throw InvalidOperationException(u"No supported title or picture placeholder was found on the first slide.");
}
presentation->Save(u"placeholder-content-updated.pptx", SaveFormat::Pptx);
Συχνές Ερωτήσεις
Τι είναι ένα βασικό placeholder;
Ένα βασικό placeholder είναι το αντίστοιχο σχήμα στη διάταξη ή το master από το οποίο κληρονομεί ένα άλλο placeholder. Χρησιμοποιήστε το IShape::GetBasePlaceholder για να το ανακτήσετε. Ένα κανονικό τοπικό σχήμα επιστρέφει nullptr επειδή δεν αποτελεί μέρος της ιεραρχίας placeholder.
Μπορώ να αλλάξω όλους τους τίτλους διαφάνειας επεξεργάζοντας ένα placeholder διάταξης;
Μπορείτε να αλλάξετε τη κληρονομημένη μορφοποίηση ή το κείμενο προτροπής μέσω μιας διάταξης, αλλά το υπάρχον περιεχόμενο τίτλου αποθηκεύεται στις κανονικές διαφάνειες. Για να αντικαταστήσετε το πραγματικό κείμενο τίτλου σε ολόκληρη την παρουσίαση, επαναλάβετε τις διαφάνειες και ενημερώστε κάθε placeholder τίτλου.
Πώς διαχειρίζομαι placeholders ημερομηνίας, αριθμού διαφάνειας, κεφαλίδας και υποσέλιδου;
Χρησιμοποιήστε τους διαχειριστές κεφαλίδας και υποσέλιδου στο κατάλληλο επίπεδο (διαφάνεια, διάταξη, master, σημειώσεις ή φυλλάδιο). Δείτε τη σελίδα Manage Presentation Header and Footer για ολοκληρωμένα παραδείγματα.