Benutzerdefinierte Form

Ändern einer Form mit Bearbeitungspunkten

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

die Ecke des Quadrats nach innen oder außen verschieben
die Krümmung für eine Ecke oder einen Punkt festlegen
neue Punkte zum Quadrat hinzufügen
Punkte auf dem Quadrat manipulieren usw.

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

Tipps zur Formbearbeitung

overview_image

Bevor Sie mit der Bearbeitung von PowerPoint-Formen durch Bearbeitungspunkte beginnen, sollten Sie die folgenden Punkte zu Formen bedenken:

Eine Form (oder ihr Pfad) kann entweder geschlossen oder offen sein.
Wenn eine Form geschlossen ist, fehlt ein Start- oder Endpunkt. Wenn eine Form offen ist, hat sie einen Anfang und ein Ende.
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 existieren als Eckpunkte, gerade Punkte oder glatte Punkte:
- Ein Eckpunkt ist ein Punkt, an dem 2 gerade Linien in einem Winkel zusammenlaufen.
- Ein glatter Punkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie existieren und die Segmente der Linie in einer glatten Kurve zusammenlaufen. In diesem Fall sind alle Griffe gleichmäßig vom Ankerpunkt entfernt.
- Ein gerader Punkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie existieren und die Segmente dieser Linie in einer glatten Kurve zusammenlaufen. In diesem Fall müssen die Griffe nicht gleichmäßig vom Ankerpunkt entfernt sein.
Durch das Bewegen oder Bearbeiten von Ankerpunkten (was den Winkel der Linien ändert) können Sie das Aussehen einer Form ändern.

Um PowerPoint-Formen über Bearbeitungspunkte zu bearbeiten, stellt Aspose.Slides die GeometryPath Klasse und die IGeometryPath Schnittstelle bereit.

Eine GeometryPath Instanz repräsentiert einen Geometriepfad des IGeometryShape Objekts.
Um den GeometryPath von der IGeometryShape Instanz abzurufen, können Sie die IGeometryShape::GetGeometryPaths Methode verwenden.
Um den GeometryPath für eine Form festzulegen, können Sie diese Methoden verwenden: IGeometryShape::SetGeometryPath() für solide Formen und IGeometryShape::SetGeometryPaths() für komposite Formen.
Um Segmente hinzuzufügen, können Sie die Methoden unter IGeometryPath verwenden.
Mit den Methoden IGeometryPath::set_Stroke() und IGeometryPath::set_FillMode() können Sie das Erscheinungsbild eines Geometriepfads festlegen.
Mithilfe der Methode IGeometryPath::get_PathData() können Sie den Geometriepfad eines GeometryShape als Array von Pfadsegmenten abrufen.
Um auf zusätzliche Optionen zur Anpassung der Geometrie einer Form zuzugreifen, können Sie GeometryPath in GraphicsPath umwandeln.
Verwenden Sie die Methoden GeometryPathToGraphicsPath und GraphicsPathToGeometryPath (aus der ShapeUtil Klasse), um GeometryPath zwischen GraphicsPath hin- und herzuwandeln.

Einfache Bearbeitungsvorgänge

Dieser C++-Code zeigt Ihnen, wie Sie

Eine Linie zum Ende eines Pfades hinzufügen

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

Eine Linie an einer bestimmten Position auf einem Pfad hinzufügen:

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

Eine kubische Bezierkurve am Ende eines Pfades hinzufügen:

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

Eine kubische Bezierkurve an einer bestimmten Position auf einem Pfad hinzufügen:

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

Eine quadratische Bezierkurve am Ende eines Pfades hinzufügen:

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

Eine quadratische Bezierkurve an einer bestimmten Position auf einem Pfad hinzufügen:

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

Einen gegebenen Bogen zu einem Pfad hinzufügen:

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

Die aktuelle Figur eines Pfades schließen:

void CloseFigure();

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

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

Das Pfadsegment an einem bestimmten Index entfernen:

void RemoveAt(int32_t index);

Benutzerdefinierte Punkte zur Form hinzufügen

Erstellen Sie eine Instanz der GeometryShape Klasse und setzen Sie den ShapeType.Rectangle Typ.
Erhalten Sie eine Instanz der GeometryPath Klasse von der Form.
Fügen Sie einen neuen Punkt zwischen den beiden oberen Punkten auf dem Pfad hinzu.
Fügen Sie einen neuen Punkt zwischen den beiden unteren Punkten auf dem Pfad hinzu.
Wenden Sie den Pfad auf die Form an.

Dieser C++-Code zeigt Ihnen, wie Sie benutzerdefinierte Punkte zu einer Form hinzufügen:

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath = shape->GetGeometryPaths()->idx_get(0);

geometryPath->LineTo(100.0f, 50.0f, 1);
geometryPath->LineTo(100.0f, 50.0f, 4);
shape->SetGeometryPath(geometryPath);

example1_image

Punkte von der Form entfernen

Erstellen Sie eine Instanz der GeometryShape Klasse und setzen Sie den ShapeType.Heart Typ.
Erhalten Sie eine Instanz der GeometryPath Klasse von der Form.
Entfernen Sie das Segment für den Pfad.
Wenden Sie den Pfad auf die Form an.

