PATHOBJ_vEnumStartClipLines function

The PATHOBJ_vEnumStartClipLines function allows the driver to request lines to be clipped against a specified clip region.

Syntax


VOID PATHOBJ_vEnumStartClipLines(
   PATHOBJ   *ppo,
   CLIPOBJ   *pco,
   SURFOBJ   *pso,
   LINEATTRS *pla
);

Parameters

ppo

Pointer to the PATHOBJ structure that describes the specified clipping object.

pco

Pointer to a CLIPOBJ structure that describes the clip region.

pso

Pointer to a SURFOBJ structure that GDI queries to retrieve information about styling steps.

pla

Pointer to a LINEATTRS structure that GDI queries to retrieve line width and styling information.

Return value

None

Remarks

This function is useful when the clip region is more complex than a simple rectangle.

PATHOBJ_vEnumStartClipLines performs calculations for cosmetic wide lines. If the LINEATTRS structure needs a cosmetic wide line, the enumeration walks the given path as many times as needed to complete the widened figure.

This function should not be called for geometric wide lines or paths that contain Bezier curves.

Once begun, this enumeration process should not be restarted.

Requirements

Target platform

Universal

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

CLIPOBJ
LINEATTRS
PATHOBJ
SURFOBJ

 

 

Send comments about this topic to Microsoft

Show: