Logo Search packages:      
Sourcecode: xaw3d version File versions  Download package

SimpleMenu.h

/*
 * $XConsortium: SimpleMenu.h,v 1.22 94/04/17 20:12:47 kaleb Exp $
 *
Copyright (c) 1989, 1994  X Consortium

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the X Consortium shall not be
used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization from the X Consortium.
 *
 * Author:  Chris D. Peterson, MIT X Consortium
 */

/*
 * SimpleMenu.h - Public Header file for SimpleMenu widget.
 *
 * This is the public header file for the Athena SimpleMenu widget.
 * It is intended to provide one pane pulldown and popup menus within
 * the framework of the X Toolkit.  As the name implies it is a first and
 * by no means complete implementation of menu code. It does not attempt to
 * fill the needs of all applications, but does allow a resource oriented
 * interface to menus.
 *
 * Date:    April 3, 1989
 *
 * By:      Chris D. Peterson
 *          MIT X Consortium 
 *          kit@expo.lcs.mit.edu
 */

#ifndef _SimpleMenu_h
#define _SimpleMenu_h

#include <X11/Shell.h>
#include <X11/Xmu/Converters.h>

/****************************************************************
 *
 * SimpleMenu widget
 *
 ****************************************************************/

/* SimpleMenu Resources:

 Name            Class        RepType           Default Value
 ----            -----        -------           -------------
 background      Background         Pixel       XtDefaultBackground
 backgroundPixmap    BackgroundPixmap     Pixmap          None
 borderColor           BorderColor  Pixel       XtDefaultForeground
 borderPixmap          BorderPixmap Pixmap            None
 borderWidth           BorderWidth  Dimension   1
 bottomMargin        VerticalMargins    Dimension       VerticalSpace
 columnWidth         ColumnWidth        Dimension       Width of widest text
 cursor              Cursor             Cursor          None
 destroyCallback     Callback       Pointer           NULL
 height                Height       Dimension   0
 label               Label              String          NULL (No label)
 labelClass          LabelClass         Pointer         smeBSBObjectClass
 mappedWhenManaged   MappedWhenManaged    Boolean           True
 rowHeight           RowHeight          Dimension       Height of Font
 sensitive       Sensitive          Boolean           True
 topMargin           VerticalMargins    Dimension       VerticalSpace
 width                 Width        Dimension   0
 x               Position           Position    0n
 y               Position           Position    0

*/

typedef struct _SimpleMenuClassRec* SimpleMenuWidgetClass;
typedef struct _SimpleMenuRec*            SimpleMenuWidget;

extern WidgetClass simpleMenuWidgetClass;

#define XtNcursor "cursor"
#define XtNbottomMargin "bottomMargin"
#define XtNcolumnWidth "columnWidth"
#define XtNlabelClass "labelClass"
#define XtNmenuOnScreen "menuOnScreen"
#define XtNpopupOnEntry "popupOnEntry"
#define XtNrowHeight "rowHeight"
#define XtNtopMargin "topMargin"
#define XtNjumpScroll "jumpScroll"
#define XtNleftWhitespace "leftWhitespace"
#define XtNrightWhitespace "rightWhitespace"

#define XtCColumnWidth "ColumnWidth"
#define XtCLabelClass "LabelClass"
#define XtCMenuOnScreen "MenuOnScreen"
#define XtCPopupOnEntry "PopupOnEntry"
#define XtCRowHeight "RowHeight"
#define XtCVerticalMargins "VerticalMargins"
#define XtCJumpScroll "JumpScroll"
#define XtCLeftWhitespace "LeftWhitespace"
#define XtCRightWhitespace "RightWhitespace"
#define XtCHorizontalWhitespace "HorizontalWhitespace"

/************************************************************
 *
 * Public Functions.
 *
 ************************************************************/

_XFUNCPROTOBEGIN

/*    Function Name: XawSimpleMenuAddGlobalActions
 *    Description: adds the global actions to the simple menu widget.
 *    Arguments: app_con - the appcontext.
 *    Returns: none.
 */

extern void XawSimpleMenuAddGlobalActions(
#if NeedFunctionPrototypes
    XtAppContext  /* app_con */
#endif
);
 
/*    Function Name: XawSimpleMenuGetActiveEntry
 *    Description: Gets the currently active (set) entry.
 *    Arguments: w - the smw widget.
 *    Returns: the currently set entry or NULL if none is set.
 */

extern Widget XawSimpleMenuGetActiveEntry(
#if NeedFunctionPrototypes
    Widget        /* w */
#endif
);

/*    Function Name: XawSimpleMenuClearActiveEntry
 *    Description: Unsets the currently active (set) entry.
 *    Arguments: w - the smw widget.
 *    Returns: none.
 */

extern void XawSimpleMenuClearActiveEntry(
#if NeedFunctionPrototypes
    Widget        /* w */
#endif
);

_XFUNCPROTOEND

#endif /* _SimpleMenu_h */

Generated by  Doxygen 1.6.0   Back to index