EngFillPath function (winddi.h)

The EngFillPath function fills a path.

Syntax

ENGAPI BOOL EngFillPath(
       SURFOBJ  *pso,
       PATHOBJ  *ppo,
       CLIPOBJ  *pco,
       BRUSHOBJ *pbo,
       POINTL   *pptlBrushOrg,
  [in] MIX      mix,
  [in] FLONG    flOptions
);

Parameters

pso

Pointer to a SURFOBJ structure that describes the surface on which to draw.

ppo

Pointer to a PATHOBJ structure that defines the path to be filled. Use the PATHOBJ_Xxx service routines to enumerate the lines, Bezier curves, and other data that make up the path.

pco

Pointer to a CLIPOBJ structure. Use the CLIPOBJ_Xxx service routines to enumerate the clip region as a set of rectangles.

pbo

Pointer to a BRUSHOBJ structure that defines the pattern and colors with which to fill.

pptlBrushOrg

Pointer to a POINTL structure defining the brush origin to use to align the brush pattern on the device.

[in] mix

Defines the foreground and background raster operations to use for the brush.

[in] flOptions

Specifies the mode to use when filling the path. This value should be FP_WINDINGMODE or FP_ALTERNATEMODE. All other flags should be ignored. For more information about these modes, see Path Fill Modes.

Return value

The return value is TRUE if GDI is able to fill the path. Otherwise, it is FALSE, and an error code is not logged. If an error is encountered, the return value is FALSE, and an error code is logged.

Remarks

Whenever GDI fills a path on a device-managed surface, it can call this entry point depending on a comparison of the fill requirements and the following GCAPS bits: GCAPS_BEZIERS, GCAPS_ALTERNATEFILL, and GCAPS_WINDINGFILL.

Requirements

See also

BRUSHOBJ

CLIPOBJ

PATHOBJ

SURFOBJ