List.h
上传用户:lctgjx
上传日期:2022-06-04
资源大小:8887k
文件大小:7k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. /* $Xorg: List.h,v 1.4 2001/02/09 02:03:44 xorgcvs Exp $ */
  2. /*
  3. Copyright 1989, 1994, 1998  The Open Group
  4. Permission to use, copy, modify, distribute, and sell this software and its
  5. documentation for any purpose is hereby granted without fee, provided that
  6. the above copyright notice appear in all copies and that both that
  7. copyright notice and this permission notice appear in supporting
  8. documentation.
  9. The above copyright notice and this permission notice shall be included in
  10. all copies or substantial portions of the Software.
  11. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  12. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  13. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  14. OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  15. AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  16. CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  17. Except as contained in this notice, the name of The Open Group shall not be
  18. used in advertising or otherwise to promote the sale, use or other dealings
  19. in this Software without prior written authorization from The Open Group.
  20. */
  21. /* $XFree86: xc/lib/Xaw/List.h,v 1.7 2001/01/17 19:42:27 dawes Exp $ */
  22. /*  This is the List widget, it is useful to display a list, without the
  23.  *  overhead of having a widget for each item in the list.  It allows 
  24.  *  the user to select an item in a list and notifies the application through
  25.  *  a callback function.
  26.  *
  27.  * Created:  8/13/88
  28.  * By: Chris D. Peterson
  29.  *                      MIT X Consortium
  30.  */
  31. #ifndef _XawList_h
  32. #define _XawList_h
  33. #include <X11/Xaw/Simple.h>
  34. /* Resources:
  35.  Name      Class RepType Default Value
  36.  ----      ----- ------- -------------
  37.  background      Background Pixel XtDefaultBackground
  38.  borderColor      BorderColor Pixel XtDefaultForeground
  39.  borderWidth      BorderWidth Dimension 1
  40.  callback            Callback           XtCallbackList  NULL       **6
  41.  columnSpacing       Spacing            Dimension       6
  42.  cursor      Cursor Cursor left_ptr
  43.  cursorName      Cursor String NULL
  44.  defaultColumns      Columns            int             2          **5
  45.  destroyCallback     Callback Pointer NULL 
  46.  font      Font XFontStruct* XtDefaultFont
  47.  forceColumns        Columns            Boolean         False      **5
  48.  foreground      Foreground Pixel XtDefaultForeground
  49.  height      Height Dimension 0          **1
  50.  insensitiveBorder   Insensitive Pixmap Gray
  51.  internalHeight      Height Dimension 2
  52.  internalWidth      Width Dimension 4
  53.  list      List String* NULL    **2
  54.  longest             Longest            int             0          **3  **4
  55.  mappedWhenManaged   MappedWhenManaged Boolean True
  56.  numberStrings       NumberStrings      int             0          **4
  57.  pasteBuffer         Boolean            Boolean         False
  58.  pointerColor      Foreground Pixel XtDefaultForeground
  59.  pointerColorBackground Background Pixel XtDefaultBackground
  60.  rowSpacing          Spacing            Dimension       4
  61.  sensitive      Sensitive Boolean True
  62.  verticalList        Boolean            Boolean         False
  63.  width      Width Dimension 0          **1
  64.  x      Position Position 0
  65.  y      Position Position 0
  66.  **1 - If the Width or Height of the list widget is zero (0) then the value
  67.        is set to the minimum size necessay to fit the entire list.
  68.        If both Width and Height are zero then they are adjusted to fit the
  69.        entire list that is created width the number of default columns 
  70.        specified in the defaultColumns resource.
  71.  **2 - This is an array of strings the specify elements of the list.
  72.        This resource must be specified. 
  73.        (What good is a list widget without a list??  :-)
  74.  **3 - Longest is the length of the widest string in pixels.
  75.  **4 - If either of these values are zero (0) then the list widget calculates
  76.        the correct value. 
  77.        (This allows you to make startup faster if you already have 
  78.         this information calculated)
  79.        NOTE: If the numberStrings value is zero the list must 
  80.              be NULL terminated.
  81.  **5 - By setting the List.Columns resource you can force the application to
  82.        have a given number of columns.      
  83.         
  84.  **6 - This returns the name and index of the item selected in an 
  85.        XawListReturnStruct that is pointed to by the client_data
  86.        in the CallbackProc.
  87. */
  88. /*
  89.  * Value returned when there are no highlighted objects
  90.  */
  91. #define XAW_LIST_NONE -1
  92. #define XtCList "List"
  93. #define XtCSpacing "Spacing"
  94. #define XtCColumns "Columns"
  95. #define XtCLongest "Longest"
  96. #define XtCNumberStrings "NumberStrings"
  97. #define XtNcursor "cursor"
  98. #define XtNcolumnSpacing "columnSpacing"
  99. #define XtNdefaultColumns "defaultColumns"
  100. #define XtNforceColumns "forceColumns"
  101. #define XtNlist "list"
  102. #define XtNlongest "longest"
  103. #define XtNnumberStrings "numberStrings"
  104. #define XtNpasteBuffer "pasteBuffer"
  105. #define XtNrowSpacing "rowSpacing"
  106. #define XtNverticalList "verticalList"
  107. #define XtNshowCurrent "showCurrent"
  108.  
  109. #ifndef XtNfontSet
  110. #define XtNfontSet "fontSet"
  111. #endif
  112. #ifndef XtCFontSet
  113. #define XtCFontSet "FontSet"
  114. #endif
  115. extern WidgetClass listWidgetClass;
  116. typedef struct _ListClassRec *ListWidgetClass;
  117. typedef struct _ListRec      *ListWidget;
  118. /* list return structure */
  119. typedef struct _XawListReturnStruct {
  120.   String string;
  121.   int list_index;
  122. } XawListReturnStruct;
  123. _XFUNCPROTOBEGIN
  124. /*
  125.  * Function:
  126.  * XawListChange
  127.  *
  128.  * Parameters:
  129.  * w - list widget
  130.  * list - new list
  131.  * nitems - number of items in the list
  132.  * longest - length (in Pixels) of the longest element in the list
  133.  * resize - if True the the list widget will try to resize itself
  134.  *
  135.  * Description:
  136.  * Changes the list being used and shown.
  137.  *
  138.  * Note:
  139.  * If nitems of longest are <= 0 then they will be caluculated
  140.  * If nitems is <= 0 then the list needs to be NULL terminated
  141.  */
  142. void XawListChange
  143. (
  144.  Widget w,
  145.  String *list,
  146.  int nitems,
  147.  int longest,
  148. #if NeedWidePrototypes
  149.  int resize
  150. #else
  151.  Boolean resize
  152. #endif
  153.  );
  154. /*
  155.  * Function:
  156.  * XawListUnhighlight
  157.  *
  158.  * Parameters:
  159.  * w - list widget
  160.  *
  161.  * Description:
  162.  * Unlights the current highlighted element.
  163.  */
  164. void XawListUnhighlight
  165. (
  166.  Widget w
  167.  );
  168. /*
  169.  * Function:
  170.  * XawListHighlight
  171.  *
  172.  * Parameters:
  173.  * w    - list widget
  174.  * item - item to highlight
  175.  *
  176.  * Description:
  177.  * Highlights the given item.
  178.  */
  179. void XawListHighlight
  180. (
  181.  Widget w,
  182.  int item
  183.  );
  184. /*
  185.  * Function:
  186.  * XawListShowCurrent
  187.  *
  188.  * Paraneters:
  189.  * w - list widget
  190.  *
  191.  * Description:
  192.  * Returns the currently highlighted object.
  193.  *
  194.  * Returns:
  195.  * The info about the currently highlighted object
  196.  */
  197. XawListReturnStruct *XawListShowCurrent
  198. (
  199.  Widget w
  200.  );
  201. _XFUNCPROTOEND
  202. #endif /* _XawList_h */