GraphicsPath::SetMarker method

The GraphicsPath::SetMarker method designates the last point in this path as a marker point.

Syntax

Status SetMarker(

);

Parameters

This method has no parameters.

Return Value

Type: Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

A GraphicsPath object has an array of points and an array of types. Each element in the array of types is a byte that specifies the point type and a set of flags for the corresponding element in the array of points. Possible point types and flags are listed in the PathPointType enumeration.

Each time you add a line, curve, or shape to a path, the point array and the type array are expanded. When you call GraphicsPath::SetMarker, a marker flag is placed in the last byte of the type array. That flag designates the last point of the point array as a marker point.

Markers divide a path into sections. You can use a GraphicsPathIterator object to draw selected sections of a path.

Requirements

   
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdipluspath.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See Also

Clipping with a Region

Constructing and Drawing Paths

Creating a Path Gradient

GraphicsPath

GraphicsPath::CloseFigure

GraphicsPath::GetPathTypes

GraphicsPath::StartFigure

GraphicsPathIterator

GraphicsPathIterator::NextMarker Methods

GraphicsPathIterator::NextSubpath Methods

Paths