From Xojo Documentation

You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!

Property (As Double )
aGraphics.ScaleX = newDoubleValue
DoubleValue = aGraphics.ScaleX

New in 2016r1

Supported for all project types and targets.

The scale factor used when converting user space coordinates to backing store coordinates. These can be modified at runtime and must be greater than zero.


When the Graphics object starts out, the scale is set to the the current transform used to convert user space coordinates to backing store coordinates. For example, the graphics object on a Canvas passed to a paint event might have the ScaleX and ScaleY set to 2 when drawing to a retina screen. For a bitmap Picture, the ScaleX and ScaleY properties are always 1.

The scale properties are not automatically updated if a control's backing store scale factor changes. They are, however, automatically updated when calling Graphics.NextPage in order to reset back to the state the printing system desires for that page.

Altering these properties will alter the object's height and width. Specifying a higher scale value will result in a lower size and vice versa. When a new graphics object is created as the result of calling Clip, the resulting object has the same scale factor as the original. Subsequent modifications to the scale on one object has no bearing on the other, however.