Set Number of Rows - GRID SENDMSG() Function 67

Syntax

ROWS$=SENDMSG(sysgui,id,67,rows,$${,context{,ERR=lineref}})

Description

For BBj-specific documentation, see Set Number of Rows - GRID SENDMSG() Function 67 BBj.

This function sets the number of rows in the specified grid control.

Parameter

Description

sysgui

SYSGUI channel.

id

Grid control ID.

67

Number of this SENDMSG() function.

rows

Number of rows. Valid values are 0 to 2,100,000,000. (Column numbers are zero-based.)

$$

Always null.

This function is valid only for main grids (heading grids are automatically updated if they exist). This function does not change the size of the grid control, so reducing the number of rows may cause the bottom part of the grid's space to go blank.

The return value is a binary representation of the number of rows set by this function. Use DEC(ROWS$) to get the numeric representation.

Example

The following example creates a grid with three rows and reduces the number of rows to two:

sysgui=unt; open (sysgui)"X0"
print (sysgui)'window'(0,20,650,120,"Grid Sample",$00000082$,$FF$)
print (sysgui)'grid'(100,20,20,580,74,$0866$,3,3,5,18,101,30,102)
rows$=sendmsg(sysgui,100,67,2,$$)
print dec($00$+rows$)
escape

See Also

BBjStandardGrid::setNumRows