Präsentationsformen in .NET anpassen

Form mithilfe von Bearbeitungspunkten ändern

Betrachten Sie ein Quadrat. In PowerPoint können Sie mit Bearbeitungspunkten

die Ecke des Quadrats nach innen oder außen bewegen
die Krümmung einer Ecke oder eines Punktes festlegen
neue Punkte zum Quadrat hinzufügen
Punkte am Quadrat manipulieren usw.

Im Wesentlichen können Sie die beschriebenen Vorgänge für jede Form ausführen. Mit Bearbeitungspunkten können Sie eine Form ändern oder aus einer vorhandenen Form eine neue erstellen.

Tipps zur Formbearbeitung

Übersichtsbild

Bevor Sie mit dem Bearbeiten von PowerPoint‑Formen über Bearbeitungspunkte beginnen, sollten Sie diese Punkte zu Formen berücksichtigen:

Eine Form (oder ihr Pfad) kann entweder geschlossen oder offen sein.
Alle Formen bestehen aus mindestens 2 Ankerpunkten, die durch Linien miteinander verbunden sind.
Eine Linie ist entweder gerade oder gekrümmt. Ankerpunkte bestimmen die Art der Linie.
Ankerpunkte können Eckpunkte, Geradepunkte oder Glättungspunkte sein:
- Ein Eckpunkt ist ein Punkt, an dem 2 gerade Linien in einem Winkel zusammentreffen.
- Ein Glättungspunkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie liegen und die Segmente der Linie in einer weichen Kurve zusammenlaufen. In diesem Fall sind alle Griffe vom Ankerpunkt aus in gleichem Abstand getrennt.
- Ein Geradepunkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie liegen und die Segmente der Linie in einer weichen Kurve zusammenlaufen. In diesem Fall müssen die Griffe nicht in gleichem Abstand vom Ankerpunkt getrennt sein.
Durch das Verschieben oder Bearbeiten von Ankerpunkten (was den Winkel der Linien ändert) können Sie das Aussehen einer Form verändern.

Um PowerPoint‑Formen über Bearbeitungspunkte zu bearbeiten, stellt Aspose.Slides die Klasse GeometryPath und das Interface IGeometryPath bereit.

Eine GeometryPath-Instanz repräsentiert den Geometriepfad des Objekts IGeometryShape.
Um den GeometryPath aus der IGeometryShape‑Instanz abzurufen, können Sie die Methode IGeometryShape.GetGeometryPaths verwenden.
Um den GeometryPath für eine Form zu setzen, können Sie diese Methoden verwenden: IGeometryShape.SetGeometryPath für solide Formen und IGeometryShape.SetGeometryPaths für zusammengesetzte Formen.
Um Segmente hinzuzufügen, können Sie die Methoden unter IGeometryPath nutzen.
Mit den Eigenschaften IGeometryPath.Stroke und IGeometryPath.FillMode können Sie das Erscheinungsbild eines Geometriepfads festlegen.
Über die Eigenschaft IGeometryPath.PathData können Sie den Geometriepfad eines GeometryShape als Array von Pfadsegmenten abrufen.
Für weitere Anpassungen der Formgeometrie können Sie GeometryPath in ein GraphicsPath konvertieren.
Verwenden Sie die Methoden GeometryPathToGraphicsPath und GraphicsPathToGeometryPath (aus der Klasse ShapeUtil), um GeometryPath zu GraphicsPath und zurück zu konvertieren.

Einfache Bearbeitungsoperationen

Dieser C#‑Code zeigt, wie man

Eine Linie an das Ende eines Pfads anhängt

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

Eine Linie an einer bestimmten Position im Pfad hinzufügt:

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

Eine kubische Bézier‑Kurve am Ende eines Pfads hinzufügt:

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

Eine kubische Bézier‑Kurve an einer bestimmten Position im Pfad hinzufügt:

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);

Eine quadratische Bézier‑Kurve am Ende eines Pfads hinzufügt:

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

Eine quadratische Bézier‑Kurve an einer bestimmten Position im Pfad hinzufügt:

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

Einen gegebenen Bogen an einen Pfad anhängt:

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

Die aktuelle Figur eines Pfads schließt:

void CloseFigure();

Die Position für den nächsten Punkt festlegt:

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

Das Pfadsegment an einem angegebenen Index entfernt:

void RemoveAt(int index);

