iRoundBorder (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Print functions

Lightness of black color
Printing in HTML or RTF format
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iRoundBorder (Function)

In french: iCadreArrondi

Prints a border with rounded outlines at specified coordinates.

Note The origin (0,0) is located in the top left-hand corner of the sheet. It takes the physical margins of the printer into account.

Example

// Début d'impression : Impression directe
iDestination(iPrinter)
// Impression d'une ellipse
iRoundBorder(50, 50, 130, 150, 10, 10, 1, 100, RGB(0,0,0), iDotted, iDownwardDiagonal)
// Termine l'impression
iEndPrinting()

Syntax

iRoundBorder(<X1> , <Y1> , <X2> , <Y2> , <Width of sides> , <Height of sides> [, <Thickness> [, <Fill> [, <Color> [, <Line> [, <Brush>]]]]])

<X1>: Real

Horizontal coordinate of the upper-left corner of the border (in millimeters). This corner defines the external side of the border.
Value between 0 and the page width (returned by iPageWidth).

<Y1>: Real

Vertical coordinate of the upper-left corner of the border (in millimeters). This corner defines the external side of the border.
Value between 0 and the page height (returned by iPageHeight).

<X2>: Real

Horizontal coordinate of the lower-right corner of the border (in millimeters). This corner defines the external side of the border.
Value between 0 and the page width (returned by iPageWidth).

<Y2>: Real

Vertical coordinate of the lower-right corner of the border (in millimeters). This corner defines the external side of the border.
Value between 0 and the page height (returned by iPageHeight).

<Width of sides>: Real

Width of border sides in millimeters. Corresponds to the width of border onto which the rounding is applied.

<Height of sides>: Real

Height of border sides in millimeters. Corresponds to the height of border onto which the rounding is applied.

<Thickness>: Optional real

Thickness of border line (in picas). Default value = 1 (one Pica = 0.353 mm).

Attention Depending on the value of this parameter, the thickness is obtained by adding several lines side by side from outside to inside.

<Fill>: Optional integer (included between 1 and 200)

Rate for the line color and for the background color. If this parameter is:
Equal to 0 (default): no filling.
Equal to 100: full filling with the specified color.
Less than 100: the closer this parameter is to 0, the lighter the color.
Greater than 100: the closer this parameter gets to 200 the darker the color is.

<Color>: Optional integer

Color used for the background and for the border. If this parameter is not specified, the color used is black.
This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.

<Line>: Optional integer constant

Type of line.
iContinuous
(default value) Solid line
iDashed Dashed line (-----)
iDotAndDash Dot-and-dash line (-.-.)
iDotted Dotted line (....)

<Brush>: Optional integer constant

Pattern used to fill the border.
iCrossed Crossed lines.
iDiagonalCrossed Diagonal crossed lines.
iDownwardDiagonal Descending diagonal lines.
iHorizontal Horizontal lines.
iSolid
(default value) Entire fill.
iUpwardDiagonal Ascending diagonal lines.
iVertical Vertical lines.

Remarks

Lightness of black color

For the black color, the rate corresponds to a rate of gray whose values are included between 1 (white) and 100 (solid black). In this case, the values greater than 100 will be processed like the value 100.

Printing in HTML or RTF format

Rounded borders are not printed when printing to files in HTML or RTF format. They are replaced with standard borders.

Miscellaneous

The cursor position is not modified when the outline is drawn.
The dotted type (iDotted) or the mixed type (iDotAndDash) combined with a thick border may produce unpleasant effects.

Component: wd300prn.dll