CGpGraphics.SetPageScalemethod

Sets the scaling factor for the page transformation of this **Graphics** object.

Syntax

FUNCTION SetPageScale (BYVAL nScale AS SINGLE) AS GpStatus

Parameters

Return value

If the function succeeds, it returns StatusOk, which is an element of the GpStatus enumeration.

If the function fails, it returns one of the other elements of the GpStatus enumeration.

Description

Sets the scaling factor for the page transformation of this Graphics object. The page transformation converts page coordinates to device coordinates.

Example

' ======================================================================================== ' The following example sets the world transformation and the page transformation of a ' Graphics object. The page unit and the page scale both belong to the page transformation. ' The code sets the page unit to millimeters and sets the page scale to 10. The call to the ' Graphics.DrawRectangle method draws a rectangle that has a width of 3 centimeters ' (UnitMillimeter along with a scaling factor of 10) and a height of 2 centimeters. The ' rectangle is translated 4 centimeters to the right and 1 centimeter down by the world ' transformation. ' ======================================================================================== SUB Example_PageScale (BYVAL hdc AS HDC)

' // Create a graphics object from the window device context DIM graphics AS CGpGraphics = hdc

'// Set the world transformation of the Graphics object. graphics.TranslateTransform(4, 1)

' // Set the page transformation of the Graphics object. graphics.SetPageUnit(UnitMillimeter) graphics.SetPageScale(10)

DIM blackPen AS CGpPen = CGpPen(ARGB_BLACK, 0) graphics.DrawRectangle(@blackPen, 0, 0, 3, 2)

END SUB ' ========================================================================================

Reference

• Include file CGpGraphics.inc
• Defined in AfxNova/CGpGraphics.inc:355
• Documented in Graphics/GdiPlus Classes/CGpGraphics Classes.md
• Topic: CGpGraphics Class