| BOOL UnrealizeObject(hgdiobj) | |||||
| HGDIOBJ hgdiobj; | /* handle of brush or palette | */ | |||
The UnrealizeObject function resets the origin of a brush or resets a logical palette. If the hgdiobj parameter identifies a brush, UnrealizeObject directs the system to reset the origin of the brush the next time it is selected. If the hgdiobj parameter identifies a logical palette, UnrealizeObject directs the system to realize the palette as though it had not previously been realized. The next time the application calls the RealizePalette function for the specified palette, the system completely remaps the logical palette to the system palette.
hgdiobj
Identifies the object to be reset.
The return value is nonzero if the function is successful. Otherwise, it is zero.
The UnrealizeObject function should not be used with stock objects.
The UnrealizeObject function must be called whenever a new brush origin is set (by using the SetBrushOrg function).
A brush identified by the hgdiobj parameter must not be the currently selected brush of any device context.
A palette identified by hgdiobj can be the currently selected palette of a device context.
The following example uses the SetBrushOrg function to set the origin coordinates of the current brush to (3,5), uses the SelectObject function to remove that brush from the device context, uses the UnrealizeObject function to force the system to reset the origin of the specified brush, and then calls SelectObject again to select the brush into the device context with the new brush origin:
HBRUSH hbr, hbrOld;
SetBkMode(hdc, TRANSPARENT);
hbr = CreateHatchBrush(HS_CROSS, RGB(0, 0, 0));
UnrealizeObject(hbr);
SetBrushOrg(hdc, 0, 0);
hbrOld = SelectObject(hdc, hbr);
Rectangle(hdc, 0, 0, 200, 200);
hbr = SelectObject(hdc, hbrOld); /* deselects hbr */
UnrealizeObject(hbr); /* resets origin next time hbr selected */
SetBrushOrg(hdc, 3, 5);
hbrOld = SelectObject(hdc, hbr); /* selects hbr again */
Rectangle(hdc, 0, 0, 200, 200);
SelectObject(hdc, hbrOld);
DeleteObject(hbr);