InsertGroupShape

InsertGroupShape(params ShapeBase[])

Группирует фигуры, переданные в качестве параметра, в новый узел GroupShape, который вставляется в текущую позицию.

public GroupShape InsertGroupShape(params ShapeBase[] shapes)
ПараметрТипОписание
shapesShapeBase[]Список фигур для группировки.

Примечания

Положение и размеры новой GroupShape будут рассчитаны автоматически.

Формы VML и DML нельзя группировать вместе.

Примеры

Показывает, как сочетать форму группы с формой.

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;

// Объединяем фигуры в узел GroupShape, который вставляется в указанную позицию.
GroupShape groupShape1 = builder.InsertGroupShape(shape1, shape2);

// Объединяем узлы Shape и GroupShape.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(groupShape1, shape3);

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

Показывает, как вставить групповую фигуру DML.

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;

// Размеры нового узла GroupShape.
double left = 10;
double top = 10;
double width = 200;
double height = 300;
// Вставляем узел GroupShape указанного размера, который вставляется в указанную позицию.
GroupShape groupShape1 = builder.InsertGroupShape(left, top, width, height, new Shape[] { shape1, shape2 });

// Вставьте узел GroupShape, положение и размер которого будут рассчитаны автоматически.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(shape3);

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

Смотрите также

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

Группирует фигуры, переданные в качестве параметра, в новый узел GroupShape указанного размера, который вставляется в указанную позицию.

public GroupShape InsertGroupShape(double left, double top, double width, double height, 
    params ShapeBase[] shapes)
ПараметрТипОписание
leftDoubleРасстояние в точках от начала координат до левой стороны групповой фигуры.
topDoubleРасстояние в точках от начала координат до верхней стороны групповой фигуры.
widthDoubleШирина групповой фигуры в точках. Отрицательное значение не допускается.
heightDoubleВысота групповой фигуры в пунктах. Отрицательное значение не допускается.
shapesShapeBase[]Список фигур для группировки.

Примечания

Формы VML и DML не могут быть сгруппированы вместе.

Примеры

Показывает, как вставить групповую фигуру DML.

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;

// Размеры нового узла GroupShape.
double left = 10;
double top = 10;
double width = 200;
double height = 300;
// Вставляем узел GroupShape указанного размера, который вставляется в указанную позицию.
GroupShape groupShape1 = builder.InsertGroupShape(left, top, width, height, new Shape[] { shape1, shape2 });

// Вставьте узел GroupShape, положение и размер которого будут рассчитаны автоматически.
Shape shape3 = (Shape)shape1.Clone(true);
GroupShape groupShape2 = builder.InsertGroupShape(shape3);

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

Смотрите также

DocumentBuilder.InsertForms2OleControl DocumentBuilder.InsertHorizontalRule