CBrush::FromHandle

Syntax

static CBrush* FromHandle( HBRUSH hBrush );

Parameters

hBrush

HANDLE to a Windows GDI brush.

Remarks

Returns a pointer to a CBrush object when given a handle to a Windows HBRUSH object. If a CBrush object is not already attached to the handle, a temporary CBrush object is created and attached. This temporary CBrush object is valid only until the next time the application has idle time in its event loop. At this time, all temporary graphic objects are deleted. Another way of saying this is that the temporary object is only valid during the processing of one window message.

Return Value

A pointer to a CBrush object if successful; NULL if not.