1500 characters remaining

# 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

Filled Shapes Overview
Filled Shape Functions
AngleArc
Arc
ArcTo
Pie