home *** CD-ROM | disk | FTP | other *** search
- #include "copyright.h"
-
- /* $Header: Post.c,v 1.3 87/12/20 12:05:40 rws Exp $ */
- /* Copyright Massachusetts Institute of Technology 1985 */
-
- /*
- * XMenu: MIT Project Athena, X Window system menu package
- *
- * XMenuPost - Maps a given menu to the display and activates
- * the menu for user selection. The user is allowed to
- * specify the mouse button event mask that will be used
- * to identify a selection request. When a selection
- * request is recieved (i.e., when the specified mouse
- * event occurs) the data returned will be either the
- * data associated with the particular selection active
- * at the time of the selection request or NULL if no
- * selection was active. A menu selection is shown to
- * be active by placing a highlight box around the
- * selection as the mouse cursor enters its active
- * region. Inactive selections will not be highlighted.
- * As the mouse cursor moved from one menu pane
- * to another menu pane the pane being entered is raised
- * and activated and the pane being left is inactivated.
- * If an error occurs NULL will be returned with the
- * p_num set to POST_ERROR, s_num set to
- * NO_SELECTION and _XMErrorCode set to an
- * appropriate value.
- * Every time the routine returns successfully the
- * p_num and s_num indices will be set to indicate
- * the currently active pane and/or selection. If the
- * mouse was not in a selection window at the time
- * s_num will be set to NO_SELECTION.
- *
- * Author: Tony Della Fera, DEC
- * August, 1984
- *
- */
-
- #include "XMenuInt.h"
-
- char *
- XMenuPost(display, menu, p_num, s_num, x_pos, y_pos, event_mask)
- register Display *display; /* Previously opened display. */
- register XMenu *menu; /* Menu to post. */
- register int *p_num; /* Pane number selected. */
- register int *s_num; /* Selection number selected. */
- register int x_pos; /* X coordinate of menu position. */
- register int y_pos; /* Y coordinate of menu position. */
- int event_mask; /* Mouse button event mask. */
- {
- register int stat; /* Routine call return status. */
- char *data; /* Return data. */
-
- /*
- * Set up initial pane and selection assumptions.
- */
-
- /*
- * Make the procedure call.
- */
- stat = XMenuActivate(
- display,
- menu,
- p_num, s_num,
- x_pos, y_pos,
- event_mask,
- &data);
-
- /*
- * Check the return value and return accordingly.
- */
- switch (stat) {
- case XM_FAILURE:
- *p_num = POST_ERROR;
- *s_num = NO_SELECTION;
- return(NULL);
- case XM_NO_SELECT:
- case XM_IA_SELECT:
- *s_num = NO_SELECTION;
- return(NULL);
- case XM_SUCCESS:
- default:
- return(data);
- }
- }
-