LessTif Manual Page - Widget Classes

XmList

Synopsis

Description

Callback Resources

XmNautomaticSelection

When True calls XmNsingleSelectionCallback when mouse is moved into item

XmNfontList

A Fontlist used in the list

XmNitemCount

The number of items in the list

XmNitems

A pointer to an array of XmStrings that are the list items

XmNlistMarginHeight

Height of the border between the list and the list border

XmNlistMarginWidth

Widget of the border between the list and the list border

XmNlistSizePolicy

Determines the horizontal resize policy of the list

• XmCONSTANT - Add a scrollbar but do not grow
• XmVARIABLE - Grows list to match largest item
• XmRESIZE_IF_POSSIBLE - Grows if it can if not adds a scrollbar

XmNlistSpacing

The size of the space between items

XmNscrollBarDisplayPolicy

Determines whether the Scrollbar should be displayed

• XmAS_NEEDED - means draw scrollbar when needed
• XmAS_STATIC - always display scrollbar

XmNselectedItemCount

The number of items selected in the list

XmNselectedItems

A pointer to an array of selected items

XmNselectionPolicy

Determines the selection policy used.

• XmSINGLE_SELECT - you can only use the mouse to select a single item
• XmMULTIPLE_SELECT - you can use mouse and ctrl key to select multiple items
• XmEXTENDED_SELECT - you can use mouse and ctrl/shift to select multiple items
• XmBROWSE_SELECT - you can use drag and select items.

XmNstringDirection

Determines the direction to draw the string.

XmNtopItemPosition

Specify the item that is shown at the top of the list.

XmNvisibleItemCount

Specifies the number of items that will be visible.

Callback Structure

XmNsingleSelectionCallback

The singleSelectionCallback specifies a list of callbacks that are called when the mouse is clicked in the list widget The reason field of the callback structure has the value XmCR_SINGLE_SELECT

XmNbrowseSelectionCallback

The browseSelectionCallback specifies a list of callbacks that are called when the mouse is clicked in the list widget The reason field of the callback structure has the value XmCR_BROWSE_SELECT

XmNdefaultActionCallback

The defaultActionCallback specifies a list of callbacks that are called when the mouse is double clicked in the list widget The reason field of the callback structure has the value XmCR_DEFAULT_ACTION

XmNextendedSelectionCallback

The extendedSelectionCallback specifies a list of callbacks that are called when the mouse is clicked in the list widget while the shift key is down The reason field of the callback structure has the value XmCR_EXTENDED_SELECT

XmNmultipleSelectionCallback

The multipleSelectionCallback specifies a list of callbacks that are called when the mouse is clicked in the list widget while the ctrl key is down The reason field of the callback structure has the value XmCR_MULTIPLE_SELECT

Callback Structure

typedef struct {
int reason;                   /* reason callback was called */
XEvent *event;                /* points to event structure */
XmString item;                /* item most recently selected */
int item_length;              /* number of bytes in item member */
int item_position;            /* item's position in XmNitems */
XmString *selected_items;     /* list of items selected */
int selected_item_count;      /* number of items in selected_items */
int *selected_item_positions; /* array of ints marking selected items */
int selection_type;           /* type of most recent selection */
} XmListCallbackStruct;

• XmPrimitive
  

  XmPrimitive Resources

  Name	Type	Default	Access
  XmNforeground	Pixel	_XmForegroundColorDefault	CSG
  XtNbackground	Pixel	_XmBackgroundColorDefault	CSG
  XmNbottomShadowColor	Pixel	_XmBottomShadowColorDefault	CSG
  XmNbottomShadowPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNtopShadowColor	Pixel	_XmTopShadowColorDefault	CSG
  XmNtopShadowPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNshadowThickness	Dimension	2	CSG
  XmNhighlightColor	Pixel	_XmHighlightColorDefault	CSG
  XmNhighlightOnEnter	Boolean	False	CSG
  XmNhighlightPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNhighlightThickness	Dimension	2	CSG
  XmNnavigationType	XmNavigationType	XmNONE	CSG
  XmNtraversalOn	Boolean	True	CSG
  XmNunitType	unsigned char	0	CSG
  XmNuserData	XtPointer	NULL	CSG
  XmNhelpCallback	XtCallbackList	NULL	C

  
  
