Edit

Share via

ID2D1RenderTarget::DrawEllipse(constD2D1_ELLIPSE&,ID2D1Brush*,FLOAT,ID2D1StrokeStyle*) method (d2d1.h)

  • Article

Draws the outline of the specified ellipse using the specified stroke style.

Syntax

void DrawEllipse(
  const D2D1_ELLIPSE & ellipse,
  ID2D1Brush           *brush,
  FLOAT                strokeWidth,
  ID2D1StrokeStyle     *strokeStyle
);

Parameters

ellipse

Type: [in] const D2D1_ELLIPSE &

The position and radius of the ellipse to draw, in device-independent pixels.

brush

Type: [in] ID2D1Brush*

The brush used to paint the ellipse's outline.

strokeWidth

Type: [in] FLOAT

The width of the stroke, in device-independent pixels. The value must be greater than or equal to 0.0f. If this parameter isn't specified, it defaults to 1.0f. The stroke is centered on the line.

strokeStyle

Type: [in, optional] ID2D1StrokeStyle*

The style of stroke to apply to the ellipse's outline, or NULL to paint a solid stroke.

Return value

None

Remarks

The DrawEllipse method doesn't return an error code if it fails. To determine whether a drawing operation (such as DrawEllipse) failed, check the result returned by the ID2D1RenderTarget::EndDraw or ID2D1RenderTarget::Flush methods.

Examples

For an example, see How to Draw and Fill a Basic Shape.

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1.h
Library D2d1.lib
DLL D2d1.dll

See also

ID2D1RenderTarget