Personalizza le Forme delle Presentazioni in .NET

Panoramica

Questo articolo spiega come personalizzare le forme delle presentazioni in Aspose.Slides modificando la geometria delle forme tramite punti di modifica e percorsi geometrici. Mostra come lavorare con GeometryPath e IGeometryPath per modificare forme esistenti, eseguire operazioni di base di modifica del percorso, aggiungere o rimuovere punti e applicare la geometria aggiornata a una forma.

Dimostra inoltre come creare forme personalizzate e composite, costruire forme con angoli curve, determinare se la geometria di una forma è chiusa e convertire tra GeometryPath e GraphicsPath per ulteriori scenari di personalizzazione della geometria.

Modifica una Forma Utilizzando i Punti di Modifica

Considera un quadrato. In PowerPoint, usando punti di modifica, puoi

spostare l’angolo del quadrato verso l’interno o l’esterno
specificare la curvatura per un angolo o un punto
aggiungere nuovi punti al quadrato
manipolare i punti sul quadrato, ecc.

Essenzialmente, puoi eseguire le operazioni descritte su qualsiasi forma. Utilizzando i punti di modifica, puoi modificare una forma o crearne una nuova a partire da una forma esistente.

Suggerimenti per la Modifica delle Forme

panoramica

Prima di iniziare a modificare le forme di PowerPoint tramite i punti di modifica, potresti voler considerare i seguenti aspetti delle forme:

Una forma (o il suo percorso) può essere chiusa oppure aperta.
Tutte le forme sono composte da almeno 2 punti di ancoraggio collegati tra loro da linee.
Una linea è rettilinea o curva. I punti di ancoraggio determinano la natura della linea.
I punti di ancoraggio esistono come punti d’angolo, punti lineari o punti lisci:
- Un punto d’angolo è un punto in cui 2 linee rette si uniscono formando un angolo.
- Un punto liscio è un punto in cui 2 maniglie esistono in una linea retta e i segmenti della linea si uniscono in una curva fluida. In questo caso, tutte le maniglie sono separate dal punto di ancoraggio di una distanza uguale.
- Un punto lineare è un punto in cui 2 maniglie esistono in una linea retta e i segmenti di quella linea si uniscono in una curva fluida. In questo caso, le maniglie non devono essere separate dal punto di ancoraggio di una distanza uguale.
Spostando o modificando i punti di ancoraggio (che cambiano l’angolo delle linee), puoi alterare l’aspetto di una forma.

Per modificare le forme di PowerPoint tramite i punti di modifica, Aspose.Slides fornisce la classe GeometryPath e l’interfaccia IGeometryPath.

Un’istanza di GeometryPath rappresenta un percorso geometrico dell’oggetto IGeometryShape.
Per recuperare il GeometryPath dall’istanza IGeometryShape, puoi usare il metodo IGeometryShape.GetGeometryPaths.
Per impostare il GeometryPath per una forma, puoi utilizzare questi metodi: IGeometryShape.SetGeometryPath per forme solide e IGeometryShape.SetGeometryPaths per forme composite.
Per aggiungere segmenti, puoi utilizzare i metodi sotto IGeometryPath.
Utilizzando le proprietà IGeometryPath.Stroke e IGeometryPath.FillMode, puoi impostare l’aspetto di un percorso geometrico.
Utilizzando la proprietà IGeometryPath.PathData, puoi recuperare il percorso geometrico di un GeometryShape come un array di segmenti di percorso.
Per accedere a ulteriori opzioni di personalizzazione della geometria delle forme, puoi convertire GeometryPath in GraphicsPath
Usa i metodi GeometryPathToGraphicsPath e GraphicsPathToGeometryPath (dalla classe ShapeUtil) per convertire GeometryPath in GraphicsPath e viceversa.

Operazioni di Modifica Semplici

Questo codice C# ti mostra come

Aggiungere una linea alla fine di un percorso

void LineTo(PointF point);
void LineTo(float x, float y);

Aggiungere una linea a una posizione specifica su un percorso:

void LineTo(PointF point, uint index);
void LineTo(float x, float y, uint index);

Aggiungere una curva Bézier cubica alla fine di un percorso:

void CubicBezierTo(PointF point1, PointF point2, PointF point3);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

Aggiungere una curva Bézier cubica alla posizione specificata su un percorso:

