00759: GUIBuilder Functions for Reading and Updating the Screen: Setting and Querying List Selections

Title:

GUIBuilder Functions for Reading and Updating the Screen: Setting and Querying List Selections

Description:

GUIBuilder Functions for Reading and Updating the Screen: 
Setting and Querying List Selections 

Values can be passed to list boxes and list buttons in a string that contains the complete list of items, delimited by line feeds. The following example would load the items “One”, “Two”, and “Three” in a list control: 

win.list_btn$=”One”+$0a$+”Two”+$0a$+”Three”+$0a$ 

In the GUIBuilder version that is shipped with Visual PRO/5 Rev. 2.20 and above, it is also possible to specify which item or items should be highlighted by appending string numerics to the list, delimited by $ff$ characters. Passing the following string with fngb__put_screen would cause the first and third items in the list to be highlighted (note that item numbering is zero-based): 

win.list_btn$=”One”+$0a$+”Two”+$0a$+”Three”+$0a$+$ff$+”0″+$ff$”+”2″ 

Likewise, after using fngb__get_screen to query a list control, the highlighted item or items will be indicated with a list of string numerics delimited by $ff$ characters. 

The highlighting functionality is dependent on $ff$ characters not being used in the list text. If this character does occur in the list, unpredictable results will occur. 

Last Modified: 02/05/2001 Product: Visual PRO/5 Operating System: Windows

BASIS structures five components of their technology into the BBx Generations.