SetMiterLimit function (wingdi.h)

The SetMiterLimit function sets the limit for the length of miter joins for the specified device context.

Syntax

BOOL SetMiterLimit(
  [in]  HDC    hdc,
  [in]  FLOAT  limit,
  [out] PFLOAT old
);

Parameters

[in] hdc

Handle to the device context.

[in] limit

Specifies the new miter limit for the device context.

[out] old

Pointer to a floating-point value that receives the previous miter limit. If this parameter is NULL, the previous miter limit is not returned.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The miter length is defined as the distance from the intersection of the line walls on the inside of the join to the intersection of the line walls on the outside of the join. The miter limit is the maximum allowed ratio of the miter length to the line width.

The default miter limit is 10.0.

Note  Setting eNewLimit to a float value less than 1.0f will cause the function to fail.
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

ExtCreatePen

GetMiterLimit

Path Functions

Paths Overview