shared_source/c_tk_base_7_5_w_mods/tkmenubutton.h

/* $Header: /cvsroot/esrg/sfesrg/esrgpcpj/shared/tk_base/tkmenubutton.h,v 1.1.1.1 2001/06/13 05:05:58 dtashley Exp $ */

/*
 * tkMenubutton.h --
 *
 *      Declarations of types and functions used to implement
 *      the menubutton widget.
 *
 * Copyright (c) 1996-1997 by Sun Microsystems, Inc.
 *
 * See the file "license.terms" for information on usage and redistribution
 * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 *
 * RCS: @(#) $Id: tkmenubutton.h,v 1.1.1.1 2001/06/13 05:05:58 dtashley Exp $
 */

#ifndef _TKMENUBUTTON
#define _TKMENUBUTTON

#ifndef _TKINT
#include "tkInt.h"
#endif

#ifdef BUILD_tk
# undef TCL_STORAGE_CLASS
# define TCL_STORAGE_CLASS DLLEXPORT
#endif

/*
 * Legal values for the "orient" field of TkMenubutton records.
 */

enum direction {
    DIRECTION_ABOVE, DIRECTION_BELOW, DIRECTION_FLUSH, 
    DIRECTION_LEFT, DIRECTION_RIGHT
};

/*
 * Legal values for the "state" field of TkMenubutton records.
 */

enum state {
    STATE_ACTIVE, STATE_DISABLED, STATE_NORMAL
};

/*
 * A data structure of the following type is kept for each
 * widget managed by this file:
 */

