Prev Next

Ellipse info  Overview  Group

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.

BOOL Ellipse(

    HDC hdc,

// handle to device context

    int nLeftRect,

// x-coord. of bounding rectangle’s upper-left corner

    int nTopRect,

// y-coord. of bounding rectangle’s upper-left corner

    int nRightRect,

// x-coord. of bounding rectangle’s lower-right corner

    int nBottomRect 

// y-coord. bounding rectangle’s f lower-right corner

   );

Parameters

hdc
Identifies the device context.
nLeftRect
Specifies the x-coordinate of the upper-left corner of the bounding rectangle.
nTopRect
Specifies the y-coordinate of the upper-left corner of the bounding rectangle.
nRightRect
Specifies the x-coordinate of the lower-right corner of the bounding rectangle.
nBottomRect
Specifies the y-coordinate of the lower-right corner of the bounding rectangle.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The current position is neither used nor updated by Ellipse.

Windows 95: The sum of the coordinates of the bounding rectangle cannot exceed 32,767. The sum of nLeftRect and nRightRect or nTopRect and nBottomRect parameters cannot exceed 32,767.

See Also

Arc, ArcTo