annotate oldXMenu/Post.c @ 64640:993b52f1f2a5

Regenerate.
author Paul Eggert <eggert@twinsun.com>
date Tue, 26 Jul 2005 21:44:41 +0000
parents e8824c4f5f7e
children 3861ff8f4bf1 8e5779acd195
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25858
Dave Love <fx@gnu.org>
parents:
diff changeset
1 #include "copyright.h"
Dave Love <fx@gnu.org>
parents:
diff changeset
2
Dave Love <fx@gnu.org>
parents:
diff changeset
3 /* Copyright Massachusetts Institute of Technology 1985 */
Dave Love <fx@gnu.org>
parents:
diff changeset
4
Dave Love <fx@gnu.org>
parents:
diff changeset
5 /*
Dave Love <fx@gnu.org>
parents:
diff changeset
6 * XMenu: MIT Project Athena, X Window system menu package
Dave Love <fx@gnu.org>
parents:
diff changeset
7 *
Dave Love <fx@gnu.org>
parents:
diff changeset
8 * XMenuPost - Maps a given menu to the display and activates
Dave Love <fx@gnu.org>
parents:
diff changeset
9 * the menu for user selection. The user is allowed to
Dave Love <fx@gnu.org>
parents:
diff changeset
10 * specify the mouse button event mask that will be used
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 27456
diff changeset
11 * to identify a selection request. When a selection
25858
Dave Love <fx@gnu.org>
parents:
diff changeset
12 * request is received (i.e., when the specified mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
13 * event occurs) the data returned will be either the
Dave Love <fx@gnu.org>
parents:
diff changeset
14 * data associated with the particular selection active
Dave Love <fx@gnu.org>
parents:
diff changeset
15 * at the time of the selection request or NULL if no
Dave Love <fx@gnu.org>
parents:
diff changeset
16 * selection was active. A menu selection is shown to
Dave Love <fx@gnu.org>
parents:
diff changeset
17 * be active by placing a highlight box around the
Dave Love <fx@gnu.org>
parents:
diff changeset
18 * selection as the mouse cursor enters its active
Dave Love <fx@gnu.org>
parents:
diff changeset
19 * region. Inactive selections will not be highlighted.
Dave Love <fx@gnu.org>
parents:
diff changeset
20 * As the mouse cursor moved from one menu pane
Dave Love <fx@gnu.org>
parents:
diff changeset
21 * to another menu pane the pane being entered is raised
Dave Love <fx@gnu.org>
parents:
diff changeset
22 * and activated and the pane being left is deactivated.
Dave Love <fx@gnu.org>
parents:
diff changeset
23 * If an error occurs NULL will be returned with the
Dave Love <fx@gnu.org>
parents:
diff changeset
24 * p_num set to POST_ERROR, s_num set to
Dave Love <fx@gnu.org>
parents:
diff changeset
25 * NO_SELECTION and _XMErrorCode set to an
Dave Love <fx@gnu.org>
parents:
diff changeset
26 * appropriate value.
Dave Love <fx@gnu.org>
parents:
diff changeset
27 * Every time the routine returns successfully the
Dave Love <fx@gnu.org>
parents:
diff changeset
28 * p_num and s_num indices will be set to indicate
Dave Love <fx@gnu.org>
parents:
diff changeset
29 * the currently active pane and/or selection. If the
Dave Love <fx@gnu.org>
parents:
diff changeset
30 * mouse was not in a selection window at the time
Dave Love <fx@gnu.org>
parents:
diff changeset
31 * s_num will be set to NO_SELECTION.
Dave Love <fx@gnu.org>
parents:
diff changeset
32 *
Dave Love <fx@gnu.org>
parents:
diff changeset
33 * Author: Tony Della Fera, DEC
Dave Love <fx@gnu.org>
parents:
diff changeset
34 * August, 1984
Dave Love <fx@gnu.org>
parents:
diff changeset
35 *
Dave Love <fx@gnu.org>
parents:
diff changeset
36 */
Dave Love <fx@gnu.org>
parents:
diff changeset
37
Dave Love <fx@gnu.org>
parents:
diff changeset
38 #include "XMenuInt.h"
Dave Love <fx@gnu.org>
parents:
diff changeset
39
Dave Love <fx@gnu.org>
parents:
diff changeset
40 char *
Dave Love <fx@gnu.org>
parents:
diff changeset
41 XMenuPost(display, menu, p_num, s_num, x_pos, y_pos, event_mask)
Dave Love <fx@gnu.org>
parents:
diff changeset
42 register Display *display; /* Previously opened display. */
Dave Love <fx@gnu.org>
parents:
diff changeset
43 register XMenu *menu; /* Menu to post. */
Dave Love <fx@gnu.org>
parents:
diff changeset
44 register int *p_num; /* Pane number selected. */
Dave Love <fx@gnu.org>
parents:
diff changeset
45 register int *s_num; /* Selection number selected. */
Dave Love <fx@gnu.org>
parents:
diff changeset
46 register int x_pos; /* X coordinate of menu position. */
Dave Love <fx@gnu.org>
parents:
diff changeset
47 register int y_pos; /* Y coordinate of menu position. */
Dave Love <fx@gnu.org>
parents:
diff changeset
48 int event_mask; /* Mouse button event mask. */
Dave Love <fx@gnu.org>
parents:
diff changeset
49 {
Dave Love <fx@gnu.org>
parents:
diff changeset
50 register int stat; /* Routine call return status. */
Dave Love <fx@gnu.org>
parents:
diff changeset
51 char *data; /* Return data. */
Dave Love <fx@gnu.org>
parents:
diff changeset
52
Dave Love <fx@gnu.org>
parents:
diff changeset
53 /*
Dave Love <fx@gnu.org>
parents:
diff changeset
54 * Set up initial pane and selection assumptions.
Dave Love <fx@gnu.org>
parents:
diff changeset
55 */
Dave Love <fx@gnu.org>
parents:
diff changeset
56
Dave Love <fx@gnu.org>
parents:
diff changeset
57 /*
Dave Love <fx@gnu.org>
parents:
diff changeset
58 * Make the procedure call.
Dave Love <fx@gnu.org>
parents:
diff changeset
59 */
Dave Love <fx@gnu.org>
parents:
diff changeset
60 stat = XMenuActivate(
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 27456
diff changeset
61 display,
25858
Dave Love <fx@gnu.org>
parents:
diff changeset
62 menu,
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 27456
diff changeset
63 p_num, s_num,
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 27456
diff changeset
64 x_pos, y_pos,
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 27456
diff changeset
65 event_mask,
27456
4a9ea0d1735b (XMenuPost): Pass null help callback to XMenuActivate.
Gerd Moellmann <gerd@gnu.org>
parents: 25858
diff changeset
66 &data, 0);
25858
Dave Love <fx@gnu.org>
parents:
diff changeset
67
Dave Love <fx@gnu.org>
parents:
diff changeset
68 /*
Dave Love <fx@gnu.org>
parents:
diff changeset
69 * Check the return value and return accordingly.
Dave Love <fx@gnu.org>
parents:
diff changeset
70 */
Dave Love <fx@gnu.org>
parents:
diff changeset
71 switch (stat) {
Dave Love <fx@gnu.org>
parents:
diff changeset
72 case XM_FAILURE:
Dave Love <fx@gnu.org>
parents:
diff changeset
73 *p_num = POST_ERROR;
Dave Love <fx@gnu.org>
parents:
diff changeset
74 *s_num = NO_SELECTION;
Dave Love <fx@gnu.org>
parents:
diff changeset
75 return(NULL);
Dave Love <fx@gnu.org>
parents:
diff changeset
76 case XM_NO_SELECT:
Dave Love <fx@gnu.org>
parents:
diff changeset
77 case XM_IA_SELECT:
Dave Love <fx@gnu.org>
parents:
diff changeset
78 *s_num = NO_SELECTION;
Dave Love <fx@gnu.org>
parents:
diff changeset
79 return(NULL);
Dave Love <fx@gnu.org>
parents:
diff changeset
80 case XM_SUCCESS:
Dave Love <fx@gnu.org>
parents:
diff changeset
81 default:
Dave Love <fx@gnu.org>
parents:
diff changeset
82 return(data);
Dave Love <fx@gnu.org>
parents:
diff changeset
83 }
Dave Love <fx@gnu.org>
parents:
diff changeset
84 }
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
85
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
86 /* arch-tag: 7b6104e5-fa32-4342-aa17-05296a30dd70
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
87 (do not change this comment) */