home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume3 / browserw / part01 / browser.3x < prev    next >
Encoding:
Text File  |  1989-02-17  |  3.7 KB  |  102 lines
  1. (Message inbox:717)
  2. Return-Path: shipley%WEB.Berkeley.EDU@lilac.berkeley.edu
  3. Received:  by wyse.wyse.com (5.58/Wyse master/5-13-88)
  4.     id AA02643; Wed, 4 Jan 89 22:53:38 PST
  5. From: shipley%WEB.Berkeley.EDU@lilac.berkeley.edu
  6. Received: from lilac.Berkeley.EDU by uunet.UU.NET (5.59/1.14) 
  7.     id AA25181; Thu, 5 Jan 89 01:42:01 EST
  8. Received: from e260-4f.berkeley.edu
  9.     by lilac.berkeley.edu (5.54 (CFC 4.22.3)/1.16.19)
  10.     id AA06780; Wed, 4 Jan 89 22:40:27 PST
  11. Received: by e260-4f.berkeley.edu (3.2/SMI-3.0DEV3.9MXl)
  12.     id AA02312; Wed, 4 Jan 89 22:43:36 PST
  13. Message-Id: <8901050643.AA02312@e260-4f.berkeley.edu>
  14. To: ames!mailrus!umix!wyse.com!mcf.uucp!mikew@cad.Berkeley.EDU
  15. Cc: shipley%widow.Berkeley.EDU@lilac.berkeley.edu, mikew@wyse.wyse.com
  16. Subject: Re: browser widget 
  17. In-Reply-To: Your message of Wed, 04 Jan 89 10:58:55 PST.
  18.              <8901041858.AA00866@wyse.wyse.com> 
  19. Date: Wed, 04 Jan 89 22:43:32 PST
  20.  
  21.  
  22. > Could you send me a man page for the browser widget?
  23. > Mike Wexler(wyse!mikew)    Phone: (408)433-1000 x1330
  24. > Moderator of comp.sources.x
  25.  
  26. .TH BrowserWidget 3X
  27. .SH NAME
  28. BrowserWidget - Dialog widet for selecting files
  29. .SH DESCRIPTION
  30. The BrowserWidget is a Utility widget which prompts
  31. the user ror file sectection.
  32. .SH RESOURCES
  33. .TS
  34. l l l l.
  35. _
  36. \fBName    Type    Default    Description\fR
  37. =
  38. XtNvalue    XtRString    NULL    T{
  39. full path to directory to start Browsing
  40. T}
  41. XtNdefaultDistance    XtRInt    10    T{
  42. distance between subwidgets inside BrowserWidget
  43. T}
  44. XtNopenCallback    XtCallbackList    NULL    Callbacks for open button
  45. XtNcancelCallback    XtCallbackList    NULL    Callbacks for cansel button
  46. XtNdestroyCallback    XtCallbackList    NULL    Callbacks for XtDestroyWidget
  47. XtNmappedWhenManaged    Boolean    True    Whether XtMapWidget is automatic
  48. XtNfunction    Boolean (*func)()    NULL    see below
  49. XtNreverseVideo    Boolean    FALSE    display widget in reverse video
  50. _
  51. .TE
  52. .IP XtNvalue
  53. The resource \*QXtNvalue\*U defines the base directory which the BrowserWidget
  54. use to start querying user from.
  55. This resource has no default value thus it \fBmust be given\fR.
  56. .\"
  57. .IP XtNdefaultDistance
  58. The resource \*QXtNdefaultDistance\*U defines the distance
  59. between the child widgets of the BrowserWidget.
  60. .\"
  61. .IP XtNopenCallback
  62. This callback is called when the user selects a file.
  63. .\"
  64. .IP XtNcancelCallback
  65. This callback is called when the user selects the cancel button.
  66. .\"
  67. .IP XtNfunction
  68. This resource is a pointer to a function whose argument is
  69. a pointer to a directory entry for each file in the directory
  70. currently being scaned; the function should return TRUE if the
  71. directory entry is to be included.
  72. If this pointer is null, then all the directory entries will be included.
  73. .\"
  74. .IP "Other resources"
  75. The resource for the open button is \*Qopen\*U; the resource for the cancel
  76. button is \*Qcancel\*U. These can be used to change the default labels.
  77. .\"
  78. .SH USE
  79. The BrowserWidget takes command via mouse actions or keyboard entery.
  80. Selection using the mouse is done by ether double clicking on the
  81. desired file of directory, or by clicking once on the desired entry
  82. and selecting the open button.
  83. Selection using the keyboard is very much like using file completion
  84. in the C-shell.
  85. Generally you type a partial filename followed by an ESC character
  86. and the BrowserWidget fills in the remaining unambiguous characters
  87. of partial filename
  88. If the user enters a Control-C the cancel callback will be called.
  89. Selection is done by entering a line feed for or carrage return.
  90. .LP
  91. If the selected directory entry is a directory the directory will
  92. be followed and the menu will be redisplayed else the selected file
  93. will be returned as a part of the open callback.
  94. .\"
  95. .SH SEE ALSO
  96. scandir(3)
  97. .\"
  98. .SH BUGS
  99. Viewport sometime gets confused about the size of the ListWidget (menu)
  100. and the user will be unable to use scrollbar.
  101. ListWidget will dump core if the user mouses to quickly.
  102.