PicTile module

class PicTile.PicTile

Bases: SpireObject

Represents picture tiling settings for a fill picture in Excel.

This class encapsulates the properties that control how a picture is tiled when used as a fill for shapes, cells, or other Excel objects. It allows for configuring the picture’s offset and scaling when tiled across an area.

property OffsetX: float

Gets or sets the horizontal offset for the tiled picture.

This value represents the horizontal displacement of the picture from its default position when tiled. A value of 0.0 indicates no horizontal offset.

Returns:: The horizontal offset as a decimal value.
Return type:: float

property OffsetY: float

Gets or sets the vertical offset for the tiled picture.

This value represents the vertical displacement of the picture from its default position when tiled. A value of 0.0 indicates no vertical offset.

Returns:: The vertical offset as a decimal value.
Return type:: float

property ScaleX: float

Gets or sets the horizontal scale factor for the tiled picture.

This value determines how the picture is stretched or compressed horizontally when tiled. A value of 1.0 represents 100% (original size). Values greater than 1.0 enlarge the picture, while values less than 1.0 reduce it.

Returns:: The horizontal scale factor as a decimal value.
Return type:: float

property ScaleY: float

Gets or sets the vertical scale factor for the tiled picture.

This value determines how the picture is stretched or compressed vertically when tiled. A value of 1.0 represents 100% (original size). Values greater than 1.0 enlarge the picture, while values less than 1.0 reduce it.

Returns:: The vertical scale factor as a decimal value.
Return type:: float