Lägg till linjeformer i presentationer i .NET

Ö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 linjeformateringsinställningar såsom stil, bredd, streckmönster, pilspetsalternativ och fyllningsfärg.

Skapa en enkel linje

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

  • Skapa en instans av Presentation klass.
  • Hämta referensen till en bild genom att använda dess Index.
  • Lägg till en AutoShape av typen Line med hjälp av AddAutoShape-metoden som exponeras av Shapes-objektet.
  • 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
// Hämta den första bilden
// Lägg till en autoshape av typen linje
//Skriv PPTX-filen till disk
using (Presentation pres = new Presentation())
{
    // Get the first slide
    ISlide sld = pres.Slides[0];

    // Add an autoshape of type line
    sld.Shapes.AddAutoShape(ShapeType.Line, 50, 150, 300, 0);

    //Write the PPTX to Disk
    pres.Save("LineShape1_out.pptx", SaveFormat.Pptx);
}

Skapa en pilformad linje

Aspose.Slides för .NET låter också utvecklare konfigurera vissa egenskaper på linjen för att göra den mer attraktiv. Låt oss försöka konfigurera några egenskaper på 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 klass.
  • Hämta referensen till en bild genom att använda dess Index.
  • Lägg till en AutoShape av typen Line med hjälp av AddAutoShape-metoden som exponeras av Shapes-objektet.
  • Ställ in Linjestilen till någon av de stilar som erbjuds av Aspose.Slides för .NET.
  • Ställ in bredden på linjen.
  • Ställ in Dash Style för linjen till någon av de stilar som erbjuds av Aspose.Slides för .NET.
  • Ställ in Arrow Head Style och längd för startpunkten på linjen.
  • Ställ in Arrow Head Style och längd för slutpunkten på linjen.
  • Skriv den modifierade presentationen som en PPTX-fil.
// Instansiera PresentationEx-klassen som representerar PPTX-filen
using (Presentation pres = new Presentation())
{

    // Hämta den första bilden
    ISlide sld = pres.Slides[0];

    // Lägg till en autoshape av typen linje
    IAutoShape shp = sld.Shapes.AddAutoShape(ShapeType.Line, 50, 150, 300, 0);

    // Applicera lite formatering på linjen
    shp.LineFormat.Style = LineStyle.ThickBetweenThin;
    shp.LineFormat.Width = 10;

    shp.LineFormat.DashStyle = LineDashStyle.DashDot;

    shp.LineFormat.BeginArrowheadLength = LineArrowheadLength.Short;
    shp.LineFormat.BeginArrowheadStyle = LineArrowheadStyle.Oval;

    shp.LineFormat.EndArrowheadLength = LineArrowheadLength.Long;
    shp.LineFormat.EndArrowheadStyle = LineArrowheadStyle.Triangle;

    shp.LineFormat.FillFormat.FillType = FillType.Solid;
    shp.LineFormat.FillFormat.SolidFillColor.Color = Color.Maroon;

    //Skriv PPTX-filen till disk
    pres.Save("LineShape2_out.pptx", SaveFormat.Pptx);
}

Vanliga frågor

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

Nej. En vanlig linje (en AutoShape av typen Line) blir inte automatiskt en anslutning. För att den ska 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 slutgiltiga värdena?

Read the effective properties genom ILineFormatEffectiveData/ILineFillFormatEffectiveData-gränssnitten — 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 disallow editing operations.