gCircle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Coordinates
Width/Height of rectangle
Component

WINDEV

WEBDEV

WINDEV Mobile

Others

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.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 22 and later

This function is now available in the code of stored procedures.

This function is now available for iPhone/iPad applications.

This function is now available for WEBDEV sites in Linux.

This function is now available for WEBDEV sites in Windows.

New in version 22

This function is now available in the code of stored procedures.

This function is now available for iPhone/iPad applications.

This function is now available for WEBDEV sites in Linux.

This function is now available for WEBDEV sites in Windows.

This function is now available in the code of stored procedures.

This function is now available for iPhone/iPad applications.

This function is now available for WEBDEV sites in Linux.

This function is now available for WEBDEV sites in Windows.

Example

// Draw a circle in an element of the "LIST_ShapeList" List Box
// The circle background is light green and the borders are light yellow
ListAdd(LIST_ShapeList, gCircle(0, 0, 25, 18, LightGreen, LightYellow))

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.
This sequence of characters is not interpreted by the controls in WEBDEV. This function can be used to format the string returned by a WEBDEV Webservice consumed by a WINDEV or WINDEV Mobile application.

<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

Until version 21, gCircle was available in the wdxxxobj component. From version 22, this function is now available in the wdxxxmdl component.

Component: wd270mdl.dll