void CubicBezierTo(PointF point1, PointF point2, PointF point3, uint index);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, uint index);

Aggiungere una curva Bézier quadratica alla fine di un percorso:

void QuadraticBezierTo(PointF point1, PointF point2);
void QuadraticBezierTo(float x1, float y1, float x2, float y2);

Aggiungere una curva Bézier quadratica a una posizione specificata su un percorso:

void QuadraticBezierTo(PointF point1, PointF point2, uint index);
void QuadraticBezierTo(float x1, float y1, float x2, float y2, uint index);

Aggiungere un arco specifico a un percorso:

void ArcTo(float width, float heigth, float startAngle, float sweepAngle);

Chiudere la figura corrente di un percorso:

void CloseFigure();

Impostare la posizione per il punto successivo:

void MoveTo(PointF point);
void MoveTo(float x, float y);

Rimuovere il segmento del percorso a un indice dato:

void RemoveAt(int index);

Aggiungere Punti Personalizzati a una Forma

Crea un’istanza della classe GeometryShape e imposta il tipo ShapeType.Rectangle.
Ottieni un’istanza della classe GeometryPath dalla forma.
Aggiungi un nuovo punto tra i due punti superiori del percorso.
Aggiungi un nuovo punto tra i due punti inferiori del percorso.
Applica il percorso alla forma.

Questo codice C# ti mostra come aggiungere punti personalizzati a una forma:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;
    IGeometryPath geometryPath = shape.GetGeometryPaths()[0];

    geometryPath.LineTo(100, 50, 1);
    geometryPath.LineTo(100, 50, 4);
    shape.SetGeometryPath(geometryPath);
}

esempio1

Rimuovere Punti da una Forma

Crea un’istanza della classe GeometryShape e imposta il tipo ShapeType.Heart.
Ottieni un’istanza della classe GeometryPath dalla forma.
Rimuovi il segmento del percorso.
Applica il percorso alla forma.

Questo codice C# ti mostra come rimuovere punti da una forma:

using (Presentation pres = new Presentation())
{
	GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Heart, 100, 100, 300, 300) as GeometryShape;

	IGeometryPath path = shape.GetGeometryPaths()[0];
	path.RemoveAt(2);
	shape.SetGeometryPath(path);
}

esempio2

Creare una Forma Personalizzata

Calcola i punti per la forma.
Crea un’istanza della classe GeometryPath.
Riempisci il percorso con i punti.
Crea un’istanza della classe GeometryShape.
Applica il percorso alla forma.

Questo codice C# ti mostra come creare una forma personalizzata:

List<PointF> points = new List<PointF>();

float R = 100, r = 50;
int step = 72;

for (int angle = -90; angle < 270; angle += step)
{
    double radians = angle * (Math.PI / 180f);
    double x = R * Math.Cos(radians);
    double y = R * Math.Sin(radians);
    points.Add(new PointF((float)x + R, (float)y + R));

    radians = Math.PI * (angle + step / 2) / 180.0;
    x = r * Math.Cos(radians);
    y = r * Math.Sin(radians);
    points.Add(new PointF((float)x + R, (float)y + R));
}

GeometryPath starPath = new GeometryPath();
starPath.MoveTo(points[0]);

for (int i = 1; i < points.Count; i++)
{
    starPath.LineTo(points[i]);
}

starPath.CloseFigure();

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, R * 2, R * 2) as GeometryShape;

    shape.SetGeometryPath(starPath);
}

esempio3

Creare una Forma Personalizzata Composita

Crea un’istanza della classe GeometryShape.
Crea una prima istanza della classe GeometryPath.
Crea una seconda istanza della classe GeometryPath.
Applica i percorsi alla forma.

Questo codice C# ti mostra come creare una forma personalizzata composita:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;

    GeometryPath geometryPath0 = new GeometryPath();
    geometryPath0.MoveTo(0, 0);
    geometryPath0.LineTo(shape.Width, 0);
    geometryPath0.LineTo(shape.Width, shape.Height/3);
    geometryPath0.LineTo(0, shape.Height / 3);
    geometryPath0.CloseFigure();

    GeometryPath geometryPath1 = new GeometryPath();
    geometryPath1.MoveTo(0, shape.Height/3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height / 3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height);
    geometryPath1.LineTo(0, shape.Height);
    geometryPath1.CloseFigure();

    shape.SetGeometryPaths(new GeometryPath[] { geometryPath0, geometryPath1});
}

