GetBrushOrgEx
The GetBrushOrgEx
function retrieves the current brush origin for the specified device context.
This function replaces the GetBrushOrg function.
BOOL GetBrushOrgEx(
|
HDC hdc, |
// handle of device
context |
|
LPPOINT lppt |
// address of
structure of coordinates |
|
); |
|
Parameters
hdc
Identifies
the device context.
lppt
Points to a POINT structure that receives the
brush origin, in device coordinates.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
A brush is a
bitmap that Windows uses to paint the interiors of filled shapes.
The brush
origin is a set of coordinates with values between 0 and 7, specifying the
location of one pixel in the bitmap. The default brush origin coordinates are
(0,0). For horizontal coordinates, the value 0 corresponds to the leftmost
column of pixels; the value 7 corresponds to the rightmost column. For vertical
coordinates, the value 0 corresponds to the uppermost row of pixels; value 7
corresponds to the lowermost row. When Windows positions the brush at the start
of any painting operation, it maps the origin of the brush to the location in
the window s client area specified by the brush origin. For example, if the
origin is set to (2,3), Windows maps the origin of the brush (0,0) to the
location (2,3) on the window s client area.
If an
application uses a brush to fill the backgrounds of both a parent and a child
window with matching colors, it may be necessary to set the brush origin after
painting the parent window but before painting the child window.
Windows
NT: The operating system
automatically tracks the origin of all window-managed device contexts and
adjusts their brushes as necessary to maintain an alignment of patterns on the
surface.
Windows
95: Automatic tracking of the brush
origin is not supported. Applications must use the UnrealizeObject, SetBrushOrgEx,
and SelectObject functions to align the brush before using it.
See Also