FixBrushOrgEx() and Brush Origins under Win32s

• Microsoft Win32s versions 1.15, 1.15a, and 1.2

FixBrushOrgEx() is not implemented in the Win32 API, but it is provided for compatibility with Win32s. If called, the function does nothing, and returns FALSE.

A brush's origin relates to the origin of the window being painted. If you move a window, the brush origin needs to be updated or else newly painted patterns won't line up with the old patterns. On Windows version 3.1, the system does not automatically update the brush origin when it is selected into a device context (DC), so applications have to call SetBrushOrg(). On Windows NT, the system automatically fixes brush origins when necessary.

Win32s uses FixBrushOrgEx() to hide this difference in system behavior. On Win32s, FixBrushOrgEx() calls SetBrushOrgEx(). A Win32-based application can check the platform and call SetBrushOrgEx() only if it is Win32s, or it could simply always call FixBrushOrgEx() wherever a Windows-based application would call SetBrushOrg() for brush origin tracking.