Windows Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

 

 

Community Additions

Show:
© 2015 Microsoft