home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / code / pascal / !Pascal / h / txtwin < prev    next >
Encoding:
Text File  |  1992-02-09  |  2.0 KB  |  72 lines
  1. (* Title:   txtwin.h
  2.  * Purpose: control of multiple windows on Text objects.
  3.  *
  4.  *)
  5.  
  6. #ifndef __txtwin_h
  7. #define __txtwin_h
  8.  
  9. #ifndef __txt_h
  10. #include "txt.h"
  11. #endif
  12.  
  13. (* A Text can support multiple windows. When the Text is updated, all
  14.  * of the windows are updated in step. All of the windows have the same
  15.  * title information. 
  16.  *
  17.  *)
  18.  
  19. (* ----------------------------- txtwin_new --------------------------------
  20.  * Description:   Creates an extra window on a given text object.
  21.  *
  22.  * Parameters:    txt t -- the text to have window added to it.
  23.  * Returns:       void.
  24.  * Other Info:    The created window will be in the same style as for 
  25.  *                txt_new(), with the same title information. The window 
  26.  *                will be made visible.
  27.  *
  28.  *)
  29. procedure txtwin_new(t : txt); extern; 
  30.  
  31.  
  32. (* --------------------------------- txtwin_number -------------------------
  33.  * Description:   Informs caller of the number of windows currently on a
  34.  *                given text.
  35.  *
  36.  * Parameters:    txt t -- the text.
  37.  * Returns:       The number of windows currently on "t".
  38.  * Other Info:    none.
  39.  *
  40.  *)
  41. function txtwin_number(t : txt) : integer; extern;
  42.  
  43.  
  44. (* -------------------------------- txtwin_dispose -------------------------
  45.  * Description:   Removes a window, previously on "t".
  46.  *
  47.  * Parameters:    txt t -- the text.
  48.  * Returns:       void.
  49.  * Other Info:    This call will have no effect if there is only one window
  50.  *                on "t".
  51.  *
  52.  *)
  53. procedure txtwin_dispose(t : txt); extern;
  54.  
  55.  
  56. (* --------------------------- txtwin_setcurrentwindow ---------------------
  57.  * Description:    Ensures that the last window to which the last event was
  58.  *                 delivered, is the current window on a given text
  59.  *
  60.  * Parameters:     txt t -- the text.
  61.  * Returns:        void.
  62.  * Other Info:     Call this when constructing menus, since the same menu
  63.  *                 structure is attached to each window on the same text
  64.  *                 object.
  65.  *
  66.  *)
  67. procedure txtwin_setcurrentwindow(t : txt); extern;
  68.  
  69. #endif
  70.  
  71. (* end txtwin.h *)
  72.