typedef struct {
    Tk_Window tkwin;            /* Window that embodies the widget.  NULL
                                 * means that the window has been destroyed
                                 * but the data structures haven't yet been
                                 * cleaned up.*/
    Display *display;           /* Display containing widget.  Needed, among
                                 * other things, so that resources can bee
                                 * freed up even after tkwin has gone away. */
    Tcl_Interp *interp;         /* Interpreter associated with menubutton. */
    Tcl_Command widgetCmd;      /* Token for menubutton's widget command. */
    Tk_OptionTable optionTable; /* Table that defines configuration options
                                 * available for this widget. */
    char *menuName;             /* Name of menu associated with widget.
                                 * Malloc-ed. */

    /*
     * Information about what's displayed in the menu button:
     */

    char *text;                 /* Text to display in button (malloc'ed)
                                 * or NULL. */
    int underline;              /* Index of character to underline. */
    char *textVarName;          /* Name of variable (malloc'ed) or NULL.
                                 * If non-NULL, button displays the contents
                                 * of this variable. */
    Pixmap bitmap;              /* Bitmap to display or None.  If not None
                                 * then text and textVar and underline
                                 * are ignored. */
    char *imageString;          /* Name of image to display (malloc'ed), or
                                 * NULL.  If non-NULL, bitmap, text, and
                                 * textVarName are ignored. */
    Tk_Image image;             /* Image to display in window, or NULL if
                                 * none. */

    /*
     * Information used when displaying widget:
     */

    enum state state;           /* State of button for display purposes:
                                 * normal, active, or disabled. */
    Tk_3DBorder normalBorder;   /* Structure used to draw 3-D
                                 * border and background when window
                                 * isn't active.  NULL means no such
                                 * border exists. */
    Tk_3DBorder activeBorder;   /* Structure used to draw 3-D
                                 * border and background when window
                                 * is active.  NULL means no such
                                 * border exists. */
    int borderWidth;            /* Width of border. */
    int relief;                 /* 3-d effect: TK_RELIEF_RAISED, etc. */
    int highlightWidth;         /* Width in pixels of highlight to draw
                                 * around widget when it has the focus.
                                 * <= 0 means don't draw a highlight. */
    XColor *highlightBgColorPtr;
                                /* Color for drawing traversal highlight
                                 * area when highlight is off. */
    XColor *highlightColorPtr;  /* Color for drawing traversal highlight. */
    int inset;                  /* Total width of all borders, including
                                 * traversal highlight and 3-D border.
                                 * Indicates how much interior stuff must
                                 * be offset from outside edges to leave
                                 * room for borders. */
    Tk_Font tkfont;             /* Information about text font, or NULL. */
    XColor *normalFg;           /* Foreground color in normal mode. */
    XColor *activeFg;           /* Foreground color in active mode.  NULL
                                 * means use normalFg instead. */
    XColor *disabledFg;         /* Foreground color when disabled.  NULL
                                 * means use normalFg with a 50% stipple
                                 * instead. */
    GC normalTextGC;            /* GC for drawing text in normal mode. */
    GC activeTextGC;            /* GC for drawing text in active mode (NULL
                                 * means use normalTextGC). */
    Pixmap gray;                /* Pixmap for displaying disabled text/icon if
                                 * disabledFg is NULL. */
    GC disabledGC;              /* Used to produce disabled effect.  If
                                 * disabledFg isn't NULL, this GC is used to
                                 * draw button text or icon.  Otherwise
                                 * text or icon is drawn with normalGC and
                                 * this GC is used to stipple background
                                 * across it. */
    int leftBearing;            /* Distance from text origin to leftmost drawn
                                 * pixel (positive means to right). */
    int rightBearing;           /* Amount text sticks right from its origin. */
    char *widthString;          /* Value of -width option.  Malloc'ed. */
    char *heightString;         /* Value of -height option.  Malloc'ed. */
    int width, height;          /* If > 0, these specify dimensions to request
                                 * for window, in characters for text and in
                                 * pixels for bitmaps.  In this case the actual
                                 * size of the text string or bitmap is
                                 * ignored in computing desired window size. */
    int wrapLength;             /* Line length (in pixels) at which to wrap
                                 * onto next line.  <= 0 means don't wrap
                                 * except at newlines. */
    int padX, padY;             /* Extra space around text or bitmap (pixels
                                 * on each side). */
    Tk_Anchor anchor;           /* Where text/bitmap should be displayed
                                 * inside window region. */
    Tk_Justify justify;         /* Justification to use for multi-line text. */
    int textWidth;              /* Width needed to display text as requested,
                                 * in pixels. */
    int textHeight;             /* Height needed to display text as requested,
                                 * in pixels. */
    Tk_TextLayout textLayout;   /* Saved text layout information. */
    int indicatorOn;            /* Non-zero means display indicator;  0 means
                                 * don't display. */
    int indicatorHeight;        /* Height of indicator in pixels.  This same
                                 * amount of extra space is also left on each
                                 * side of the indicator. 0 if no indicator. */
    int indicatorWidth;         /* Width of indicator in pixels, including
                                 * indicatorHeight in padding on each side.
                                 * 0 if no indicator. */

    /*
     * Miscellaneous information:
     */

    enum direction direction;   /* Direction for where to pop the menu.
                                 * Valid directions are "above", "below",
                                 * "left", "right", and "flush". "flush"
                                 * means that the upper left corner of the
                                 * menubutton is where the menu pops up.
                                 * "above" and "below" will attempt to pop
                                 * the menu compleletly above or below
                                 * the menu respectively.
                                 * "left" and "right" will pop the menu
                                 * left or right, and the active item
                                 * will be next to the button. */
    Tk_Cursor cursor;           /* Current cursor for window, or None. */
    char *takeFocus;            /* Value of -takefocus option;  not used in
                                 * the C code, but used by keyboard traversal
                                 * scripts.  Malloc'ed, but may be NULL. */
    int flags;                  /* Various flags;  see below for
                                 * definitions. */
} TkMenuButton;

