gCircle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Graphic string management functions

gCircle

Presentation

Example

Coordinates

Width/Height of rectangle

See also

gCircle (Function)

In french: gCercle

Builds a sequence of characters containing a circle or an ellipse.

In a window, this sequence of characters is used to draw a circle or an ellipse:

in an element of a List Box or Combo Box control.
in the title bar and/or status bar of a window.
in a Static control.

Example

Syntax

<Result> = gCircle(<X1> , <Y1> , <X2> , <Y2> [, <Background color> [, <Line color>]])

<Result>: Character string

Sequence of characters defining a circle or an ellipse.
This sequence of characters can be:
used in ListAdd, ListInsert or ListModify.
assigned to a Static control.
used in the title bar or status bar of a window.

<X1>: Real

X-coordinate (in pixels) of the upper-left corner of the rectangle containing the circle.

<Y1>: Real

Y-coordinate (in pixels) of the upper-left corner of the rectangle containing the circle.

<X2>: Real

X-coordinate (in pixels) of the lower-right corner of the rectangle containing the circle.

<Y2>: Real

Y-coordinate (in pixels) of the lower-right corner of the rectangle containing the circle.

<Background color>: Integer or constant (optional)

Circle background color. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.
If this parameter is not specified, the background color corresponds to the background color of the current text (defined by gBackground).

<Line color>: Integer or constant (optional)

Color of the circle line. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.
If this parameter is not specified, the color of the line corresponds to the color of the current text (defined by gPen).

Remarks

Coordinates

All coordinates are expressed in pixels in relation to the upper-left corner of the element used (row in the List Box or Combo Box control, title bar of the window, status bar of window or Static control).

Width/Height of rectangle

The width of the reference rectangle is set to <X2> - <X1>.

The height of the reference rectangle is set to <Y2> - <Y1>.

Component: wd270mdl.dll