<<

Contents

Search

>>

 

FILLRECT

 

 

Function

 

 

Syntax:

FILLRECT(<Row>,<Column>,<Height in Rows>,<Width in Columns>,<Red>,<Green>,<Blue>[,<Handle>])

 

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Height in Rows>

= <NUM-EXPRESSION>

<Width in Columns>

= <NUM-EXPRESSION>

<Red>

= <NUM-EXPRESSION>

<Green>

= <NUM-EXPRESSION>

<Blue>

= <NUM-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Fills a rectangle on the screen with color <Red>,<Green>,<Blue>.

 

<Row> and <Column> specify the upper left corner and <Height in Rows> and <Width in Columns> specify the height and width of the rectangle in rows and columns.

 

If <Red> < 0 or <Green> < 0 or <Blue> < 0, a rectangle of the same size previously drawn at the same position is deleted again.

 

<Handle> specifies to which window the instruction refers. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing, the instruction refers to the current mask.

 

FILLRECT returns the result –1, if a not existing rectangle is to be deleted, otherwise always 1.

 

Attention: In Html programs 1 is returned when NOREPAINT is active.

 

Parameter:

Row

Row of upper left corner of the rectangle

Column

Column of upper left corner of the rectangle

Height in Rows

Height of rectangle in rows

Width in Columns

Width of rectangle in columns

Red

Red value

Green

Green value

Blue

Blue value

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

Sample:

/* Red rectangle on position 3,2.5

H% = FILLRECT(3,2.5,3.5,30,255,0,0)

...

/* Delete the rectangle

H% = FILLRECT(3,2.5,3.5,30,-1,-1,-1)

 

See also:

LPFILLRECT

FILLRECT_GRADIENT

CIRCLE

POLYGON

DRAWLINE

DRAWRECT