SetFill

Sets the fill formatting properties to the current graphic object.

Inherited from ApiDrawing.SetFill.

Syntax

expression.SetFill(fill);

expression - A variable that represents an ApiGroup class.

Parameters

Name	Required/Optional	Data type	Default	Description
fill	Required	ApiFill		The fill type used to fill the graphic object.

Returns

boolean

Example

Set the fill formatting properties to a shape and an image in a spreadsheet.

// SetFill applies an ApiFill to any drawing object added to a worksheet, not only shapes.

// Fill a shape with a solid color and an image with a semi-transparent overlay.

const worksheet = Api.GetActiveSheet();
const noFill = Api.CreateNoFill();
const stroke = Api.CreateStroke(0, noFill);
const shape = worksheet.AddShape(
	'rect',
	Api.MillimetersToEmus(60), Api.MillimetersToEmus(40),
	noFill, stroke,
	1, 0, 1, 0
);
const shapeFill = Api.CreateSolidFill(Api.RGB(96, 125, 139));
shape.SetFill(shapeFill);
worksheet.GetRange('A1').SetValue('Shape fill changed to blue-grey.');

const image = worksheet.AddImage(
	'https://static.onlyoffice.com/assets/docs/samples/img/onlyoffice_logo.png',
	Api.MillimetersToEmus(40), Api.MillimetersToEmus(40),
	8, 0, 1, 0
);
const imageFill = Api.CreateSolidFill(Api.RGBA(38, 50, 56, 180));
image.SetFill(imageFill);
worksheet.GetRange('H1').SetValue('Image with semi-transparent fill overlay.');