Lägg till linjeformer i presentationer i PHP

Översikt

Aspose.Slides låter dig lägga till linjeformer i PowerPoint‑bilder programmässigt. Den här artikeln visar hur du skapar en enkel linje och hur du anpassar en linje så att den visas som en pil.

Du kommer att lära dig hur du lägger till en linjeform på en bild, justerar dess visuella utseende och sparar den uppdaterade presentationen. Exemplen fokuserar på praktiska inställningar för linjeformatering såsom stil, bredd, streckmönster, pilartramsalternativ och fyllningsfärg.

Skapa en enkel linje

För att lägga till en enkel linje på ett valt bild i presentationen, följ stegen nedan:

• Skapa en instans av Presentation-klassen.
• Hämta referensen till en bild genom att använda dess Index.
• Lägg till en AutoShape av typen Line med hjälp av metoden addAutoShape som exponeras av objektet ShapeCollection.
• Skriv den modifierade presentationen som en PPTX‑fil.

I exemplet nedan har vi lagt till en linje på den första bilden i presentationen.

  # Instansiera PresentationEx-klassen som representerar PPTX-filen
  $pres = new Presentation();
  try {
    # Hämta den första bilden
    $sld = $pres->getSlides()->get_Item(0);
    # Lägg till en AutoShape av typen linje
    $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # Skriv PPTX-filen till disk
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Skapa en pilformad linje

Aspose.Slides för PHP via Java låter även utvecklare konfigurera vissa egenskaper för linjen så att den blir mer attraktiv. Låt oss försöka konfigurera några egenskaper för en linje så att den ser ut som en pil. Följ stegen nedan för att göra detta:

• Skapa en instans av Presentation-klassen.
• Hämta referensen till en bild genom att använda dess Index.
• Lägg till en AutoShape av typen Line med hjälp av metoden addAutoShape som exponeras av objektet ShapeCollection.
• Ställ in Line Style till en av de stilar som erbjuds av Aspose.Slides för PHP via Java.
• Ställ in linjens bredd.
• Ställ in Dash Style för linjen till en av de stilar som erbjuds av Aspose.Slides för PHP via Java.
• Ställ in Arrow Head Style och Length för linjens startpunkt.
• Ställ in Arrow Head Style och Length för linjens slutpunkt.
• Skriv den modifierade presentationen som en PPTX‑file.

  # Instansiera PresentationEx-klassen som representerar PPTX-filen
  $pres = new Presentation();
  try {
    # Hämta den första bilden
    $sld = $pres->getSlides()->get_Item(0);
    # Lägg till en AutoShape av typen linje
    $shp = $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # Applicera viss formatering på linjen
    $shp->getLineFormat()->setStyle(LineStyle->ThickBetweenThin);
    $shp->getLineFormat()->setWidth(10);
    $shp->getLineFormat()->setDashStyle(LineDashStyle->DashDot);
    $shp->getLineFormat()->setBeginArrowheadLength(LineArrowheadLength->Short);
    $shp->getLineFormat()->setBeginArrowheadStyle(LineArrowheadStyle->Oval);
    $shp->getLineFormat()->setEndArrowheadLength(LineArrowheadLength->Long);
    $shp->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
    $shp->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shp->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(new java("java.awt.Color", PresetColor->Maroon));
    # Skriv PPTX-filen till disk
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Kan jag konvertera en vanlig linje till en connector så att den “snäpper” till former?

Nej. En vanlig linje (en AutoShape av typen Line) blir inte automatiskt en connector. För att få den att snäppa till former, använd den dedikerade Connector‑typen och de corresponding APIs för anslutningar.

Vad ska jag göra om en linjes egenskaper ärvs från temat och det är svårt att fastställa de slutliga värdena?

Läs de effektiva egenskaperna via LineFormatEffectiveData/LineFillFormatEffectiveData — dessa tar redan hänsyn till arv och temastilar.

Kan jag låsa en linje mot redigering (flytt, storleksändring)?

Ja. Former tillhandahåller lock objects som låter dig förbjuda redigeringsåtgärder.