home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / l / libstore / !LibStore / Index / WimpLib / Windows < prev   
Encoding:
Text File  |  1993-06-19  |  3.0 KB  |  80 lines
  1. Index file for the "Windows" library
  2.  
  3. Procedures provided:
  4.  
  5. DEFPROCstartup_windows(max_windows%) - This sets up the various variables
  6. and arrays used in this library. max_windows% is the maximum number of
  7. windows you will be creating.
  8.  
  9. DEFFNwindowflags(str$,oldflags%) - this returns the value of the window
  10. flags passed in str$. oldflags% contains a previous value, or 0 if there
  11. isn't any. str$ contains the flags made up of a string of letters in the
  12. following format:
  13.  
  14. D - the window is draggable
  15. R - the window is redrawn by the WIMP
  16. P - the window is a pane
  17. X - the window can extend beyond the screen
  18. A - generate auto-repeat scroll events
  19. S - generate scroll events without auto-repeat
  20. G - treat window colours as GCOL ones
  21. B - no windows below this one
  22. K - generate key pressed events for 'hot keys'
  23. F - this must be followed by a second letter:
  24.   B - back icon
  25.   C - close icon
  26.   T - title bar
  27.   S - toggle size icon
  28.   V - vertical scroll bar
  29.   A - adjust size icon
  30.   H - horizontal scroll bar
  31.  
  32. DEFPROCcreate_window_simple(flags%,minx%,miny%,maxx%,maxy%,w%,h%,title$,
  33. indtitle%,iblock%) - this creates a window. w% and h% are the width and
  34. height. indtitle% is an address pointing to an indirect block. Usually
  35. this should be zero, as the procedure will take care of long titles
  36. itself.
  37.  
  38. DEFPROCopenwindow(handle%) - this opens a window on top of the stack.
  39.  
  40. DEFPROCgetorigin - this is for internal use only.
  41.  
  42. DEFPROCredraw - starts a redraw. If the handle is known to the program
  43. it will call FNredraw_n where n is the window number. n is 0 for the
  44. first window created, 1 for the second, etc. If the handle is unknown,
  45. FNredraw_unknown is called. PROCpoll() will automatically call this if
  46. a redraw code is recieved. Passed to FNredraw_n is the origin of the
  47. window (0,0) in xO%, yO%. Drawing must be done relative to this point.
  48.  
  49. DEFPROCcreate_window_complex(flags%,minx%,miny%,w%,h%,title$,indtitle%,
  50. iblock%,foreground%,background%,input%,border%,areatype%) - this allows
  51. you to create windows with different colours and button types on the
  52. work area.
  53.  
  54. DEFPROCforceredraw(minx%,miny%,maxx%,maxy%,handle%) - this forces a redraw
  55. of a window
  56.  
  57. DEFFNreporterror(taskname$,error$,ok%,cancel%,no_error_from%) - this
  58. pops up a error box. To set the flags ok%, cancel% and no_error_from%,
  59. set them to 1. It reports 1 for OK and 2 for cancel.
  60.  
  61. DEFFNerror(taskname$,ok%,cancel%) - reports an error as it occurs, using
  62. REPORT$. The “Internal Error Code” is the line number.
  63.  
  64. DEFPROCaddpane(host%,pane%,x%,y%) - makes a window with the handle contained
  65. in pane% a host of the window with the handle host%, at the coordinates x%,
  66. y% releative to the top left hand side of the window.
  67.  
  68. DEFPROCopenwindowpane(host%) - opens the window with the handle 'host%',
  69. including panes.
  70.  
  71. DEFPROCopenpanes(host%,position%,getstate%) - opens a window with panes at 
  72. position postion% in the stack. getstate% is for internal use only, and
  73. should be set to 0.
  74.  
  75.  
  76. Variables used:
  77.  
  78. handle%() - contains all the window handles. 'Templates' also needs this.
  79. handle%(0) is the first window, handle%(1) the second, etc.
  80.