DOWN attribute

Indicates the number of iterations in a down frame that contain data or number of potential rows in a browse widget. For a one-down frame, the value of DOWN is 1. Sets the number of browse-rows that appear in the viewport.

Data type: INTEGER

Access: Readable/Writeable

Applies to: BROWSE widget, FRAME widget

In character mode, the DOWN attribute must be set before the browse is realized. Attempting to set the attribute after realization of the browse causes a run-time error.

If you change the value of a browse's DOWN attribute, you change the number of rows that appear in the viewport, which might change the value of the browse's HEIGHT-CHARS and HEIGHT-PIXELS attributes. Changing the value of a browse's DOWN attribute does not change the value of the browse's ROW-HEIGHT-CHARS and ROW-HEIGHT-PIXELS attributes.

Note: If the browse's height is set with the DOWN attribute and a browse column is added using the ADD-CALC-COLUMN( ), ADD-COLUMNS-FROM( ) or ADD-LIKE-COLUMN( ) methods, the browse's height may change to ensure that the number of DOWN is preserved.