Chord

The Chord function draws an elliptical chord (a region bounded by the intersection of an ellipse and a line segment).

The curve of the chord is defined by the ellipse formed by the given bounding rectangle. The bounding rectangle is specified by the points (nLeftRect, nTopRect) and (nRightRect, nBottomRect). The curve extends counterclockwise from the point where it intersects the radial line from the center of the bounding rectangle to (nXStartLine, nYStartLine). The curve ends where it intersects the radial line from the center of the bounding rectangle to (nXEndLine, nYEndLine). A line is drawn between the ends of the curve to create the chord. If the start-point and end-point of the curve are the same, a complete ellipse is drawn.

The chord is drawn using the current pen and filled with the current brush.

Parameters

hdc

Identifies the device context in which the chord will appear.

nLeftRect

Specifies the logical x-coordinate of the bounding rectangle's upper-left corner.

nTopRect

Specifies the logical y-coordinate of the bounding rectangle's upper-left corner.

nRightRect

Specifies the logical x-coordinate of the bounding rectangle's lower-right corner.

nBottomRect

Specifies the logical y-coordinate of the bounding rectangle's lower-right corner.

nXStartLine

Specifies the logical x-coordinate of the end-point of the radial line defining the start-point of the chord.

nYStartLine

Specifies the logical y-coordinate of the end-point of the radial line defining the start-point of the chord.

nXEndLine

Specifies the logical x-coordinate of the end-point of the radial line defining the end-point of the chord.

nYEndLine

Specifies the logical y-coordinate of the end-point of the radial line defining the end-point of the chord.

Return Value

The return value specifies whether or not the chord is drawn. It is TRUE if the chord is drawn. Otherwise, it is FALSE.

Comments

The current position is neither used nor updated by this function.

See Also

AngleArc, Arc, ArcTo, Pie