Commit | Line | Data |
---|---|---|
e745ede7 DL |
1 | #include "copyright.h" |
2 | ||
e745ede7 | 3 | /* Copyright Massachusetts Institute of Technology 1985 */ |
61e1e4e8 | 4 | /* Copyright (C) 2001, 2002, 2003, 2004, 2005, |
4e6835db | 5 | 2006, 2007 Free Software Foundation, Inc. */ |
e745ede7 DL |
6 | |
7 | /* | |
8 | * XMenu: MIT Project Athena, X Window system menu package | |
9 | * | |
10 | * XMenuPost - Maps a given menu to the display and activates | |
11 | * the menu for user selection. The user is allowed to | |
12 | * specify the mouse button event mask that will be used | |
177c0ea7 | 13 | * to identify a selection request. When a selection |
e745ede7 DL |
14 | * request is received (i.e., when the specified mouse |
15 | * event occurs) the data returned will be either the | |
16 | * data associated with the particular selection active | |
17 | * at the time of the selection request or NULL if no | |
18 | * selection was active. A menu selection is shown to | |
19 | * be active by placing a highlight box around the | |
20 | * selection as the mouse cursor enters its active | |
21 | * region. Inactive selections will not be highlighted. | |
22 | * As the mouse cursor moved from one menu pane | |
23 | * to another menu pane the pane being entered is raised | |
24 | * and activated and the pane being left is deactivated. | |
25 | * If an error occurs NULL will be returned with the | |
26 | * p_num set to POST_ERROR, s_num set to | |
27 | * NO_SELECTION and _XMErrorCode set to an | |
28 | * appropriate value. | |
29 | * Every time the routine returns successfully the | |
30 | * p_num and s_num indices will be set to indicate | |
31 | * the currently active pane and/or selection. If the | |
32 | * mouse was not in a selection window at the time | |
33 | * s_num will be set to NO_SELECTION. | |
34 | * | |
35 | * Author: Tony Della Fera, DEC | |
36 | * August, 1984 | |
37 | * | |
38 | */ | |
39 | ||
40 | #include "XMenuInt.h" | |
41 | ||
42 | char * | |
43 | XMenuPost(display, menu, p_num, s_num, x_pos, y_pos, event_mask) | |
44 | register Display *display; /* Previously opened display. */ | |
45 | register XMenu *menu; /* Menu to post. */ | |
46 | register int *p_num; /* Pane number selected. */ | |
47 | register int *s_num; /* Selection number selected. */ | |
48 | register int x_pos; /* X coordinate of menu position. */ | |
49 | register int y_pos; /* Y coordinate of menu position. */ | |
50 | int event_mask; /* Mouse button event mask. */ | |
51 | { | |
52 | register int stat; /* Routine call return status. */ | |
53 | char *data; /* Return data. */ | |
54 | ||
55 | /* | |
56 | * Set up initial pane and selection assumptions. | |
57 | */ | |
58 | ||
59 | /* | |
60 | * Make the procedure call. | |
61 | */ | |
62 | stat = XMenuActivate( | |
177c0ea7 | 63 | display, |
e745ede7 | 64 | menu, |
177c0ea7 JB |
65 | p_num, s_num, |
66 | x_pos, y_pos, | |
67 | event_mask, | |
3153caff | 68 | &data, 0); |
e745ede7 DL |
69 | |
70 | /* | |
71 | * Check the return value and return accordingly. | |
72 | */ | |
73 | switch (stat) { | |
74 | case XM_FAILURE: | |
75 | *p_num = POST_ERROR; | |
76 | *s_num = NO_SELECTION; | |
77 | return(NULL); | |
78 | case XM_NO_SELECT: | |
79 | case XM_IA_SELECT: | |
80 | *s_num = NO_SELECTION; | |
81 | return(NULL); | |
82 | case XM_SUCCESS: | |
83 | default: | |
84 | return(data); | |
85 | } | |
86 | } | |
ab5796a9 MB |
87 | |
88 | /* arch-tag: 7b6104e5-fa32-4342-aa17-05296a30dd70 | |
89 | (do not change this comment) */ |