Low-Code-presentationoperationer i C++
Översikt
Namnområdet Aspose::Slides::LowCode tillhandahåller statiska hjälparklasser för vanliga presentationsoperationer. Dessa hjälparklasser kapslar in ofta använda objektmodellarbetsflöden i fokuserade metoder, så att du kan konvertera eller slå ihop filer, bearbeta presentationselement, samla former och ta bort oanvänt innehåll med mindre kod.
Low-code‑hjälparna är mest användbara när operationen gäller en hel fil eller presentation och standardarbetsflödet matchar dina krav. Använd den fullständiga Aspose.Slides object model när du behöver finmaskig kontroll över enskilda bilder, masterbilder, layouter, former, exportinställningar eller relationer mellan presentationselement.
Tabellen nedan summerar de tillgängliga hjälparna:
| Helper | Use it for |
|---|---|
| Convert | Konvertera en presentation till ett annat format med ett direkt fil‑till‑fil‑anrop. |
| Merger | Kombinera kompletta presentationsfiler av samma format. |
| ForEach | Köra en åtgärd för varje bild, form, stycke eller textrad. |
| Collect | Hämta former från hela presentationen för upprepad behandling eller analys. |
| Compress | Ta bort oanvända masterbilder och layouter samt minska inbäddade teckensnittsdata. |
Konvertera en presentation
Använd Convert::AutoByExtension när filändelsen på utdata är tillräcklig för att välja exportformat. Metoden öppnar källpresentationen, bestämmer det erforderliga formatet från utdata‑sökvägen och skriver resultatet.
#include <LowCode/Convert.h>
using namespace Aspose::Slides::LowCode;
Convert::AutoByExtension(u"input.pptx", u"output.pdf");
[Convert]-klassen erbjuder också dedikerade metoder för PDF-, SVG-, JPEG-, PNG- och TIFF‑utdata. Använd den fullständiga objektmodellen när du behöver granska eller ändra presentationen före export eller konfigurera ett exportalternativ som inte exponeras av den valda hjälparen. Se Convert Presentation för format‑specifika arbetsflöden och alternativ.
Slå ihop presentationer
Använd Merger::Process för att kombinera kompletta presentationsfiler med ett anrop. Indataversionerna måste ha samma filformat.
#include <LowCode/Merger.h>
#include <system/array.h>
#include <system/string.h>
using namespace Aspose::Slides::LowCode;
auto inputFiles = System::MakeArray<System::String>({u"part-1.pptx", u"part-2.pptx"});
Merger::Process(inputFiles, u"merged.pptx");
Hjälparen är lämplig när alla bilder ska läggas till i ett resultat utan att välja eller ommappa dem individuellt. Använd den fullständiga objektmodellen när du behöver slå ihop utvalda bilder, tillämpa en mål‑master eller layout, bevara sektioner explicit eller harmonisera olika bildstorlekar. Se Merge Presentations för dessa scenarier.
Iterera genom presentationselement
[ForEach]-klassen anropar en återuppringning för varje begärd typ av presentationselement. Den undviker nästlade samlingsloopar och är bekväm för presentationsomfattande inspektion eller formateringsändringar.
Följande exempel använder ForEach::Slide, ForEach::Shape, ForEach::Paragraph och ForEach::Portion för att inspektera motsvarande element:
#include <DOM/BaseSlide.h>
#include <DOM/Paragraph.h>
#include <DOM/Portion.h>
#include <DOM/Presentation.h>
#include <DOM/Shape.h>
#include <DOM/Slide.h>
#include <LowCode/ForEach.h>
#include <system/console.h>
#include <system/shared_ptr.h>
#include <functional>
using namespace Aspose::Slides;
using namespace Aspose::Slides::LowCode;
auto presentation = System::MakeObject<Presentation>(u"input.pptx");
auto slideCallback = std::function<void(System::SharedPtr<Slide>, int32_t)>([](System::SharedPtr<Slide> slide, int32_t index)
{
System::Console::WriteLine(u"Slide {0}: {1} shapes", index, slide->get_Shapes()->get_Count());
});
ForEach::Slide(presentation, slideCallback);
auto shapeCallback = std::function<void(System::SharedPtr<Shape>, System::SharedPtr<BaseSlide>, int32_t)>([](System::SharedPtr<Shape> shape, System::SharedPtr<BaseSlide> slide, int32_t index)
{
System::Console::WriteLine(u"Shape {0}: {1}", index, shape->get_Name());
});
ForEach::Shape(presentation, shapeCallback);
auto paragraphCallback = std::function<void(System::SharedPtr<Paragraph>, System::SharedPtr<BaseSlide>, int32_t)>([](System::SharedPtr<Paragraph> paragraph, System::SharedPtr<BaseSlide> slide, int32_t index)
{
System::Console::WriteLine(u"Paragraph {0}: {1}", index, paragraph->get_Text());
});
ForEach::Paragraph(presentation, paragraphCallback);
auto portionCallback = std::function<void(System::SharedPtr<Portion>, System::SharedPtr<Paragraph>, System::SharedPtr<BaseSlide>, int32_t)>([](System::SharedPtr<Portion> portion, System::SharedPtr<Paragraph> paragraph, System::SharedPtr<BaseSlide> slide, int32_t index)
{
System::Console::WriteLine(u"Portion {0}: {1}", index, portion->get_Text());
});
ForEach::Portion(presentation, portionCallback);
Som standard inkluderar presentationsomfattande form‑ och texttraversering vanliga, master‑ och layoutbilder. Överlagringar med ett includeNotes‑parameter kan också bearbeta notisbilder. Använd direkta samlingsloopar när traverseringsordning, tidig avbrytning, filtrering före återuppringning eller detaljerad förälder‑barn‑kontroll är viktig.
Samla former
Använd Collect::Shapes när du behöver en samling av alla former i en presentation snarare än en återuppringning för varje form. Detta är användbart när samma uppsättning ska filtreras, räknas eller bearbetas flera gånger.
#include <DOM/Presentation.h>
#include <DOM/Shape.h>
#include <LowCode/Collect.h>
#include <system/console.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::LowCode;
auto presentation = System::MakeObject<Presentation>(u"input.pptx");
auto shapes = Collect::Shapes(presentation);
for (const auto& shape : shapes)
{
System::Console::WriteLine(shape->get_Name());
}
Använd ForEach::Shape istället när varje form kan hanteras omedelbart och du inte behöver behålla det insamlade resultatet.
Komprimera presentationsinnehåll
[Compress]-klassen kan ta bort oanvända strukturella element och minska inbäddade teckensnittsdata:
- Compress::RemoveUnusedLayoutSlides tar bort layoutbilder som ingen vanlig bild refererar till.
- Compress::RemoveUnusedMasterSlides tar bort masterbilder som inte längre används.
- Compress::CompressEmbeddedFonts tar bort oanvända tecken från inbäddade teckensnitt.
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <LowCode/Compress.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::LowCode;
auto presentation = System::MakeObject<Presentation>(u"input.pptx");
Compress::RemoveUnusedLayoutSlides(presentation);
Compress::RemoveUnusedMasterSlides(presentation);
Compress::CompressEmbeddedFonts(presentation);
presentation->Save(u"compressed.pptx", SaveFormat::Pptx);
Ta bort oanvända layouter innan oanvända masterbilder så att en master som blir orefererad efter layoutrensning också kan tas bort. Spara den optimerade presentationen i en ny fil om du kan behöva de ursprungliga masterbilderna, layouterna eller komplett inbäddad teckensnittsdata senare. För mer detaljer, se Slide Master och Embedded Font.
Vanliga frågor
När bör jag använda low-code‑API:t istället för den fullständiga objektmodellen?
Använd low-code‑hjälparna när en standardoperation gäller en hel fil eller presentation och inte kräver detaljerad kontroll över enskilda element. Använd den fullständiga objektmodellen när du behöver välja specifika bilder, kontrollera master‑ och layoutrelationer, inspektera mellanliggande tillstånd eller konfigurera beteende som hjälparen inte exponerar.
Kan Merger kombinera presentationer i olika filformat?
Nej. [Merger::Process] kräver att inmatningspresentationerna har samma format. Konvertera inmatningsfilerna till ett gemensamt format först, till exempel med [Convert::AutoByExtension], och slå sedan ihop de konverterade filerna.
Bearbetar ForEach master-, layout- och notisbilder?
[ForEach::Slide] itererar genom vanliga presentationsbilder. Presentationsomfattande [ForEach::Shape], [ForEach::Paragraph] och [ForEach::Portion]-operationer inkluderar vanliga, master‑ och layoutbilder som standard. Använd deras överlagringar med includeNotes satt till true för att inkludera notisbilder.
Vad är skillnaden mellan ForEach::Shape och Collect::Shapes?
Använd [ForEach::Shape] för att bearbeta varje form omedelbart via en återuppringning. Använd [Collect::Shapes] när du behöver ett enumererbart resultat som kan behållas, filtreras, räknas eller traverseras flera gånger.
Gör Compress alltid presentationsfilen mindre?
Inte nödvändigtvis. Resultatet beror på om presentationen innehåller oanvända layouter, oanvända masterbilder eller inbäddade teckensnitt med oanvända tecken. Om ingen av dessa finns kan de motsvarande [Compress]-operationerna eventuellt inte minska filens storlek.
Sparas ändringar som görs av ForEach eller Compress automatiskt?
Nej. Dessa hjälparprogram arbetar på det inlästa [Presentation]-objektet i minnet. Efter att ha ändrat element i en [ForEach]-återuppringning eller kört [Compress], anropa [Presentation::Save] för att skriva resultatet.