2.3.10 Path Bracket Record Types

EMR_ABORTPATH

This record closes path bracket construction and discards the current path.

EMR_BEGINPATH

This record opens path bracket construction.

Once path bracket construction is open, an application can begin specifying records to define the points that lie in the path. Path bracket construction MUST be closed by an EMR_ABORTPATH or EMR_ENDPATH record.

When an application processes an EMR_BEGINPATH record, path bracket construction MUST NOT be open.

EMR_CLOSEFIGURE

This record closes the figure in path bracket construction.

Processing the EMR_CLOSEFIGURE record closes the figure by drawing a line from the current drawing position to the first point of the figure, and then it connects the lines by using the current line join. If the figure is closed by processing an EMR_LINETO record (section 2.3.5.13) instead of this record, the current line cap is used to create the corner instead of the line join. The line parameters are specified by the PenStyle field in the current LogPen (section 2.2.19) and LogPenEx (section 2.2.20) objects.

The EMR_CLOSEFIGURE record SHOULD be used only if there is an open figure in the path bracket. A figure in a path is open unless it is explicitly closed by processing this record. A figure can be open even if the current point is the same as the starting point.

After processing the EMR_CLOSEFIGURE record, adding a line or curve to the path bracket starts a new figure.

EMR_ENDPATH

This record closes path bracket construction and selects the path into the playback device context.

EMR_FLATTENPATH

This record transforms each curve in the current path into a sequence of lines.

EMR_WIDENPATH

This record redefines the current path as the area that would be painted if its path were drawn using the current pen.

Type

Size