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

流媒体/Mpeg4/MP4

开发平台:

Visual C++

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