|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| Windows 95: 16-bit coordinates only
|
|
|
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
POINT, SelectObject, SetBrushOrgEx, UnrealizeObject
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
