PathToRegion

The PathToRegion function creates a region from the path that is selected into the specified device context. The resulting region uses device coordinates.

HRGN PathToRegion(
  HDC hdc   // handle to device context
);
 

Parameters

hdc

Handle to a device context that contains a closed path.

Return Values

If the function succeeds, the return value identifies a valid region.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError. GetLastError may return one of the following error codes:

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

Remarks

The device context identified by the hdc parameter must contain a closed path.

After PathToRegion converts a path into a region, the system discards the closed path from the specified device context.

QuickInfo

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

See Also

Paths Overview, Path Functions, BeginPath, EndPath, SetPolyFillMode