1: /**
   2:  *
   3:  * $Id: List.h,v 1.2 2000/09/23 14:51:40 amai Exp $
   4:  *
   5:  * Copyright (C) 1995 Free Software Foundation, Inc.
   6:  * Copyright (C) 1995-2000 LessTif Development Team
   7:  *
   8:  * This file is part of the GNU LessTif Library.
   9:  *
  10:  * This library is free software; you can redistribute it and/or
  11:  * modify it under the terms of the GNU Library General Public
  12:  * License as published by the Free Software Foundation; either
  13:  * version 2 of the License, or (at your option) any later version.
  14:  *
  15:  * This library is distributed in the hope that it will be useful,
  16:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18:  * Library General Public License for more details.
  19:  *
  20:  * You should have received a copy of the GNU Library General Public
  21:  * License along with this library; if not, write to the Free
  22:  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23:  *
  24:  **/
  25: 
  26: #ifndef _XM_LIST_H
  27: #define _XM_LIST_H
  28: 
  29: #include <Xm/Xm.h>
  30: 
  31: #ifdef __cplusplus
  32: extern "C" {
  33: #endif
  34: 
  35: extern WidgetClass xmListWidgetClass;
  36: 
  37: typedef struct _XmListRec *XmListWidget;
  38: typedef struct _XmListClassRec *XmListWidgetClass;
  39: 
  40: #ifndef XmIsList
  41: #define XmIsList(w) XtIsSubclass((w), xmListWidgetClass)
  42: #endif
  43: 
  44: /* selection type values */ 
  45: 
  46: enum {
  47:     XmINITIAL,
  48:     XmMODIFICATION,
  49:     XmADDITION 
  50: };
  51: 
  52: extern Widget XmCreateList(Widget parent,
  53:          char *name,
  54:          Arg *arglist,
  55:          Cardinal argCount);
  56: extern Widget XmCreateScrolledList(Widget parent,
  57:            char *name,
  58:            Arg *arglist,
  59:            Cardinal argCount);
  60: extern void XmListAddItem(Widget widget,
  61:         XmString item,
  62:         int position);
  63: extern void XmListAddItems(Widget widget,
  64:          XmString *items,
  65:          int item_count,
  66:          int position);
  67: extern void XmListAddItemUnselected(Widget widget,
  68:             XmString item,
  69:             int position);
  70: extern void XmListAddItemsUnselected(Widget widget,
  71:              XmString *items,
  72:              int item_count,
  73:              int position);
  74: extern void XmListDeleteAllItems(Widget widget);
  75: extern void XmListDeleteItem(Widget widget,
  76:            XmString item);
  77: extern void XmListDeleteItems(Widget widget,
  78:             XmString *items,
  79:             int item_count);
  80: extern void XmListDeleteItemsPos(Widget widget,
  81:          int item_count,
  82:          int position);
  83: extern void XmListDeletePos(Widget widget,
  84:           int position);
  85: extern void XmListDeletePositions(Widget widget,
  86:           int *position_list,
  87:           int position_count);
  88: extern void XmListDeselectAllItems(Widget widget);
  89: extern void XmListDeselectItem(Widget widget,
  90:              XmString item);
  91: extern void XmListDeselectPos(Widget widget,
  92:             int position);
  93: extern int XmListGetKbdItemPos(Widget widget);
  94: extern Boolean XmListGetMatchPos(Widget widget,
  95:          XmString item,
  96:          int **position_list,
  97:          int *position_count);
  98: extern Boolean XmListGetSelectedPos(Widget widget,
  99:             int **position_list,
 100:             int *position_count);
 101: extern Boolean XmListItemExists(Widget widget,
 102:         XmString item);
 103: extern int XmListItemPos(Widget widget,
 104:        XmString item);
 105: extern Boolean XmListPosSelected(Widget widget,
 106:          int position);
 107: extern Boolean XmListPosToBounds(Widget widget,
 108:          int position,
 109:          Position *x,
 110:          Position *y,
 111:          Dimension *width,
 112:          Dimension *height);
 113: extern void XmListReplaceItems(Widget widget,
 114:              XmString *old_items,
 115:              int item_count,
 116:              XmString *new_items);
 117: extern void XmListReplaceItemsPos(Widget widget,
 118:           XmString *new_items,
 119:           int item_count,
 120:           int position);
 121: extern void XmListReplaceItemsPosUnselected(Widget widget,
 122:               XmString *new_items,
 123:               int item_count,
 124:               int position);
 125: extern void XmListReplaceItemsUnselected(Widget widget,
 126:            XmString *old_items,
 127:            int item_count,
 128:            XmString *new_items);
 129: extern void XmListReplacePositions(Widget widget,
 130:            int *position_list,
 131:            XmString *item_list,
 132:            int item_count);
 133: extern void XmListSelectItem(Widget widget,
 134:            XmString item,
 135:            Boolean notify);
 136: extern void XmListSelectPos(Widget widget,
 137:           int position,
 138:           Boolean notify);
 139: extern void XmListSetAddMode(Widget widget,
 140:            Boolean mode);
 141: extern void XmListSetBottomItem(Widget widget,
 142:         XmString item);
 143: extern void XmListSetBottomPos(Widget widget,
 144:              int position);
 145: extern void XmListSetHorizPos(Widget widget,
 146:             int position);
 147: extern void XmListSetItem(Widget widget,
 148:         XmString item);
 149: extern Boolean XmListSetKbdItemPos(Widget widget,
 150:            int position);
 151: extern void XmListSetPos(Widget widget,
 152:        int position);
 153: extern void XmListUpdateSelectedList(Widget widget);
 154: extern int XmListYToPos(Widget widget,
 155:       Position y);
 156: 
 157: 
 158: #ifdef __cplusplus
 159: }
 160: #endif
 161: 
 162: #endif /* _XM_LIST_H */
 163: