home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff214.lzh / MandelVroom / src / getfile.h < prev    next >
C/C++ Source or Header  |  1989-05-30  |  1KB  |  47 lines
  1. /***************************************************
  2. *  get_fname(window,screen,hail,ddef,ddir);
  3. *
  4. *   Displays a window/requester that
  5. * gets a file name for device,directory,default file, extension
  6. *
  7. *   Calling args:
  8. * window:   Window making the request
  9. * screen:   Screen, if NULL assummed workbench
  10. * hail:   Text prompt at top of requester
  11. * ddef:   Input default file-name. Has NO DIRECTORY OR EXTENSION.
  12. * ddir:   Directory of file, may be null
  13. *
  14. *  The basic call is:
  15. *
  16. *   getfile(Window,Screen,Hailing_string,file_name,directory_name);
  17. *
  18. * Where:
  19. *   Window is a pointer to your window
  20. *   Screen is a pointer to your screen ... or (long)NULL if workbench
  21. *   Hailing_string is a prompt displayed in the requester
  22. *   file_name is a text array which will be altered by getfile,
  23. *   it returns the file name.
  24. *   directory_name is a text array altered by getfile, it
  25. *   is the directory.
  26. *
  27. *   The return value is either a pointer to your buffer, file_name,
  28. *   or NULL if the user selected CANCEL.
  29. *
  30. *   You must reserve two text areas for file and directory like so:
  31. *
  32. * #define FNAME_SIZE 33
  33. * TEXT   file_name[FNAME_SIZE + 1];
  34. * TEXT   dir_name[FNAME_SIZE + 2]
  35. **********************************************************************/
  36.  
  37. #ifndef GET_FNAME
  38.  
  39. #define GET_FNAME
  40.  
  41. #define FNAME_SIZE 33
  42.  
  43. extern char *get_fname();
  44.  
  45. #endif
  46.  
  47.