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,
);

```

## 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.

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

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

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

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] Windows 2000 Server [desktop apps only] Wingdi.h (include Windows.h) Gdi32.lib Gdi32.dll