Ellipse function

The Ellipse function draws an ellipse. The center of the ellipse is the center of the specified bounding rectangle. The ellipse is outlined by using the current pen and is filled by using the current brush.

Syntax


BOOL Ellipse(
  _In_ HDC hdc,
  _In_ int nLeftRect,
  _In_ int nTopRect,
  _In_ int nRightRect,
  _In_ int nBottomRect
);

Parameters

hdc [in]

A handle to the device context.

nLeftRect [in]

The x-coordinate, in logical coordinates, of the upper-left corner of the bounding rectangle.

nTopRect [in]

The y-coordinate, in logical coordinates, of the upper-left corner of the bounding rectangle.

nRightRect [in]

The x-coordinate, in logical coordinates, of the lower-right corner of the bounding rectangle.

nBottomRect [in]

The y-coordinate, in logical coordinates, of the lower-right corner of the bounding rectangle.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The current position is neither used nor updated by Ellipse.

Examples

For an example, see Using Filled Shapes.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Filled Shapes Overview
Filled Shape Functions
Arc
ArcTo

 

 

Show: