iBorder (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Lightness of black color

iChangeSubReportSource

iCreateFont (Example)

iDocumentCanceled (Example)

iInitReportQuery (Example)

iInitReportQuery

iInitReportQueryConnection

iPageHeight (Example)

iParameterPDF (Example)

iPrintAreaRTF (Example)

iPrintImage (Example)

iPrintImage

iPrintPDF

iPrintReport (Example)

iReportPrintingStatus

iSequencingAddDiagram

iZoneHeight (Example)

Lightness of black color
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iBorder (Function)

In french: iCadre

Prints a border at specified coordinates.

Remark: The origin (0,0) is located in the upper-left corner of the sheet. It takes the physical margins of the printer into account.

Example

See additional examples

iPrint(iXPos(50) + CU.CUSTNAME)
// Encloses the text in a line equal to 2 Pica point
// The border background is 50% gray
iBorder(0, 0, iPageWidth(), 10, 2, 50)

Syntax

iBorder(<X1> , <Y1> , <X2> , <Y2> [, <Thickness> [, <Fill> [, <Color> [, <Line> [, <Brush> [, <Border>]]]]]])

<X1>: Real

Horizontal coordinate of the upper-left corner of the border (in millimeters). This corner defines the external side of the border.
Value included 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 included 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 included 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 included between 0 and the page height (returned by iPageHeight).

<Thickness>: Optional real

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

Caution: Depending on the value of this parameter, the thickness is achieved by adding several lines next to each others from the outside to the inside.

This parameter must correspond to an integer value. Otherwise, the thickness will be rounded to the nearest integer value.

<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 value): no fill.
Equal to 100: entirely filled with the specified color.
Less than 100: the closer this parameter is to 0, the more the color brightens.
Greater than 100: the closer this parameter is to 200, the more the color darkens.

<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
This parameter is ignored.

<Border>: Optional integer constant

Sides of the border to draw:
iBorderAll
(Default value) All the border sides are drawn
iBorderBottom The bottom side is drawn.
iBorderLeft The left side is drawn
iBorderNone The border has no side
iBorderRight The right side is drawn
iBorderTop The top side is drawn

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.

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: wd270prn.dll