CreateShape

CreateShape([sType], [nWidth], [nHeight], [oFill], [oStroke]) → { ApiShape }

Creates a shape with the parameters specified.

Parameters:

Name Type Default Description
sType ShapeType "rect"

The shape type which specifies the preset shape geometry.

nWidth EMU 914400

The shape width in English measure units.

nHeight EMU 914400

The shape height in English measure units.

oFill ApiFill Api.CreateNoFill()

The color or pattern used to fill the shape.

oStroke ApiStroke Api.CreateStroke(0, Api.CreateNoFill())

The stroke used to create the element shadow.

Returns:

Type
ApiShape

Example

Copy code
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
var oGs1 = Api.CreateGradientStop(Api.CreateRGBColor(255, 213, 191), 0);
var oGs2 = Api.CreateGradientStop(Api.CreateRGBColor(255, 111, 61), 100000);
var oFill = Api.CreateLinearGradientFill([oGs1, oGs2], 5400000);
var oStroke = Api.CreateStroke(0, Api.CreateNoFill());
var oDrawing = Api.CreateShape("rect", 5930900, 395605, oFill, oStroke);
oParagraph.AddDrawing(oDrawing);
builder.SaveFile("docx", "CreateShape.docx");
builder.CloseFile();

Resulting document