Hantera presentationsformer i PHP
Översikt
Denna artikel förklarar hur man arbetar med former i presentationer med Aspose.Slides. Den visar hur man hittar en form på en bild, klonar den, tar bort den, döljer den, ändrar dess ordning, hämtar dess Interop‑form‑ID och anger alternativ text för identifiering och vidare behandling.
Den behandlar också hur man får åtkomst till layoutformat för former, renderar en form som SVG, justerar former på en bild och använder vändningsegenskaper för horisontell och vertikal spegling. Dessutom innehåller artikeln en kort FAQ om kombination av former, staplingsordning och låsning av former.
Hitta en form på en bild
Detta ämne beskriver en enkel teknik för att underlätta för utvecklare att hitta en specifik form på en bild utan att använda dess interna ID. Det är viktigt att veta att PowerPoint‑presentationer inte har något sätt att identifiera former på en bild förutom ett internt unikt ID. Det kan vara svårt för utvecklare att hitta en form med dess interna unika ID. Alla former som lagts till på bilderna har någon alternativ text. Vi rekommenderar utvecklare att använda alternativ text för att hitta en specifik form. Du kan använda MS PowerPoint för att definiera den alternativa texten för objekt som du planerar att ändra i framtiden.
När du har angett den alternativa texten för en önskad form kan du öppna presentationen med Aspose.Slides för PHP via Java och iterera genom alla former som lagts till på en bild. Vid varje iteration kan du kontrollera formens alternativa text och formen med matchande alternativ text är den form du söker. För att demonstrera denna teknik på ett bättre sätt har vi skapat en metod, findShape som löser uppgiften att hitta en specifik form på en bild och sedan helt enkelt returnerar den formen.
# Instansiera en Presentation-klass som representerar presentationsfilen
$pres = new Presentation("FindingShapeInSlide.pptx");
try {
$slide = $pres->getSlides()->get_Item(0);
# Alternativ text för den form som ska hittas
$shape = findShape($slide, "Shape1");
if (!java_is_null($shape)) {
echo("Shape Name: " . $shape->getName());
}
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Klona en form
För att klona en form till en bild med Aspose.Slides för PHP via Java:
- Skapa en instans av klassen Presentation.
- Hämta referensen till en bild genom att använda dess index.
- Få åtkomst till källbildens formsamling.
- Lägg till en ny bild i presentationen.
- Klona former från källbildens formsamling till den nya bilden.
- Spara den modifierade presentationen som en PPTX‑fil.
Exemplet nedan lägger till en gruppform på en bild.
# Instansiera Presentation-klass
$pres = new Presentation("Source Frame.pptx");
try {
$sourceShapes = $pres->getSlides()->get_Item(0)->getShapes();
$blankLayout = $pres->getMasters()->get_Item(0)->getLayoutSlides()->getByType(SlideLayoutType::Blank);
$destSlide = $pres->getSlides()->addEmptySlide($blankLayout);
$destShapes = $destSlide->getShapes();
$destShapes->addClone($sourceShapes->get_Item(1), 50, 150 + $sourceShapes->get_Item(0)->getHeight());
$destShapes->addClone($sourceShapes->get_Item(2));
$destShapes->insertClone(0, $sourceShapes->get_Item(0), 50, 150);
# Skriv PPTX-filen till disk
$pres->save("CloneShape_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ta bort en form
Aspose.Slides för PHP via Java låter utvecklare ta bort vilken form som helst. För att ta bort formen från en bild, följ stegen nedan:
- Skapa en instans av Presentation.
- Få åtkomst till den första bilden.
- Hitta formen med specifik AlternativeText.
- Ta bort formen.
- Spara filen till disk.
# Skapa Presentation-objekt
$pres = new Presentation();
try {
# Hämta den första bilden
$sld = $pres->getSlides()->get_Item(0);
# Lägg till autoshape av rektangeltyp
$sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
$sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
$altText = "User Defined";
$iCount = $sld->getShapes()->size();
for($i = 0; $i < java_values($iCount) ; $i++) {
$ashp = $sld->getShapes()->get_Item(0);
if ($alttext->equals($ashp->getAlternativeText())) {
$sld->getShapes()->remove($ashp);
}
}
# Spara presentationen till disk
$pres->save("RemoveShape_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Dölj en form
Aspose.Slides för PHP via Java låter utvecklare dölja vilken form som helst. För att dölja formen från en bild, följ stegen nedan:
- Skapa en instans av Presentation.
- Få åtkomst till den första bilden.
- Hitta formen med specifik AlternativeText.
- Dölj formen.
- Spara filen till disk.
# Instansiera Presentation-klass som representerar PPTX
$pres = new Presentation();
try {
# Hämta den första bilden
$sld = $pres->getSlides()->get_Item(0);
# Lägg till autoshape av rektangeltyp
$sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
$sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
$alttext = "User Defined";
$iCount = $sld->getShapes()->size();
for($i = 0; $i < java_values($iCount) ; $i++) {
$ashp = $sld->getShapes()->get_Item($i);
if ($alttext->equals($ashp->getAlternativeText())) {
$ashp->setHidden(true);
}
}
# Spara presentationen till disk
$pres->save("Hiding_Shapes_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ändra formordning
Aspose.Slides för PHP via Java låter utvecklare omordna formerna. Att omordna en form bestämmer vilken form som är längst fram eller längst bak. För att omordna formerna på en bild, följ stegen nedan:
- Skapa en instans av Presentation.
- Få åtkomst till den första bilden.
- Lägg till en form.
- Lägg till lite text i formens textruta.
- Lägg till en annan form med samma koordinater.
- Omordna formerna.
- Spara filen till disk.
$pres = new Presentation("ChangeShapeOrder.pptx");
try {
$slide = $pres->getSlides()->get_Item(0);
$shp3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 365, 400, 150);
$shp3->getFillFormat()->setFillType(FillType::NoFill);
$shp3->addTextFrame(" ");
$para = $shp3->getTextFrame()->getParagraphs()->get_Item(0);
$portion = $para->getPortions()->get_Item(0);
$portion->setText("Watermark Text Watermark Text Watermark Text");
$shp3 = $slide->getShapes()->addAutoShape(ShapeType::Triangle, 200, 365, 400, 150);
$slide->getShapes()->reorder(2, $shp3);
$pres->save("Reshape_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Hämta Interop‑form‑ID
Aspose.Slides för PHP via Java låter utvecklare få ett unikt formidentifierare på bildnivå i motsats till metoden getUniqueId som ger ett unikt identifierare på presentationsnivå. Metoden getOfficeInteropShapeId har lagts till i klassen Shape. Värdet som returneras av metoden getOfficeInteropShapeId motsvarar Id‑värdet för Microsoft.Office.Interop.PowerPoint.Shape‑objektet. Nedan ges ett exempel på kod.
$pres = new Presentation("Presentation.pptx");
try {
# Hämtar unikt formidentifierare i bildnivå
$officeInteropShapeId = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getOfficeInteropShapeId();
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ange alternativ text för en form
Aspose.Slides för PHP via Java låter utvecklare ange AlternateText för vilken form som helst.
Former i en presentation kan särskiljas med Alternative Text eller metoden Shape Name.
Metoderna setAlternativeText och getAlternativeText kan läsas eller skrivas med Aspose.Slides såväl som Microsoft PowerPoint.
Genom att använda denna metod kan du märka en form och utföra olika operationer som att ta bort en form,
dölja en form eller omordna former på en bild.
För att ange AlternateText för en form, följ stegen nedan:
- Skapa en instans av Presentation.
- Få åtkomst till den första bilden.
- Lägg till någon form på bilden.
- Utför någon operation med den nylagda formen.
- Gå igenom formerna för att hitta en form.
- Sätt AlternativeText.
- Spara filen till disk.
# Instansiera Presentation-klass som representerar PPTX
$pres = new Presentation();
try {
# Hämta den första bilden
$sld = $pres->getSlides()->get_Item(0);
# Lägg till autoshape av rektangeltyp
$shp1 = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
$shp2 = $sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
$shp2->getFillFormat()->setFillType(FillType::Solid);
$shp2->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);
for($i = 0; $i < java_values($sld->getShapes()->size()) ; $i++) {
$shape = $sld->getShapes()->get_Item($i);
if (!java_is_null($shape)) {
$shape->setAlternativeText("User Defined");
}
}
# Spara presentationen till disk
$pres->save("Set_AlternativeText_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Få åtkomst till layoutformat för en form
Aspose.Slides för PHP via Java erbjuder ett enkelt API för att komma åt layoutformat för en form. Denna artikel visar hur du kan komma åt layoutformat.
Nedan ges exempel på kod.
$pres = new Presentation("pres.pptx");
try {
foreach($pres->getLayoutSlides() as $layoutSlide) {
foreach($layoutSlide->getShapes() as $shape) {
$fillFormats = $shape->getFillFormat();
$lineFormats = $shape->getLineFormat();
}
}
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Rendera en form som SVG
Nu har Aspose.Slides för PHP via Java stöd för att rendera en form som SVG. Metoden writeAsSvg (och dess överlagring) har lagts till i klassen Shape. Denna metod möjliggör att spara formens innehåll som en SVG‑fil. Kodsnutten nedan visar hur du exporterar en bilds form till en SVG‑fil.
$pres = new Presentation("TestExportShapeToSvg.pptx");
try {
$stream = new Java("java.io.FileOutputStream", "SingleShape.svg");
try {
$pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->writeAsSvg($stream);
} finally {
if (!java_is_null($stream)) {
$stream->close();
}
}
} catch (JavaException $e) {
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Justera en form
Aspose.Slides möjliggör att justera former antingen i förhållande till bildens marginaler eller i förhållande till varandra. För detta ändamål har den överlagrade metoden SlidesUtil::alignShapes lagts till. Uppräkningen ShapesAlignmentType definierar möjliga justeringsalternativ.
Example 1
Källkoden nedan justerar former med index 1,2 och 4 längs bildens överkant.
$pres = new Presentation("example.pptx");
try {
$slide = $pres->getSlides()->get_Item(0);
$shape1 = $slide->getShapes()->get_Item(1);
$shape2 = $slide->getShapes()->get_Item(2);
$shape3 = $slide->getShapes()->get_Item(4);
SlideUtil->alignShapes(ShapesAlignmentType::AlignTop, true, $pres->getSlides()->get_Item(0), array($slide->getShapes()->indexOf($shape1), $slide->getShapes()->indexOf($shape2), $slide->getShapes()->indexOf($shape3) ));
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Example 2
Exemplet nedan visar hur du justerar hela samlingen av former i förhållande till den nedersta formen i samlingen.
$pres = new Presentation("example.pptx");
try {
SlideUtil->alignShapes(ShapesAlignmentType::AlignBottom, false, $pres->getSlides()->get_Item(0));
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Flip Properties
I Aspose.Slides ger klassen ShapeFrame kontroll över horisontell och vertikal spegling av former via dess flipH‑ och flipV‑egenskaper. Båda egenskaperna är av typen NullableBool, vilket tillåter värdena True för att ange en spegling, False för ingen spegling, eller NotDefined för att använda standardbeteendet. Dessa värden är åtkomliga via en forms Frame.
För att ändra speglingsinställningarna skapas en ny ShapeFrame‑instans med formens nuvarande position och storlek, önskade värden för flipH och flipV samt rotationsvinkeln. Genom att tilldela denna instans till formens Frame och spara presentationen tillämpas speglingstransformationerna och lagras i utdatafilen.
Anta att vi har en sample.pptx‑fil där den första bilden innehåller en enda form med standardinställningar för spegling, som visas nedan.
Följande kodexempel hämtar formens aktuella speglingsegenskaper och vänder den både horisontellt och vertikalt.
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->get_Item(0);
// Hämta den horisontella vändningsegenskapen för formen.
$horizontalFlip = $shape->getFrame()->getFlipH();
echo "Horizontal flip: ", $horizontalFlip, "\n";
// Hämta den vertikala vändningsegenskapen för formen.
$verticalFlip = $shape->getFrame()->getFlipV();
echo "Vertical flip: ", $verticalFlip, "\n";
$x = $shape->getFrame()->getX();
$y = $shape->getFrame()->getY();
$width = $shape->getFrame()->getWidth();
$height = $shape->getFrame()->getHeight();
$flipH = NullableBool::True; // Vänd horisontellt.
$flipV = NullableBool::True; // Vänd horisontellt.
$rotation = $shape->getFrame()->getRotation();
$shape->setFrame(new ShapeFrame($x, $y, $width, $height, $flipH, $flipV, $rotation));
$presentation->save("output.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
FAQ
Kan jag kombinera former (union/intersect/subtract) på en bild som i ett skrivbordsredigeringsprogram?
Det finns inget inbyggt API för booleska operationer. Du kan approximera det genom att själva konstruera önskad kontur – exempelvis beräkna den resulterande geometrin (via GeometryPath) och skapa en ny form med den konturen, eventuellt ta bort de ursprungliga.
Hur kan jag kontrollera staplingsordningen (z-order) så att en form alltid förblir “överst”?
Ändra infognings-/flyttningsordningen inom bildens shapes-samling. För förutsägbara resultat, avsluta z‑ordningen efter alla andra bildändringar.
Kan jag “låsa” en form för att hindra användare från att redigera den i PowerPoint?
Ja. Ställ in skyddsflaggor på formenivå (t.ex. lås markering, flytt, storleksändring, textredigering). Om så behövs, spegla begränsningarna på mastern eller layouten. Observera att detta är skydd på UI‑nivå, inte en säkerhetsfunktion; för starkare skydd kombinera med filnivåbegränsningar som read‑only‑rekommendationer eller lösenord.