Benutzerdefinierte Punkte zu einer Form hinzufügen

Erstellen Sie eine Instanz der Klasse GeometryShape und setzen Sie den Typ ShapeType.Rectangle.
Holen Sie sich eine Instanz der Klasse GeometryPath aus der Form.
Fügen Sie einen neuen Punkt zwischen den beiden oberen Punkten des Pfads ein.
Fügen Sie einen neuen Punkt zwischen den beiden unteren Punkten des Pfads ein.
Wenden Sie den Pfad auf die Form an.

Dieser C#‑Code zeigt, wie man benutzerdefinierte Punkte zu einer Form hinzufügt:

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);
}

Beispiel1

Punkte aus einer Form entfernen

Erstellen Sie eine Instanz der Klasse GeometryShape und setzen Sie den Typ ShapeType.Heart.
Holen Sie sich eine Instanz der Klasse GeometryPath aus der Form.
Entfernen Sie das Segment des Pfads.
Wenden Sie den Pfad auf die Form an.

Dieser C#‑Code zeigt, wie man Punkte aus einer Form entfernt:

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);
}

Beispiel2

Eine benutzerdefinierte Form erstellen

Berechnen Sie die Punkte für die Form.
Erstellen Sie eine Instanz der Klasse GeometryPath.
Füllen Sie den Pfad mit den Punkten.
Erstellen Sie eine Instanz der Klasse GeometryShape.
Wenden Sie den Pfad auf die Form an.

Dieser C#‑Code zeigt, wie man eine benutzerdefinierte Form erstellt:

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);
}

Beispiel3

Ein zusammengesetztes benutzerdefiniertes Formobjekt erstellen

Erstellen Sie eine Instanz der Klasse GeometryShape.
Erstellen Sie eine erste Instanz der Klasse GeometryPath.
Erstellen Sie eine zweite Instanz der Klasse GeometryPath.
Wenden Sie die Pfade auf die Form an.

Dieser C#‑Code zeigt, wie man ein zusammengesetztes benutzerdefiniertes Formobjekt erstellt:

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});
}

Beispiel4

Eine benutzerdefinierte Form mit abgerundeten Ecken erstellen

Dieser C#‑Code zeigt, wie man eine benutzerdefinierte Form mit abgerundeten Ecken (nach innen) erstellt:

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);
}

Ermitteln, ob eine Formgeometrie geschlossen ist

Eine geschlossene Form ist definiert als eine Form, bei der alle Seiten miteinander verbunden sind und eine durchgehende Grenze ohne Lücken bilden. Eine solche Form kann eine einfache geometrische Form oder eine komplexe benutzerdefinierte Kontur sein. Das folgende Codebeispiel zeigt, wie Sie prüfen, ob eine Formgeometrie geschlossen ist:

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;
}

GeometryPath in GraphicsPath (System.Drawing.Drawing2D) konvertieren

Erstellen Sie eine Instanz der Klasse GeometryShape.
Erstellen Sie eine Instanz der Klasse GraphicsPath aus dem Namespace System.Drawing.Drawing2D.
Konvertieren Sie die GraphicsPath-Instanz mittels ShapeUtil in eine GeometryPath-Instanz.
Wenden Sie die Pfade auf die Form an.

Dieser C#‑Code – eine Umsetzung der obigen Schritte – demonstriert den GeometryPath‑zu‑GraphicsPath‑Konvertierungsprozess:

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}) ;
}

Beispiel5

FAQ

Was passiert mit Füllung und Kontur, nachdem die Geometrie ersetzt wurde?

Der Stil bleibt an der Form erhalten; nur die Kontur ändert sich. Füllung und Kontur werden automatisch auf die neue Geometrie angewendet.

Wie rotiere ich eine benutzerdefinierte Form korrekt zusammen mit ihrer Geometrie?

Verwenden Sie die Eigenschaft rotation der Form; die Geometrie rotiert mit der Form, weil sie an das eigene Koordinatensystem der Form gebunden ist.

Kann ich eine benutzerdefinierte Form in ein Bild konvertieren, um das Ergebnis “einzusperren”?

Ja. Exportieren Sie den gewünschten slide-Bereich oder das shape selbst in ein Rasterformat; das erleichtert die weitere Arbeit mit komplexen Geometrien.

Connectoren in Präsentationen mit .NET verwalten Ellipsen zu Präsentationen in .NET hinzufügen