Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Chord function

The Chord function draws a chord (a region bounded by the intersection of an ellipse and a line segment, called a secant). The chord is outlined by using the current pen and filled by using the current brush.

Syntax


BOOL Chord(
  _In_ HDC hdc,
  _In_ int nLeftRect,
  _In_ int nTopRect,
  _In_ int nRightRect,
  _In_ int nBottomRect,
  _In_ int nXRadial1,
  _In_ int nYRadial1,
  _In_ int nXRadial2,
  _In_ int nYRadial2
);

Parameters

hdc [in]

A handle to the device context in which the chord appears.

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.

nXRadial1 [in]

The x-coordinate, in logical coordinates, of the endpoint of the radial defining the beginning of the chord.

nYRadial1 [in]

The y-coordinate, in logical coordinates, of the endpoint of the radial defining the beginning of the chord.

nXRadial2 [in]

The x-coordinate, in logical coordinates, of the endpoint of the radial defining the end of the chord.

nYRadial2 [in]

The y-coordinate, in logical coordinates, of the endpoint of the radial defining the end of the chord.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The curve of the chord is defined by an ellipse that fits the specified bounding rectangle. The curve begins at the point where the ellipse intersects the first radial and extends counterclockwise to the point where the ellipse intersects the second radial. The chord is closed by drawing a line from the intersection of the first radial and the curve to the intersection of the second radial and the curve.

If the starting point and ending point of the curve are the same, a complete ellipse is drawn.

The current position is neither used nor updated by Chord.

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
AngleArc
Arc
ArcTo
Pie

 

 

Community Additions

Show:
© 2015 Microsoft