• Core
  

  Core Resources

  Name	Type	Default	Access
  XmNaccelerators	XmString	XmUNSPECIFIED	CSG
  XmNancestorSensitive	Boolean	TRUE	G
  XmNbackground	Pixel	_XmBackgroundColorDefault	CSG
  XmNbackgroundPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNborderColor	Pixel	Black	CSG
  XmNborderPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNborderWidth	int	1	CSG
  XmNcolormap	Colormap	XmUNSPECIFIED	CG
  XmNdepth	int	1	CSG
  XmNdestroyCallback	XtCallbackList	NULL	C
  XmNheight	Dimension	0	CSG
  XmNmappedWhenManaged	Boolean	TRUE	CSG
  XmNscreen	Screen *	0	CG
  XmNsensitive	Boolean	True	CSG
  XmNtranslations	XtTranslations	NULL	CSG
  XmNwidth	Dimension	0	CSG
  XmNx	Position	0	CSG
  XmNy	Position	0	CSG

  
  

ListAddMode()

ListBeginData()

ListBeginDataExtend()

ListBeginExtend()

ListBeginLine()

ListBeginSelect()

ListBeginToggle()

ListButtonMotion()

ListCopyToClipboard()

ListEndData()

ListEndDataExtend()

ListEndExtend()

ListEndLine()

ListEndSelect()

ListEndToggle()

ListExtendNextItem()

ListExtendPrevItem()

ListKbdActivate()

ListKbdBeginExtend()

ListKbdBeginSelect()

ListKbdCancel()

ListKbdDeselectAll()

ListKbdEndExtend()

ListKbdEndSelect()

ListKbdSelectAll()

ListLeftChar()

ListLeftPage()

ListNextItem()

ListNextPage()

ListPrevItem()

ListPrevPage()

ListProcessDrag()

ListRightChar()

ListRightPage()

ListEnter()

ListLeave()

ListFocusIn()

ListFocusOut()

Widget XmCreateList(Widget Parent,char *Name,Arg *arglist,Cardinal count)

void XmListAddItem(Widget w,XmString item,int pos)
Add an item to the list

XmListAddItems(Widget w,XmString *items,int count,int pos)
Add an array of items to the list

XmListAddItemUnselected(Widget w,XmString item,int pos)
Add an item to the list unselected

XmListDeleteAllItems(Widget w)
Empty all the items from the list

XmListDeleteItem(Widget w,XmString item)
Delete the specified item from the list

XmListDeleteItems(Widget w,XmString *items,int count)
Delete an array of items from the list

XmListDeleteItemsPos(Widget w,int count,int pos)
Delete count items from position pos in the list

XmListDeletePos(Widget w,int pos)
Delete an item from position pos in the list

XmListDeselectAllItems(Widget w)
Deselect all the items in the list

XmListDeselectItem(Widget w,XmString item)
Deselect an Item from the list

XmListDeselectPos(Widget w,int pos)
Deselect an item at a position pos in the list

XmListGetMatchPos(Widget w,XmString item,int **pos,int *pos_count)
Get all matches of a string

XmListGetSelectedPos(Widget w,int **pos, int *pos_count)
Get all the selected items

XmListItemExists(Widget w,XmString item)
Find if an item exists in the list

XmListItemPos(Widget w,XmString item)
Find the position of an item in the list

XmListReplaceItems(Widget w,XmString *old,int item_count,XmString *new)
Replace the items in the list

XmListReplaceItemsPos(Widget w,XmString *new,int item_count, int pos)
Replace items from specified position

XmListSelectItem(Widget w,XmString item,Boolean notify)
Select the item in the list

XmListSelectPos(Widget w,int pos,Boolean notify)
Select the item at position pos

XmListSetAddMode(Widget w,Boolean mode)
Set the add mode of the list

XmListSetBottomItem(Widget w,XmString item)
Set the position of the last visible item.

XmListSetBottomPos(Widget w,int pos)
Set the position of the last visible item to position pos.

XmListSetHorizPos(Widget w,int pos)
Set the horizontal scrollbar of the list widget to pos

XmListSetItem(Widget w)
Set the position of the first visible item.

XmListSetPos(Widget w)
Set the position of the first visible item to position pos.