dwtlistboxsetpos(3dwt) [ultrix man page]

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)

XmListPosToBounds(library call) 										   XmListPosToBounds(library call)

NAME

       XmListPosToBounds -- A List function that returns the bounding box of an item at a specified position in a list

SYNOPSIS

       #include <Xm/List.h>
       Boolean XmListPosToBounds(
       Widget widget,
       int position,
       Position *x,
       Position *y,
       Dimension *width,
       Dimension *height);

DESCRIPTION

       XmListPosToBounds returns the coordinates of an item within a list and the dimensions of its bounding box. The function returns the associ-
       ated x and y-coordinates of the upper left corner of the bounding box relative to the upper left corner of the List widget, as well as  the
       width  and  the	height	of the box. The caller can pass a NULL value for the x, y, width, or height parameters to indicate that the return
       value for that parameter is not requested.

       widget	 Specifies the ID of the List widget.

       position  Specifies the position of the specified item.	A value of 1 indicates the first item in the list; a value of 2 indicates the sec-
		 ond item; and so on. A value of 0 (zero) specifies the last item in the list.

       x	 Specifies a pointer to the returned x-coordinate of the item.

       y	 Specifies the pointer to the returned y-coordinate of the item.

       width	 Specifies the pointer to the returned width of the item.

       height	 Specifies the pointer to the returned height of the item.

       For a complete definition of List and its associated resources, see XmList(3).

RETURN

       If  the item at the specified position is not visible, returns False, and the returned values (if any) are undefined. Otherwise, this func-
       tion returns True.

RELATED

       XmList(3) and XmListYToPos(3).

														   XmListPosToBounds(library call)