GetWorldTransform

The GetWorldTransform function retrieves the current world-space to page-space transformation.

BOOL GetWorldTransform(
  HDC hdc,  // handle to the device context
  LPXFORM lpXform 
            // pointer to the structure receiving transformation
);
 

Parameters

hdc
Handle to the device context.
lpXform
Pointer to an XFORM structure that receives the current world-space to page-space transformation.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError.

Remarks

The precision of the transformation may be altered if an application calls the ModifyWorldTransform function prior to calling GetWorldTransform. (This is because the internal format for storing transformation values uses a higher precision than a FLOAT value.)

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Coordinate Spaces and Transformations Overview, Coordinate Space and Transformation Functions, ModifyWorldTransform, SetWorldTransform