esempio4

Creare una Forma Personalizzata con Angoli Curvi

Questo codice C# ti mostra come creare una forma personalizzata con angoli curvi (verso l’interno);

var shapeX = 20f;
var shapeY = 20f;
var shapeWidth = 300f;
var shapeHeight = 200f;

var leftTopSize = 50f;
var rightTopSize = 20f;
var rightBottomSize = 40f;
var leftBottomSize = 10f;

using (var presentation = new Presentation())
{
    var childShape = presentation.Slides[0].Shapes.AddAutoShape(
        ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);

    var geometryPath = new GeometryPath();

    var point1 = new PointF(leftTopSize, 0);
    var point2 = new PointF(shapeWidth - rightTopSize, 0);
    var point3 = new PointF(shapeWidth, shapeHeight - rightBottomSize);
    var point4 = new PointF(leftBottomSize, shapeHeight);
    var point5 = new PointF(0, leftTopSize);

    geometryPath.MoveTo(point1);
    geometryPath.LineTo(point2);
    geometryPath.ArcTo(rightTopSize, rightTopSize, 180, -90);
    geometryPath.LineTo(point3);
    geometryPath.ArcTo(rightBottomSize, rightBottomSize, -90, -90);
    geometryPath.LineTo(point4);
    geometryPath.ArcTo(leftBottomSize, leftBottomSize, 0, -90);
    geometryPath.LineTo(point5);
    geometryPath.ArcTo(leftTopSize, leftTopSize, 90, -90);

    geometryPath.CloseFigure();

    childShape.SetGeometryPath(geometryPath);

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Scoprire se una Geometria di Forma è Chiusa

Una forma chiusa è definita come quella i cui lati si connettono tutti, formando un unico contorno senza spazi. Tale forma può essere una semplice figura geometrica o un contorno personalizzato complesso. Il seguente esempio di codice mostra come verificare se la geometria di una forma è chiusa:

bool IsGeometryClosed(IGeometryShape geometryShape)
{
    bool? isClosed = null;

    foreach (var geometryPath in geometryShape.GetGeometryPaths())
    {
        var dataLength = geometryPath.PathData.Length;
        if (dataLength == 0)
            continue;

        var lastSegment = geometryPath.PathData[dataLength - 1];
        isClosed = lastSegment.PathCommand == PathCommandType.Close;

        if (isClosed == false)
            return false;
    }
    
    return isClosed == true;
}

Convertire GeometryPath in GraphicsPath (System.Drawing.Drawing2D)

Crea un’istanza della classe GeometryShape.
Crea un’istanza della classe GraphicsPath del namespace System.Drawing.Drawing2D.
Converte l’istanza GraphicsPath nell’istanza GeometryPath utilizzando ShapeUtil.
Applica i percorsi alla forma.

Questo codice C# — un’implementazione dei passaggi sopra — dimostra il processo di conversione da GeometryPath a GraphicsPath:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 100) as GeometryShape;

    IGeometryPath originalPath = shape.GetGeometryPaths()[0];
    originalPath.FillMode = PathFillModeType.None;

    GraphicsPath gPath = new GraphicsPath();

    gPath.AddString("Text in shape", new FontFamily("Arial"), 1, 40, new PointF(10, 10), StringFormat.GenericDefault);

    IGeometryPath textPath = ShapeUtil.GraphicsPathToGeometryPath(gPath);
    textPath.FillMode = PathFillModeType.Normal;

    shape.SetGeometryPaths(new[] {originalPath, textPath}) ;
}

esempio5

FAQ

Cosa succederà al riempimento e al contorno dopo aver sostituito la geometria?

Lo stile rimane associato alla forma; solo il contorno cambia. Il riempimento e il contorno vengono applicati automaticamente alla nuova geometria.

Come ruoto correttamente una forma personalizzata insieme alla sua geometria?

Usa la proprietà rotation della forma; la geometria ruota con la forma perché è legata al sistema di coordinate della stessa forma.

Posso convertire una forma personalizzata in un’immagine per “bloccare” il risultato?

Sì. Esporta l’area della slide o la forma stessa in un formato raster; questo semplifica ulteriori operazioni con geometrie complesse.

Gestire i connettori nelle presentazioni in .NET Aggiungere ellissi alle presentazioni in .NET