PathToRegion function

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

Syntax


HRGN PathToRegion(
  _In_ HDC hdc
);

Parameters

hdc [in]

Handle to a device context that contains a closed path.

Return value

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

If the function fails, the return value is zero.

Error codes

If the function fails, GetLastError may return one of the following error codes:

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

Error codes

If the function fails, GetLastError may return one of the following error codes:

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

Remarks

When you no longer need the HRGN object call the DeleteObject function to delete it.

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

 

 

Show: