gLine (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Graphic strings management functions

gLine

Presentation

Example

Coordinates

See also

gLine (Function)

In french: gLigne

Builds a sequence of characters containing a line.

This sequence of characters is used to draw a line:

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

// Draw a green line in an element of "LIST_Figure" control
ListAdd(LIST_Figure, gLine(0, 0, 25, 18, LightGreen))

Syntax

<Result> = gLine(<X1> , <Y1> , <X2> , <Y2> [, <Color>])

<Result>: Character string

Sequence of characters containing a line.
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 start point of the line.

<Y1>: Real

Y-coordinate (in pixels) of the start point of the line.

<X2>: Real

X-coordinate (in pixels) of the end point of the line. This ending point is not drawn.

<Y2>: Real

Y-coordinate (in pixels) of the end point of the line. This ending point is not drawn.

<Color>: Integer or constant (optional)

Line 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 color of the line corresponds to the color of the current text (defined by gPen).

Remarks

Coordinates

All the coordinates are expressed in pixels in relation to the upper-left corner of the element used (in relation to the upper-left corner of the row found in the List Box or Combo Box control for example).

Component: wd270mdl.dll