MWAPI - TOPSHOW

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

TOPSHOW specifies which choice is displayed at the top of the visible area of certain gadget types that display choices. If the user scrolls the choices, the value of TOPSHOW changes.

If the application assigns a value to TOPSHOW, the list of choices may scroll.

If the value assigned to TOPSHOW exactly matches an item subscript specified for the gadget, the choice identified by that item subscript is displayed at the top of the visible area.

If the application assigns a value to TOPSHOW which does not exactly match an item subscript specified for the gadget, the choice identified by the first item subscript that follows (in the collation sequence of ^$WINDOW) the specified TOPSHOW value is displayed at the top of the visible area. TOPSHOW is then set to that item value.

If the application assigns a value to TOPSHOW which does not exactly match an item subscript specified for the gadget and which is not followed (in the collation sequence of ^$WINDOW) by any item subscript specified for the gadget, the list of choices scrolls (if necessary) so that the last choice in the list is displayed in the visible area. TOPSHOW is then set to the item displayed at the top of the visible area.