InsertGroupShape

InsertGroupShape(params ShapeBase[])

Gruppiert die als Parameter übergebenen Formen in einem neuen GroupShape-Knoten, der an der aktuellen Position eingefügt wird.

public GroupShape InsertGroupShape(params ShapeBase[] shapes)
ParameterTypBeschreibung
shapesShapeBase[]Die Liste der zu gruppierenden Formen.

Bemerkungen

Die Position und Dimension der neuen GroupShape werden automatisch berechnet.

VML- und DML-Formen können nicht gruppiert werden.

Beispiele

Zeigt, wie die Gruppenform mit der Form kombiniert wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape1 = builder.InsertShape(ShapeType.Rectangle, 200, 250);
shape1.Left = 20;
shape1.Top = 20;
shape1.Stroke.Color = Color.Red;

Shape shape2 = builder.InsertShape(ShapeType.Ellipse, 150, 200);
shape2.Left = 40;
shape2.Top = 50;
shape2.Stroke.Color = Color.Green;

// Kombinieren Sie Formen zu einem GroupShape-Knoten, der an der angegebenen Position eingefügt wird.
GroupShape groupShape1 = builder.InsertGroupShape(shape1, shape2);

// Kombinieren Sie Shape- und GroupShape-Knoten.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(groupShape1, shape3);

doc.Save(ArtifactsDir + "Shape.CombineGroupShape.docx");

Zeigt, wie eine DML-Gruppenform eingefügt wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape1 = builder.InsertShape(ShapeType.Rectangle, 200, 250);
shape1.Left = 20;
shape1.Top = 20;
shape1.Stroke.Color = Color.Red;

Shape shape2 = builder.InsertShape(ShapeType.Ellipse, 150, 200);
shape2.Left = 40;
shape2.Top = 50;
shape2.Stroke.Color = Color.Green;

// Abmessungen für den neuen GroupShape-Knoten.
double left = 10;
double top = 10;
double width = 200;
double height = 300;
// Fügen Sie einen GroupShape-Knoten der angegebenen Größe ein, der an der angegebenen Position eingefügt wird.
GroupShape groupShape1 = builder.InsertGroupShape(left, top, width, height, new Shape[] { shape1, shape2 });

// Fügen Sie einen GroupShape-Knoten ein, dessen Position und Dimension automatisch berechnet werden.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(shape3);

doc.Save(ArtifactsDir + "Shape.InsertGroupShape.docx");

Siehe auch


InsertGroupShape(double, double, double, double, params ShapeBase[])

Gruppiert die als Parameter übergebenen Formen in einem neuen GroupShape-Knoten der angegebenen Größe, der an der angegebenen Position eingefügt wird.

public GroupShape InsertGroupShape(double left, double top, double width, double height, 
    params ShapeBase[] shapes)
ParameterTypBeschreibung
leftDoubleAbstand in Punkten vom Ursprung zur linken Seite der Gruppenform.
topDoubleAbstand in Punkten vom Ursprung zur Oberseite der Gruppenform.
widthDoubleDie Breite der Gruppenform in Punkten. Ein negativer Wert ist nicht zulässig.
heightDoubleDie Höhe der Gruppenform in Punkten. Ein negativer Wert ist nicht zulässig.
shapesShapeBase[]Die Liste der zu gruppierenden Formen.

Bemerkungen

VML- und DML-Formen können nicht gruppiert werden.

Beispiele

Zeigt, wie eine DML-Gruppenform eingefügt wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape1 = builder.InsertShape(ShapeType.Rectangle, 200, 250);
shape1.Left = 20;
shape1.Top = 20;
shape1.Stroke.Color = Color.Red;

Shape shape2 = builder.InsertShape(ShapeType.Ellipse, 150, 200);
shape2.Left = 40;
shape2.Top = 50;
shape2.Stroke.Color = Color.Green;

// Abmessungen für den neuen GroupShape-Knoten.
double left = 10;
double top = 10;
double width = 200;
double height = 300;
// Fügen Sie einen GroupShape-Knoten der angegebenen Größe ein, der an der angegebenen Position eingefügt wird.
GroupShape groupShape1 = builder.InsertGroupShape(left, top, width, height, new Shape[] { shape1, shape2 });

// Fügen Sie einen GroupShape-Knoten ein, dessen Position und Dimension automatisch berechnet werden.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(shape3);

doc.Save(ArtifactsDir + "Shape.InsertGroupShape.docx");

Siehe auch