home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / editors / emacs / xemacs / xemacs-1.004 / xemacs-1 / xemacs-19.13 / src / frame.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-08-29  |  14.3 KB  |  392 lines
  1. /* Define frame-object for XEmacs.
  2.    Copyright (C) 1988, 1992, 1993, 1994 Free Software Foundation, Inc.
  3.  
  4. This file is part of XEmacs.
  5.  
  6. XEmacs is free software; you can redistribute it and/or modify it
  7. under the terms of the GNU General Public License as published by the
  8. Free Software Foundation; either version 2, or (at your option) any
  9. later version.
  10.  
  11. XEmacs is distributed in the hope that it will be useful, but WITHOUT
  12. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13. FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14. for more details.
  15.  
  16. You should have received a copy of the GNU General Public License
  17. along with XEmacs; see the file COPYING.  If not, write to the Free
  18. Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19.  
  20. /* Synched up with: FSF 19.28. */
  21.  
  22. #ifndef _XEMACS_FRAME_H_
  23. #define _XEMACS_FRAME_H_
  24.  
  25. #include "scrollbar.h"
  26. #include "toolbar.h"
  27. #include "device.h"
  28.  
  29. struct frame
  30. {
  31.   struct lcrecord_header header;
  32.  
  33.   /* device frame belongs to. */
  34.   Lisp_Object device;
  35.  
  36.   /* Name of this frame: a Lisp string.  */
  37.   Lisp_Object name;
  38.  
  39.   /* Size of this frame, in units of characters.  */
  40.   int height;
  41.   int width;
  42.  
  43.   /* Size of this frame, in units of pixels. */
  44.   int pixheight;
  45.   int pixwidth;
  46.  
  47.   /* Width of the internal border.  This is a line of background color
  48.      just inside the window's border.  It is normally only non-zero on
  49.      X frames, but we put it here to avoid introducing window system
  50.      dependencies. */
  51.   int internal_border_width;
  52.  
  53.   /* New height and width for pending size change.  0 if no change pending.  */
  54.   int new_height, new_width;
  55.  
  56.   /* This frame's root window.  Every frame has one.
  57.      If the frame has only a minibuffer window, this is it.
  58.      Otherwise, if the frame has a minibuffer window, this is its sibling.  */
  59.   Lisp_Object root_window;
  60.  
  61.   /* This frame's selected window.
  62.      Each frame has its own window hierarchy
  63.      and one of the windows in it is selected within the frame.
  64.      The selected window of the selected frame is Emacs's selected window.  */
  65.   Lisp_Object selected_window;
  66.  
  67.   /* This frame's minibuffer window.
  68.      Most frames have their own minibuffer windows,
  69.      but only the selected frame's minibuffer window
  70.      can actually appear to exist.  */
  71.   Lisp_Object minibuffer_window;
  72.  
  73.   /* This frame's root window mirror.  This structure exactly mirrors
  74.      the frame's window structure but contains only pointers to the
  75.      display structures. */
  76.   struct window_mirror *root_mirror;
  77.   
  78.   /* A copy of the global Vbuffer_list, to maintain a per-frame buffer
  79.      ordering.  The Vbuffer_list variable and the buffer_list slot of each
  80.      frame contain exactly the same data, just in different orders.  */
  81.   Lisp_Object buffer_alist;
  82.  
  83.   /* #### serious overhaulage needs to be applied to the following. */
  84.   Lisp_Object pointer;
  85.   Lisp_Object scrollbar_pointer;
  86.  
  87.   /* Vector representing the menubar currently displayed.  See menubar.c. */
  88.   Lisp_Object menubar_data;
  89.  
  90.   /* Data representing each currently displayed toolbar.  See
  91.      toolbar.c */
  92.   Lisp_Object toolbar_data[4];
  93.  
  94.   /* frame-local scrollbar information.  See scrollbar.c. */
  95.   int scrollbar_y_offset;
  96.   int scrollbar_on_left;
  97.   int scrollbar_on_top;
  98.  
  99.   /* cache of created scrollbars */
  100.   struct scrollbar_instance *sb_vcache;
  101.   struct scrollbar_instance *sb_hcache;
  102.  
  103.   /* A structure of auxiliary data specific to the device type.
  104.      struct x_frame is used for X window frames; defined in frame-x.h */
  105.   void *frame_data;
  106.  
  107.   /* specifier values cached in the struct frame: */
  108.  
  109.   /* Width and height of the scrollbars. */
  110.   Lisp_Object scrollbar_width, scrollbar_height;
  111.  
  112.   /* Size of the toolbars.  The frame-local toolbar space is
  113.      subtracted before the windows are arranged.  Window and buffer
  114.      local toolbars overlay their windows. */
  115.   Lisp_Object toolbar_size[4];
  116.  
  117.   /* Possible frame-local default for outside margin widths. */
  118.   Lisp_Object left_margin_width;
  119.   Lisp_Object right_margin_width;
  120.  
  121.   /* one-bit flags: */
  122.  
  123.   /* Is frame marked for deletion?  This is used in XSetErrorHandler().  */
  124.   unsigned int being_deleted :1;
  125.  
  126.   /* Nonzero if this frame has been destroyed. */
  127.   unsigned int dead :1;
  128.  
  129.   /* Nonzero if last attempt at redisplay on this frame was preempted.  */
  130.   unsigned int display_preempted :1;
  131.  
  132.   /* Nonzero if frame is currently displayed.  */
  133.   unsigned int visible :1;
  134.  
  135.   /* Nonzero if window is currently iconified.
  136.      This and visible are mutually exclusive.  */
  137.   unsigned int iconified :1;
  138.  
  139.   /* Nonzero if this frame should be cleared and then redrawn.
  140.      Setting this will also effectively set frame_changed. */
  141.   unsigned int clear :1;
  142.  
  143.   /* True if frame actually has a  minibuffer window on it.
  144.      0 if using a minibuffer window that isn't on this frame.  */
  145.   unsigned int has_minibuffer :1;
  146.      
  147.   /* True if frame's root window can't be split.  */
  148.   unsigned int no_split :1;
  149.  
  150.   unsigned int top_toolbar_was_visible :1;
  151.   unsigned int bottom_toolbar_was_visible :1;
  152.   unsigned int left_toolbar_was_visible :1;
  153.   unsigned int right_toolbar_was_visible :1;
  154.  
  155.   /* redisplay flags */
  156.   unsigned int buffers_changed :1;
  157.   unsigned int clip_changed :1;
  158.   unsigned int extents_changed :1;
  159.   unsigned int faces_changed :1;
  160.   unsigned int frame_changed :1;
  161.   unsigned int menubar_changed :1;
  162.   unsigned int modeline_changed :1;
  163.   unsigned int point_changed :1;
  164.   unsigned int size_changed :1;
  165.   unsigned int toolbar_changed :1;
  166.   unsigned int windows_changed :1;
  167.   unsigned int windows_structure_changed :1;
  168.   unsigned int window_face_cache_reset :1;    /* used by expose handler */
  169.  
  170.   unsigned int size_change_pending :1;
  171.   unsigned int mirror_dirty :1;
  172.  
  173.   /* flag indicating if any window on this frame is displaying a subwindow */
  174.   int subwindows_being_displayed :1;
  175. };
  176.  
  177. /* If this is non-nil, it is the frame that make-frame is currently
  178.    creating.  We can't set the current frame to this in case the
  179.    debugger goes off because it would try and display to it.  However,
  180.    there are some places which need to reference it which have no
  181.    other way of getting it if it isn't the selected frame. */
  182. extern Lisp_Object Vframe_being_created;
  183.  
  184. #ifdef emacs
  185.  
  186. DECLARE_LRECORD (frame, struct frame);
  187. #define XFRAME(x) XRECORD (x, frame, struct frame)
  188. #define XSETFRAME(x, p) XSETRECORD (x, p, frame)
  189. #define FRAMEP(x) RECORDP (x, frame)
  190. #define CHECK_FRAME(x, i) CHECK_RECORD (x, frame)
  191.  
  192. #define CHECK_LIVE_FRAME(x, i)                        \
  193.   do { CHECK_FRAME (x, i);                        \
  194.        if (! FRAMEP (x)                            \
  195.        || ! FRAME_LIVE_P (XFRAME (x)))                \
  196.          x = wrong_type_argument (Qframe_live_p, (x)); } while (0)
  197. #define CHECK_X_FRAME(x, i)                        \
  198.   do { CHECK_FRAME (x, i);                        \
  199.        if (! FRAMEP (x)                            \
  200.        || ! FRAME_IS_X (XFRAME (x)))                \
  201.          x = wrong_type_argument (Qframe_x_p, (x)); } while (0)
  202. #define CHECK_NS_FRAME(x, i)                        \
  203.   do { CHECK_FRAME (x, i);                        \
  204.        if (! FRAMEP (x)                            \
  205.        || ! FRAME_IS_NS (XFRAME (x)))                \
  206.          x = wrong_type_argument (Qframe_ns_p, (x)); } while (0)
  207. #define CHECK_TTY_FRAME(x, i)                        \
  208.   do { CHECK_FRAME (x, i);                        \
  209.        if (! FRAMEP (x)                            \
  210.        || ! FRAME_IS_TTY (XFRAME (x)))                \
  211.          x = wrong_type_argument (Qframe_tty_p, (x)); } while (0)
  212.  
  213. typedef struct frame *FRAME_PTR;
  214. extern Lisp_Object Qframe_live_p;
  215. extern Lisp_Object Qframe_x_p, Qframe_tty_p;
  216. extern Lisp_Object Vframe_title_format, Vframe_icon_title_format;
  217.  
  218. extern int frame_changed;
  219.  
  220. #define MARK_FRAME_FACES_CHANGED(f) do {                \
  221.   (f)->faces_changed = 1;                        \
  222.   if (!NILP ((f)->device))                        \
  223.     MARK_DEVICE_FACES_CHANGED (XDEVICE ((f)->device));            \
  224.   else                                    \
  225.     faces_changed = 1; } while (0)
  226.  
  227. #define MARK_FRAME_TOOLBARS_CHANGED(f) do {                \
  228.   (f)->toolbar_changed = 1;                        \
  229.   if (!NILP ((f)->device))                        \
  230.     MARK_DEVICE_TOOLBARS_CHANGED (XDEVICE ((f)->device));        \
  231.   else                                    \
  232.     toolbar_changed = 1; } while (0)
  233.  
  234. #define MARK_FRAME_SIZE_CHANGED(f) do {                    \
  235.   (f)->size_changed = 1;                        \
  236.   (f)->size_change_pending = 1;                        \
  237.   if (!NILP ((f)->device))                        \
  238.     MARK_DEVICE_SIZE_CHANGED (XDEVICE ((f)->device));            \
  239.   else                                    \
  240.     size_changed = 1; } while (0)
  241.  
  242. #define MARK_FRAME_CHANGED(f) do {                    \
  243.   (f)->frame_changed = 1;                        \
  244.   if (!NILP ((f)->device))                        \
  245.     MARK_DEVICE_FRAME_CHANGED (XDEVICE ((f)->device));            \
  246.   else                                    \
  247.     frame_changed = 1; } while (0)
  248.  
  249. #define MARK_FRAME_WINDOWS_CHANGED(f) do {                \
  250.   (f)->windows_changed = 1;                        \
  251.   if (!NILP ((f)->device))                        \
  252.     MARK_DEVICE_WINDOWS_CHANGED (XDEVICE ((f)->device));        \
  253.   else                                    \
  254.     windows_changed = 1; } while (0)
  255.  
  256. #define MARK_FRAME_WINDOWS_STRUCTURE_CHANGED(f) do {            \
  257.   (f)->windows_structure_changed = 1;                    \
  258.   if (!NILP ((f)->device))                        \
  259.     MARK_DEVICE_WINDOWS_STRUCTURE_CHANGED (XDEVICE ((f)->device));    \
  260.   else                                    \
  261.     windows_structure_changed = 1; } while (0)
  262.  
  263.  
  264. #define SET_FRAME_CLEAR(f) MARK_FRAME_CHANGED(f); (f)->clear = 1
  265. #define FRAME_DEVICE(f) ((f)->device)
  266. #define FRAME_LIVE_P(f) (!(f)->dead)
  267. #define FRAME_IS_TTY(f) (!(f)->dead && DEVICE_IS_TTY (XDEVICE ((f)->device)))
  268.  
  269. #define FRAME_IS_X(f) (!(f)->dead && DEVICE_IS_X (XDEVICE ((f)->device)))
  270. #define FRAME_IS_NS(f) (!(f)->dead && DEVICE_IS_NS (XDEVICE ((f)->device)))
  271. #if defined (HAVE_X_WINDOWS) && defined (HAVE_NEXTSTEP)
  272. #define FRAME_IS_WIN(f) (FRAME_IS_X (f) || FRAME_IS_NS (f))
  273. #elif defined (HAVE_X_WINDOWS)
  274. #define FRAME_IS_WIN(f) FRAME_IS_X (f)
  275. #elif defined (HAVE_NEXTSTEP)
  276. #define FRAME_IS_WIN(f) FRAME_IS_NS (f)
  277. #else
  278. #define FRAME_IS_WIN(f) 0
  279. #endif
  280.  
  281. #define FRAME_MINIBUF_ONLY_P(f) \
  282.   EQ (FRAME_ROOT_WINDOW (f), FRAME_MINIBUF_WINDOW (f))
  283. #define FRAME_HAS_MINIBUF_P(f) ((f)->has_minibuffer)
  284. #define FRAME_HEIGHT(f) ((f)->height)
  285. #define FRAME_WIDTH(f) ((f)->width)
  286. #define FRAME_PIXHEIGHT(f) ((f)->pixheight)
  287. #define FRAME_PIXWIDTH(f) ((f)->pixwidth)
  288. #define FRAME_SCROLLBAR_WIDTH(f) XINT ((f)->scrollbar_width)
  289. #define FRAME_SCROLLBAR_HEIGHT(f) XINT ((f)->scrollbar_height)
  290. #define FRAME_TOP_TOOLBAR_HEIGHT(f) XINT ((f)->toolbar_size[TOP_TOOLBAR])
  291. #define FRAME_BOTTOM_TOOLBAR_HEIGHT(f) XINT ((f)->toolbar_size[BOTTOM_TOOLBAR])
  292. #define FRAME_LEFT_TOOLBAR_WIDTH(f) XINT ((f)->toolbar_size[LEFT_TOOLBAR])
  293. #define FRAME_RIGHT_TOOLBAR_WIDTH(f) XINT ((f)->toolbar_size[RIGHT_TOOLBAR])
  294. #define FRAME_NEW_HEIGHT(f) ((f)->new_height)
  295. #define FRAME_NEW_WIDTH(f) ((f)->new_width)
  296. #define FRAME_CURSOR_X(f) ((f)->cursor_x)
  297. #define FRAME_CURSOR_Y(f) ((f)->cursor_y)
  298. #define FRAME_VISIBLE_P(f) ((f)->visible)
  299. #define FRAME_NO_SPLIT_P(f) ((f)->no_split)
  300. #define FRAME_ICONIFIED_P(f) ((f)->iconified)
  301. #define FRAME_MINIBUF_WINDOW(f) ((f)->minibuffer_window)
  302. #define FRAME_ROOT_WINDOW(f) ((f)->root_window)
  303. #define FRAME_SELECTED_WINDOW(f) ((f)->selected_window)
  304. #define FRAME_SB_VCACHE(f) ((f)->sb_vcache)
  305. #define FRAME_SB_HCACHE(f) ((f)->sb_hcache)
  306.  
  307. #define FRAME_TOP_TOOLBAR_VISIBLE(f)                    \
  308.  (!NILP ((f)->toolbar_data[TOP_TOOLBAR])        \
  309.   && !NILP (FRAME_TOOLBAR_DATA ((f), TOP_TOOLBAR)->toolbar_buttons))
  310. #define FRAME_BOTTOM_TOOLBAR_VISIBLE(f)                    \
  311.  (!NILP ((f)->toolbar_data[BOTTOM_TOOLBAR])        \
  312.   && !NILP (FRAME_TOOLBAR_DATA ((f), BOTTOM_TOOLBAR)->toolbar_buttons))
  313. #define FRAME_LEFT_TOOLBAR_VISIBLE(f)                    \
  314.  (!NILP ((f)->toolbar_data[LEFT_TOOLBAR])        \
  315.   && !NILP (FRAME_TOOLBAR_DATA ((f), LEFT_TOOLBAR)->toolbar_buttons))
  316. #define FRAME_RIGHT_TOOLBAR_VISIBLE(f)                    \
  317.  (!NILP ((f)->toolbar_data[RIGHT_TOOLBAR])        \
  318.   && !NILP (FRAME_TOOLBAR_DATA ((f), RIGHT_TOOLBAR)->toolbar_buttons))
  319.  
  320. #define FRAME_BORDER_WIDTH(f) ((f)->internal_border_width)
  321. #define FRAME_BORDER_HEIGHT(f) ((f)->internal_border_width)
  322.  
  323. #define FRAME_REAL_TOP_TOOLBAR_HEIGHT(f)                \
  324.      (FRAME_TOP_TOOLBAR_VISIBLE (f) ? FRAME_TOP_TOOLBAR_HEIGHT (f) : 0)
  325. #define FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT(f)                \
  326.      (FRAME_BOTTOM_TOOLBAR_VISIBLE (f) ? FRAME_BOTTOM_TOOLBAR_HEIGHT (f) : 0)
  327. #define FRAME_REAL_LEFT_TOOLBAR_WIDTH(f)                \
  328.      (FRAME_LEFT_TOOLBAR_VISIBLE (f) ? FRAME_LEFT_TOOLBAR_WIDTH (f) : 0)
  329. #define FRAME_REAL_RIGHT_TOOLBAR_WIDTH(f)                \
  330.      (FRAME_RIGHT_TOOLBAR_VISIBLE (f) ? FRAME_RIGHT_TOOLBAR_WIDTH (f) : 0)
  331.  
  332. #define FRAME_TOP_BORDER_START(f) (FRAME_REAL_TOP_TOOLBAR_HEIGHT (f))
  333. #define FRAME_TOP_BORDER_END(f)                        \
  334.   (FRAME_TOP_BORDER_START (f) + FRAME_BORDER_HEIGHT (f))
  335.  
  336. #define FRAME_BOTTOM_BORDER_START(f)                    \
  337.   (FRAME_PIXHEIGHT (f) - FRAME_BORDER_HEIGHT (f) -            \
  338.    FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f))
  339. #define FRAME_BOTTOM_BORDER_END(f)                    \
  340.   (FRAME_PIXHEIGHT (f) - FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f))
  341.  
  342. #define FRAME_LEFT_BORDER_START(f) (FRAME_REAL_LEFT_TOOLBAR_WIDTH (f))
  343. #define FRAME_LEFT_BORDER_END(f)                    \
  344.   (FRAME_LEFT_BORDER_START (f) + FRAME_BORDER_WIDTH (f))
  345.  
  346. #define FRAME_RIGHT_BORDER_START(f)                    \
  347.   (FRAME_PIXWIDTH (f) - FRAME_BORDER_WIDTH (f) -            \
  348.    FRAME_REAL_RIGHT_TOOLBAR_WIDTH (f))
  349. #define FRAME_RIGHT_BORDER_END(f)                    \
  350.   (FRAME_PIXWIDTH (f) - FRAME_REAL_RIGHT_TOOLBAR_WIDTH (f))
  351.  
  352.  
  353. #define HAS_FRAMEMETH_P(f, m) HAS_DEVMETH_P (XDEVICE (FRAME_DEVICE (f)), m)
  354. #define FRAMEMETH(f,m, args) DEVMETH (XDEVICE (FRAME_DEVICE (f)), m, args)
  355. #define MAYBE_FRAMEMETH(f, m, args) \
  356.   MAYBE_DEVMETH (XDEVICE (FRAME_DEVICE (f)), m, args)
  357. #define FRAMEMETH_OR_GIVEN(f, m, args, given) \
  358.   DEVMETH_OR_GIVEN (XDEVICE (FRAME_DEVICE (f)), m, args, given)
  359.  
  360. #define FRAME_LOOP(consvar, d) LIST_LOOP (consvar, DEVICE_FRAME_LIST (d))
  361.  
  362. #define DEVICE_AND_FRAME_LOOP(devcons, frmcons)                \
  363.   DEVICE_LOOP (devcons)                            \
  364.     FRAME_LOOP (frmcons, XDEVICE (XCAR (devcons)))
  365.  
  366. extern Lisp_Object Vdefault_frame_name;
  367.  
  368. extern void update_frame_title (struct frame *f);
  369. extern struct frame *choose_minibuf_frame (void);
  370. extern Lisp_Object next_frame (Lisp_Object f, Lisp_Object mini);
  371. extern Lisp_Object prev_frame (Lisp_Object f, Lisp_Object mini);
  372. extern void store_in_alist (Lisp_Object *alistptr, 
  373.                             CONST char *propname, 
  374.                             Lisp_Object val);
  375. extern void do_pending_frame_size_change (void);
  376. extern void change_frame_size (struct frame *frame,
  377.                                 int newlength, int newwidth, 
  378.                                 int pretend, int delay);
  379. extern void delete_frame_internal (Lisp_Object frame,
  380.                       int ok_to_delete_last);
  381. extern void hold_frame_size_changes (void);
  382. extern void unhold_frame_size_changes (struct frame *f);
  383. extern void select_frame_1 (Lisp_Object frame);
  384. extern struct frame *selected_frame (void);
  385. extern struct frame *device_selected_frame (struct device *d);
  386. extern struct frame *get_frame (Lisp_Object frame);
  387. extern int other_visible_frames (struct frame *f);
  388.  
  389. #endif /* emacs */
  390.  
  391. #endif /* _XEMACS_FRAME_H_ */
  392.