Dieser C++-Code zeigt Ihnen, wie Sie Punkte von einer Form entfernen:

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Heart, 100.0f, 100.0f, 300.0f, 300.0f));

SharedPtr<IGeometryPath> path = shape->GetGeometryPaths()->idx_get(0);
path->RemoveAt(2);
shape->SetGeometryPath(path);

example2_image

Benutzerdefinierte Form erstellen

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

Dieser C++-Code zeigt Ihnen, wie Sie eine benutzerdefinierte Form erstellen:

SharedPtr<List<PointF>> points = System::MakeObject<List<PointF>>();

float R = 100.0f, r = 50.0f;
int32_t step = 72;

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

    radians = Math::PI * (angle + step / 2) / 180.0;
    x = innerRadiusr * Math::Cos(radians);
    y = innerRadiusr * Math::Sin(radians);
    points->Add(PointF((float)x + outerRadius, (float)y + outerRadius));
}

SharedPtr<GeometryPath> starPath = System::MakeObject<GeometryPath>();
starPath->MoveTo(points->idx_get(0));

for (int32_t i = 1; i < points->get_Count(); i++)
{
    starPath->LineTo(points->idx_get(i));
}

starPath->CloseFigure();

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, R * 2, R * 2));

shape->SetGeometryPath(starPath);

example3_image

Eine zusammengesetzte benutzerdefinierte Form erstellen

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

Dieser C++-Code zeigt Ihnen, wie Sie eine zusammengesetzte benutzerdefinierte Form erstellen:

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath0 = System::MakeObject<GeometryPath>();
geometryPath0->MoveTo(0.0f, 0.0f);
geometryPath0->LineTo(shape->get_Width(), 0.0f);
geometryPath0->LineTo(shape->get_Width(), shape->get_Height() / 3);
geometryPath0->LineTo(0.0f, shape->get_Height() / 3);
geometryPath0->CloseFigure();

SharedPtr<IGeometryPath> geometryPath1 = System::MakeObject<GeometryPath>();
geometryPath1->MoveTo(0.0f, shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height());
geometryPath1->LineTo(0.0f, shape->get_Height());
geometryPath1->CloseFigure();

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ geometryPath0, geometryPath1 }));

example4_image

Benutzerdefinierte Form mit abgerundeten Ecken erstellen

Dieser C++-Code zeigt Ihnen, wie Sie eine benutzerdefinierte Form mit abgerundeten (nach innen gerichteten) Ecken erstellen:

float shapeX = 20.f;
float shapeY = 20.f;
float shapeWidth = 300.f;
float shapeHeight = 200.f;

float leftTopSize = 50.f;
float rightTopSize = 20.f;
float rightBottomSize = 40.f;
float leftBottomSize = 10.f;

auto presentation = System::MakeObject<Presentation>();

auto childShape = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Custom, shapeX, shapeY, shapeWidth, shapeHeight);

auto geometryPath = System::MakeObject<GeometryPath>();

PointF point1(leftTopSize, 0.0f);
PointF point2(shapeWidth - rightTopSize, 0.0f);
PointF point3(shapeWidth, shapeHeight - rightBottomSize);
PointF point4(leftBottomSize, shapeHeight);
PointF point5(0.0f, leftTopSize);

geometryPath->MoveTo(point1);
geometryPath->LineTo(point2);
geometryPath->ArcTo(rightTopSize, rightTopSize, 180.0f, -90.0f);
geometryPath->LineTo(point3);
geometryPath->ArcTo(rightBottomSize, rightBottomSize, -90.0f, -90.0f);
geometryPath->LineTo(point4);
geometryPath->ArcTo(leftBottomSize, leftBottomSize, 0.0f, -90.0f);
geometryPath->LineTo(point5);
geometryPath->ArcTo(leftTopSize, leftTopSize, 90.0f, -90.0f);

geometryPath->CloseFigure();

childShape->SetGeometryPath(geometryPath);

presentation->Save(u"output.pptx", SaveFormat::Pptx);

GeometryPath in GraphicsPath konvertieren

Erstellen Sie eine Instanz der GeometryShape Klasse.
Erstellen Sie eine Instanz der GraphicsPath Klasse des System.Drawing.Drawing2D Namensraums.
Konvertieren Sie die GraphicsPath Instanz in die GeometryPath Instanz mithilfe von ShapeUtil.
Wenden Sie die Pfade auf die Form an.

Dieser C++-Code, eine Implementierung der oben genannten Schritte, demonstriert den GeometryPath zu GraphicsPath Konvertierungsprozess:

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 100.0f));

SharedPtr<IGeometryPath> originalPath = shape->GetGeometryPaths()->idx_get(0);
originalPath->set_FillMode(PathFillModeType::None);

SharedPtr<Drawing2D::GraphicsPath> graphicsPath = System::MakeObject<Drawing2D::GraphicsPath>();
graphicsPath->AddString(u"Text in der Form", System::MakeObject<FontFamily>(u"Arial"), 1, 40.0f, PointF(10.0f, 10.0f), StringFormat::get_GenericDefault());

SharedPtr<IGeometryPath> textPath = ShapeUtil::GraphicsPathToGeometryPath(graphicsPath);
textPath->set_FillMode(PathFillModeType::Normal);

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ originalPath, textPath }));

example5_image

Connector Ellipse