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