Merge from emacs-24; up to 2012-12-13T00:52:17Z!yamaoka@jpl.org
[bpt/emacs.git] / oldXMenu / XMenu.h
CommitLineData
2cd3138f
GM
1/* Copyright Massachusetts Institute of Technology 1985 */
2
e745ede7
DL
3#include "copyright.h"
4
e745ede7
DL
5
6/*
7 * XMenu: MIT Project Athena, X Window system menu package
8 *
9 * XMenu.h - Include file for the MIT Project Athena
10 * XMenu X window system menu package.
177c0ea7 11 *
e745ede7
DL
12 * Author: Tony Della Fera, DEC
13 * August, 1984
14 */
15
16#ifndef _XMenu_h_
17#define _XMenu_h_
18
ababf900 19#include <stdlib.h>
e745ede7
DL
20#include <X11/Xutil.h>
21#include "X10.h"
22
23#define FAILURE -1
24#define SUCCESS 1
25#define POST_ERROR -1
26#define NO_SELECTION -1
27
28#define XM_FAILURE -1
29#define XM_SUCCESS 1
30#define XM_NO_SELECT 2
31#define XM_IA_SELECT 3
32
33#define XME_CODE_COUNT 17
34
35#define XME_NO_ERROR 0
36#define XME_NOT_INIT 1
37#define XME_ARG_BOUNDS 2
38#define XME_P_NOT_FOUND 3
39#define XME_S_NOT_FOUND 4
40#define XME_STYLE_PARAM 5
41#define XME_GRAB_MOUSE 6
42#define XME_INTERP_LOC 7
43#define XME_CALLOC 8
44#define XME_CREATE_ASSOC 9
45#define XME_STORE_BITMAP 10
46#define XME_MAKE_TILES 11
47#define XME_MAKE_PIXMAP 12
48#define XME_CREATE_CURSOR 13
49#define XME_OPEN_FONT 14
50#define XME_CREATE_WINDOW 15
51#define XME_CREATE_TRANSP 16
52
53/*
54 * XMenu error code and error list definitions.
55 */
56extern int _XMErrorCode;
55660072 57extern char const *const _XMErrorList[];
e745ede7
DL
58
59/*
60 * Define the XMWindow datatypes.
61 *
62 * An XMWindow is either an XMPane or an XMSelect.
63 *
64 * XMWindow is wrapper used to identify the constant window
65 * information that makes up XMPane and XMSelect objects.
66 *
67 * An XMPane is a menu pane made up of one or more XMSelect and a label.
68 *
69 * An XMSelect is a menu selection object with a label and a data pointer.
70 */
71typedef enum _xmwintype {PANE, SELECTION, PL_HEADER, SL_HEADER, SEPARATOR} XMWType;
72
73typedef struct _xmwindow {
74 struct _xmwindow *next; /* Next obj pointer (for emacs_insque). */
75 struct _xmwindow *prev; /* Prev obj pointer (for emacs_insque). */
76 XMWType type; /* Type of window. */
77 Window window; /* X Window Id. */
78 int window_x; /* Window upper left X coordinate. */
79 int window_y; /* Window upper left y coordinate. */
80 int window_w; /* Window width. */
81 int window_h; /* Window height. */
82 int active; /* Window active? */
83 int activated; /* Window activated? */
84 int pad_l1; /* ---- */
85 char *pad_l2; /* ---- */
86 int pad_l3; /* ---- */
87 int pad_l4; /* ---- */
88 int pad_l5; /* ---- */
89 int pad_l6; /* ---- */
90 int pad_l7; /* ---- */
91 int pad_l8; /* ---- */
92 struct _xmwindow *pad_l9; /* ---- */
93 char *pad_l10; /* ---- */
94 struct _xmwindow *pad_l11; /* ---- */
95} XMWindow;
96
97typedef struct _xmpane {
98 struct _xmpane *next; /* Next obj pointer (for emacs_insque). */
99 struct _xmpane *prev; /* Prev obj pointer (for emacs_insque). */
100 XMWType type; /* Type of window. */
101 Window window; /* X Window Id. */
102 int window_x; /* Window upper left X coordinate. */
103 int window_y; /* Window upper left y coordinate. */
104 int window_w; /* Window width. */
105 int window_h; /* Window height. */
106 int active; /* Window active? */
107 int activated; /* Window activated? */
108 int serial; /* -- Pane serial number. */
55660072 109 char const *label; /* -- Pane label. */
e745ede7
DL
110 int label_width; /* -- Pane label width in pixels. */
111 int label_length; /* -- Pane label length in chars. */
112 int label_x; /* -- Pane label X offset. */
113 int label_uy; /* -- Pane label upper Y offset. */
114 int label_ly; /* -- Pane label lower Y offset. */
115 int s_count; /* -- Selections in this pane. */
116 struct _xmselect *s_list; /* -- Selection window list. */
117 char *pad_l10; /* ---- */
118 struct _xmwindow *pad_l11; /* ---- */
119} XMPane;
120
121typedef struct _xmselect {
122 struct _xmselect *next; /* Next obj pointer (for emacs_insque). */
123 struct _xmselect *prev; /* Prev obj pointer (for emacs_insque). */
124 XMWType type; /* Type of window. */
125 Window window; /* X Window Id. */
126 Window parent; /* X Window id of parent window. */
127 int window_x; /* Window upper left X coordinate. */
128 int window_y; /* Window upper left y coordinate. */
129 int window_w; /* Window width. */
130 int window_h; /* Window height. */
131 int active; /* Window active? */
132 int activated; /* Window activated? */
133 int serial; /* -- Selection serial number. */
134 char *label; /* -- Selection label. */
135 int label_width; /* -- Selection label width in pixels. */
136 int label_length; /* -- Selection label length in chars. */
137 int label_x; /* -- Selection label X offset. */
138 int label_y; /* -- Selection label Y offset. */
139 int pad_l7; /* ---- */
140 int pad_l8; /* ---- */
141 struct _xmwindow *pad_l9; /* ---- */
142 char *data; /* -- Selection data pointer. */
143 struct _xmpane *parent_p; /* -- Selection parent pane structure. */
55660072 144 char const *help_string; /* Help string or null. */
e745ede7
DL
145} XMSelect;
146
147
148/*
149 * Define the XMStyle datatype.
150 *
151 * Menu presentation style information.
152 *
153 */
154typedef enum _xmstyle {
fa463103
PE
155 LEFT, /* Left oriented object. */
156 RIGHT, /* Right oriented object. */
e745ede7
DL
157 CENTER /* Center oriented object. */
158} XMStyle;
159
160
161/*
162 * Define the XMMode datatype.
163 *
164 * Menu presentation mode information.
165 *
166 */
167typedef enum _xmmode {
168 BOX, /* BOXed graphic rendition. */
169 INVERT /* INVERTed graphic rendition. */
170} XMMode;
171
172
177c0ea7
JB
173/*
174 * Define the XMenu datatype.
e745ede7
DL
175 *
176 * All dimensions are in pixels unless otherwise noted.
177 */
178typedef struct _xmenu {
179 /* -------------------- Menu data -------------------- */
180 XMStyle menu_style; /* Menu display style. */
181 XMMode menu_mode; /* Menu display mode. */
182 int freeze; /* Freeze server mode? */
183 int aeq; /* Asynchronous Event Queuing mode? */
184 int recompute; /* Recompute menu dependencies? */
185 Window parent; /* Menu's parent window. */
186 int width; /* Overall menu width. */
187 int height; /* Overall menu height. */
09e80d9f 188 int x_pos; /* Overall menu origin. */
e745ede7
DL
189 int y_pos; /* Overall menu origin. */
190 Cursor mouse_cursor; /* Mouse cursor raster. */
191 XAssocTable *assoc_tab; /* XMWindow association table. */
192 XMPane *p_list; /* List of XMPanes. */
193 /* -------------------- Pane window data -------------------- */
194 XMStyle p_style; /* Pane display style. */
195 int p_events; /* Pane window X events. */
196 XFontStruct *p_fnt_info; /* Flag font info structure. */
197 GC pane_GC; /* Pane graphics context. */
198 int p_fnt_pad; /* Fixed flag font padding in pixels. */
199 double p_spread; /* Pane spread in flag height fractions. */
200 int p_bdr_width; /* Pane border width. */
201 int flag_height; /* Flag height. */
202 int p_width; /* Menu pane width. */
203 int p_height; /* Menu pane height. */
204 int p_x_off; /* Pane window X offset. */
205 int p_y_off; /* Pane window Y offset. */
206 int p_count; /* Number of panes per menu. */
207 /* -------------------- Selection window data -------------------- */
208 XMStyle s_style; /* Selection display style. */
209 int s_events; /* Selection window X events. */
210 XFontStruct *s_fnt_info; /* Body font info structure. */
211 int s_fnt_pad; /* Fixed body font padding in pixels. */
212 double s_spread; /* Select spread in line height fractions. */
213 int s_bdr_width; /* Select border width. */
214 int s_width; /* Selection window width. */
215 int s_height; /* Selection window height. */
216 int s_x_off; /* Selection window X offset. */
217 int s_y_off; /* Selection window Y offset. */
218 int s_count; /* Maximum number of selections per pane. */
219 GC normal_select_GC; /* GC used for inactive selections. */
177c0ea7 220 GC inverse_select_GC; /* GC used for active (current) selection. */
e745ede7
DL
221 GC inact_GC; /* GC used for inactive selections and */
222 /* panes headers. */
223 /* -------------------- Color data -------------------- */
224 unsigned long p_bdr_color; /* Color of pane border pixmap. */
225 unsigned long s_bdr_color; /* Color of selection border pixmap. */
226 unsigned long p_frg_color; /* Color of pane foreground pixmap. */
227 unsigned long s_frg_color; /* Color of selection pixmap. */
228 unsigned long bkgnd_color; /* Color of menu background pixmap. */
229 /* -------------------- Pixmap data -------------------- */
230 Pixmap p_bdr_pixmap; /* Pane border pixmap. */
231 Pixmap s_bdr_pixmap; /* Selection border pixmap. */
232 Pixmap p_frg_pixmap; /* Pane foreground pixmap. */
233 Pixmap s_frg_pixmap; /* Selection foreground pixmap. */
234 Pixmap bkgnd_pixmap; /* Menu background pixmap. */
235 Pixmap inact_pixmap; /* Menu inactive pixmap. */
236} XMenu;
237
b782e2d7
DN
238typedef void (*Wait_func)(void*);
239
e745ede7
DL
240/*
241 * XMenu library routine declarations.
242 */
55660072
PE
243XMenu *XMenuCreate(Display *display, Window parent, char const *def_env);
244int XMenuAddPane(Display *display, XMenu *menu, char const *label, int active);
245int XMenuAddSelection(Display *display, XMenu *menu, int p_num, char *data, char *label, int active, char const *help);
246int XMenuInsertPane(XMenu *menu, int p_num, char *label, int active);
247int XMenuInsertSelection(XMenu *menu, int p_num, int s_num, char *data, char *label, int active);
248int XMenuFindPane(XMenu *menu, char *label);
249int XMenuFindSelection(XMenu *menu, int p_num, char *label);
250int XMenuChangePane(XMenu *menu, int p_num, char *label);
251int XMenuChangeSelection(Display *display, XMenu *menu, int p_num, int s_num, char *data, int data_sw, char *label, int label_sw);
252int XMenuSetPane(XMenu *menu, int p_num, int active);
253int XMenuSetSelection(XMenu *menu, int p_num, int s_num, int active);
254int XMenuRecompute(Display *display, XMenu *menu);
255void XMenuEventHandler(int (*handler) (XEvent *));
256int XMenuLocate(Display *display, XMenu *menu, int p_num, int s_num, int x_pos, int y_pos, int *ul_x, int *ul_y, int *width, int *height);
257void XMenuSetFreeze(XMenu *menu, int freeze);
b782e2d7 258void XMenuActivateSetWaitFunction(Wait_func func, void *data);
55660072
PE
259int XMenuActivate(Display *display, XMenu *menu, int *p_num, int *s_num, int x_pos, int y_pos, unsigned int event_mask, char **data, void (*help_callback) (char const *, int, int));
260char *XMenuPost(Display *display, XMenu *menu, int *p_num, int *s_num, int x_pos, int y_pos, int event_mask);
261int XMenuDeletePane(Display *display, XMenu *menu, int p_num);
262int XMenuDeleteSelection(Display *display, XMenu *menu, int p_num, int s_num);
263void XMenuDestroy(Display *display, XMenu *menu);
264char const *XMenuError(void);
265void XMenuSetAEQ(XMenu *menu, int aeq);
e745ede7
DL
266
267#endif
268/* Don't add after this point. */