|
|
KnoppMyth 5.5 (Default branch)
07-08-2008
|
|
DwtListBoxSetPos(3Dwt) DwtListBoxSetPos(3Dwt) Name DwtListBoxSetPos - Makes a specified position (item number in the list) the top visible position in a list box, or as close to the top as possible. Syntax void DwtListBoxSetPos(widget, position) Widget widget; int position; Arguments widget Specifies the ID of the list box widget whose specified item number in the list you want displayed in the top position. position Specifies the item number in the list displayed in the top position in the list box. Description The DwtListBoxSetPos function makes the specified position (the item number in the list) the top visible position in a list box. The func- tion determines which item in the list box is displayed at the top of the list box, the choice of which is limited by the DwtNitemsCount and DwtNvisibleItemsCount attributes to the list box widget. When DwtNvisibleItemsCount is greater than 1 and less than DwtNitemsCount, the list box widget fills the list box with the maximum visible items regardless of the position value. For example, if DwtNitemsCount is 10 and DwtNvisibleItemsCount is 5, you cannot make item 8 be displayed at the top of the list box. Instead, items 6 through 10 would be displayed. Setting position to 4 would make items 4 through 8 be displayed. If DwtNvisibleItemsCount is 1, you can make any item in the list be displayed at the top of the list box. See Also Guide to the XUI Toolkit: C Language Binding Guide to the XUI Toolkit Intrinsics: C Language Binding DwtListBoxSetPos(3Dwt)