/*
 * Flag bits for buttons:
 *
 * REDRAW_PENDING:              Non-zero means a DoWhenIdle handler
 *                              has already been queued to redraw
 *                              this window.
 * POSTED:                      Non-zero means that the menu associated
 *                              with this button has been posted (typically
 *                              because of an active button press).
 * GOT_FOCUS:                   Non-zero means this button currently
 *                              has the input focus.
 */

#define REDRAW_PENDING          1
#define POSTED                  2
#define GOT_FOCUS               4

/*
 * The following constants define the dimensions of the cascade indicator,
 * which is displayed if the "-indicatoron" option is true.  The units for
 * these options are 1/10 millimeters.
 */

#define INDICATOR_WIDTH         40
#define INDICATOR_HEIGHT        17

/*
 * Declaration of variables shared between the files in the button module.
 */

extern TkClassProcs tkpMenubuttonClass;

/*
 * Declaration of procedures used in the implementation of the button
 * widget. 
 */

extern void             TkpComputeMenuButtonGeometry _ANSI_ARGS_((
                            TkMenuButton *mbPtr));
extern TkMenuButton *   TkpCreateMenuButton _ANSI_ARGS_((Tk_Window tkwin));
extern void             TkpDisplayMenuButton _ANSI_ARGS_((
                            ClientData clientData));
extern void             TkpDestroyMenuButton _ANSI_ARGS_((
                            TkMenuButton *mbPtr));
extern void             TkMenuButtonWorldChanged _ANSI_ARGS_((
                            ClientData instanceData));

# undef TCL_STORAGE_CLASS
# define TCL_STORAGE_CLASS DLLIMPORT

#endif /* _TKMENUBUTTON */


/* $History: tkMenubutton.h $
 * 
 * *****************  Version 1  *****************
 * User: Dtashley     Date: 1/02/01    Time: 2:57a
 * Created in $/IjuScripter, IjuConsole/Source/Tk Base
 * Initial check-in.
 */

/* End of TKMENUBUTTON.H */
1	dashley	25	/* $Header: /cvsroot/esrg/sfesrg/esrgpcpj/shared/tk_base/tkmenubutton.h,v 1.1.1.1 2001/06/13 05:05:58 dtashley Exp $ */
2
3			/*
4			* tkMenubutton.h --
5			*
6			* Declarations of types and functions used to implement
7			* the menubutton widget.
8			*
9			* Copyright (c) 1996-1997 by Sun Microsystems, Inc.
10			*
11			* See the file "license.terms" for information on usage and redistribution
12			* of this file, and for a DISCLAIMER OF ALL WARRANTIES.
13			*
14			* RCS: @(#) $Id: tkmenubutton.h,v 1.1.1.1 2001/06/13 05:05:58 dtashley Exp $
15			*/
16
17			#ifndef _TKMENUBUTTON
18			#define _TKMENUBUTTON
19
20			#ifndef _TKINT
21			#include "tkInt.h"
22			#endif
23
24			#ifdef BUILD_tk
25			# undef TCL_STORAGE_CLASS
26			# define TCL_STORAGE_CLASS DLLEXPORT
27			#endif
28
29			/*
30			* Legal values for the "orient" field of TkMenubutton records.
31			*/
32
33			enum direction {
34			DIRECTION_ABOVE, DIRECTION_BELOW, DIRECTION_FLUSH,
35			DIRECTION_LEFT, DIRECTION_RIGHT
36			};
37
38			/*
39			* Legal values for the "state" field of TkMenubutton records.
40			*/
41
42			enum state {
43			STATE_ACTIVE, STATE_DISABLED, STATE_NORMAL
44			};
45
46			/*
47			* A data structure of the following type is kept for each
48			* widget managed by this file:
49			*/
50
51			typedef struct {
52			Tk_Window tkwin; /* Window that embodies the widget. NULL
53			* means that the window has been destroyed
54			* but the data structures haven't yet been
55			* cleaned up.*/
56			Display display; / Display containing widget. Needed, among
57			* other things, so that resources can bee
58			* freed up even after tkwin has gone away. */
59			Tcl_Interp interp; / Interpreter associated with menubutton. */
60			Tcl_Command widgetCmd; /* Token for menubutton's widget command. */
61			Tk_OptionTable optionTable; /* Table that defines configuration options
62			* available for this widget. */
63			char menuName; / Name of menu associated with widget.
64			* Malloc-ed. */
65
66			/*
67			* Information about what's displayed in the menu button:
68			*/
69
70			char text; / Text to display in button (malloc'ed)
71			* or NULL. */
72			int underline; /* Index of character to underline. */
73			char textVarName; / Name of variable (malloc'ed) or NULL.
74			* If non-NULL, button displays the contents
75			* of this variable. */
76			Pixmap bitmap; /* Bitmap to display or None. If not None
77			* then text and textVar and underline
78			* are ignored. */
79			char imageString; / Name of image to display (malloc'ed), or
80			* NULL. If non-NULL, bitmap, text, and
81			* textVarName are ignored. */
82			Tk_Image image; /* Image to display in window, or NULL if
83			* none. */
84
85			/*
86			* Information used when displaying widget:
87			*/
88
89			enum state state; /* State of button for display purposes:
90			* normal, active, or disabled. */
91			Tk_3DBorder normalBorder; /* Structure used to draw 3-D
92			* border and background when window
93			* isn't active. NULL means no such
94			* border exists. */
95			Tk_3DBorder activeBorder; /* Structure used to draw 3-D
96			* border and background when window
97			* is active. NULL means no such
98			* border exists. */
99			int borderWidth; /* Width of border. */
100			int relief; /* 3-d effect: TK_RELIEF_RAISED, etc. */
101			int highlightWidth; /* Width in pixels of highlight to draw
102			* around widget when it has the focus.
103			* <= 0 means don't draw a highlight. */
104			XColor *highlightBgColorPtr;
105			/* Color for drawing traversal highlight
106			* area when highlight is off. */
107			XColor highlightColorPtr; / Color for drawing traversal highlight. */
108			int inset; /* Total width of all borders, including
109			* traversal highlight and 3-D border.
110			* Indicates how much interior stuff must
111			* be offset from outside edges to leave
112			* room for borders. */
113			Tk_Font tkfont; /* Information about text font, or NULL. */
114			XColor normalFg; / Foreground color in normal mode. */
115			XColor activeFg; / Foreground color in active mode. NULL
116			* means use normalFg instead. */
117			XColor disabledFg; / Foreground color when disabled. NULL
118			* means use normalFg with a 50% stipple
119			* instead. */
120			GC normalTextGC; /* GC for drawing text in normal mode. */
121			GC activeTextGC; /* GC for drawing text in active mode (NULL
122			* means use normalTextGC). */
123			Pixmap gray; /* Pixmap for displaying disabled text/icon if
124			* disabledFg is NULL. */
125			GC disabledGC; /* Used to produce disabled effect. If
126			* disabledFg isn't NULL, this GC is used to
127			* draw button text or icon. Otherwise
128			* text or icon is drawn with normalGC and
129			* this GC is used to stipple background
130			* across it. */
131			int leftBearing; /* Distance from text origin to leftmost drawn
132			* pixel (positive means to right). */
133			int rightBearing; /* Amount text sticks right from its origin. */
134			char widthString; / Value of -width option. Malloc'ed. */
135			char heightString; / Value of -height option. Malloc'ed. */
136			int width, height; /* If > 0, these specify dimensions to request
137			* for window, in characters for text and in
138			* pixels for bitmaps. In this case the actual
139			* size of the text string or bitmap is
140			* ignored in computing desired window size. */
141			int wrapLength; /* Line length (in pixels) at which to wrap
142			* onto next line. <= 0 means don't wrap
143			* except at newlines. */
144			int padX, padY; /* Extra space around text or bitmap (pixels
145			* on each side). */
146			Tk_Anchor anchor; /* Where text/bitmap should be displayed
147			* inside window region. */
148			Tk_Justify justify; /* Justification to use for multi-line text. */
149			int textWidth; /* Width needed to display text as requested,
150			* in pixels. */
151			int textHeight; /* Height needed to display text as requested,
152			* in pixels. */
153			Tk_TextLayout textLayout; /* Saved text layout information. */
154			int indicatorOn; /* Non-zero means display indicator; 0 means
155			* don't display. */
156			int indicatorHeight; /* Height of indicator in pixels. This same
157			* amount of extra space is also left on each
158			* side of the indicator. 0 if no indicator. */
159			int indicatorWidth; /* Width of indicator in pixels, including
160			* indicatorHeight in padding on each side.
161			* 0 if no indicator. */
162
163			/*
164			* Miscellaneous information:
165			*/
166
167			enum direction direction; /* Direction for where to pop the menu.
168			* Valid directions are "above", "below",
169			* "left", "right", and "flush". "flush"
170			* means that the upper left corner of the
171			* menubutton is where the menu pops up.
172			* "above" and "below" will attempt to pop
173			* the menu compleletly above or below
174			* the menu respectively.
175			* "left" and "right" will pop the menu
176			* left or right, and the active item
177			* will be next to the button. */
178			Tk_Cursor cursor; /* Current cursor for window, or None. */
179			char takeFocus; / Value of -takefocus option; not used in
180			* the C code, but used by keyboard traversal
181			* scripts. Malloc'ed, but may be NULL. */
182			int flags; /* Various flags; see below for
183			* definitions. */
184			} TkMenuButton;
185
186			/*
187			* Flag bits for buttons:
188			*
189			* REDRAW_PENDING: Non-zero means a DoWhenIdle handler
190			* has already been queued to redraw
191			* this window.
192			* POSTED: Non-zero means that the menu associated
193			* with this button has been posted (typically
194			* because of an active button press).
195			* GOT_FOCUS: Non-zero means this button currently
196			* has the input focus.
197			*/
198
199			#define REDRAW_PENDING 1
200			#define POSTED 2
201			#define GOT_FOCUS 4
202
203			/*
204			* The following constants define the dimensions of the cascade indicator,
205			* which is displayed if the "-indicatoron" option is true. The units for
206			* these options are 1/10 millimeters.
207			*/
208
209			#define INDICATOR_WIDTH 40
210			#define INDICATOR_HEIGHT 17
211
212			/*
213			* Declaration of variables shared between the files in the button module.
214			*/
215
216			extern TkClassProcs tkpMenubuttonClass;
217
218			/*
219			* Declaration of procedures used in the implementation of the button
220			* widget.
221			*/
222
223			extern void TkpComputeMenuButtonGeometry _ANSI_ARGS_((
224			TkMenuButton *mbPtr));
225			extern TkMenuButton * TkpCreateMenuButton _ANSI_ARGS_((Tk_Window tkwin));
226			extern void TkpDisplayMenuButton _ANSI_ARGS_((
227			ClientData clientData));
228			extern void TkpDestroyMenuButton _ANSI_ARGS_((
229			TkMenuButton *mbPtr));
230			extern void TkMenuButtonWorldChanged _ANSI_ARGS_((
231			ClientData instanceData));
232
233			# undef TCL_STORAGE_CLASS
234			# define TCL_STORAGE_CLASS DLLIMPORT
235
236			#endif /* _TKMENUBUTTON */
237
238
239			/* $History: tkMenubutton.h $
240			*
241			* *************** Version 1 ***************
242			* User: Dtashley Date: 1/02/01 Time: 2:57a
243			* Created in $/IjuScripter, IjuConsole/Source/Tk Base
244			* Initial check-in.
245			*/
246
247			/* End of TKMENUBUTTON.H */