440
+ − 1 #ifndef INCLUDED_lwlib_h_
+ − 2 #define INCLUDED_lwlib_h_
428
+ − 3
+ − 4 #include <X11/Intrinsic.h>
+ − 5
+ − 6 #if defined (LWLIB_MENUBARS_LUCID) || defined (LWLIB_MENUBARS_MOTIF) || defined (LWLIB_MENUBARS_ATHENA)
+ − 7 #define NEED_MENUBARS
+ − 8 #endif
+ − 9 #if defined (LWLIB_SCROLLBARS_LUCID) || defined (LWLIB_SCROLLBARS_MOTIF) || defined (LWLIB_SCROLLBARS_ATHENA)
+ − 10 #define NEED_SCROLLBARS
+ − 11 #endif
+ − 12 #if defined (LWLIB_DIALOGS_LUCID) || defined (LWLIB_DIALOGS_MOTIF) || defined (LWLIB_DIALOGS_ATHENA)
+ − 13 #define NEED_DIALOGS
+ − 14 #endif
+ − 15
+ − 16 /*
+ − 17 ** Widget values depend on the Widget type:
+ − 18 **
+ − 19 ** widget: (name value key enabled data contents/selected)
+ − 20 **
+ − 21 ** label: ("name" "string" NULL NULL NULL NULL)
+ − 22 ** BUTTON: ("name" "string" "key" T/F data <default-button-p>)
+ − 23 ** CASCADE (button w/menu):
+ − 24 ** ("name" "string" "key" T/F data (label|button|button w/menu...))
+ − 25 ** INCREMENTAL (button w/menu construction callback):
+ − 26 ** ("name" "string" NULL T/F <opaque pointer>)
+ − 27 ** menubar: ("name" NULL NULL T/F data (button w/menu))
+ − 28 ** scrollbar:("name" NULL NULL T/F NULL NULL)
+ − 29 ** selectable thing:
+ − 30 ** ("name" "string" "key" T/F data T/F)
+ − 31 ** checkbox: selectable thing
+ − 32 ** radio: ("name" NULL NULL T/F data (selectable thing...))
+ − 33 ** strings: ("name" NULL NULL T/F data (selectable thing...))
+ − 34 ** TEXT: ("name" "string" <ign> T/F data)
+ − 35 **
+ − 36 ** Note that the above is EXTREMELY bogus. The "type" of the various entities
+ − 37 ** that a widget_value structure can represent is implicit in the contents of
+ − 38 ** half a dozen slots, instead of there simply being a type field. This
+ − 39 ** should all be rethunk. I've added a type field, but for now it's only used
+ − 40 ** by the new xlwmenu code.
+ − 41 */
+ − 42
+ − 43 typedef unsigned long LWLIB_ID;
+ − 44
+ − 45 typedef enum _change_type
+ − 46 {
+ − 47 NO_CHANGE = 0,
+ − 48 INVISIBLE_CHANGE = 1,
+ − 49 VISIBLE_CHANGE = 2,
+ − 50 STRUCTURAL_CHANGE = 3
+ − 51 } change_type;
+ − 52
+ − 53 typedef enum _widget_value_type
+ − 54 {
+ − 55 UNSPECIFIED_TYPE = 0,
+ − 56 BUTTON_TYPE = 1,
+ − 57 TOGGLE_TYPE = 2,
+ − 58 RADIO_TYPE = 3,
+ − 59 TEXT_TYPE = 4,
+ − 60 SEPARATOR_TYPE = 5,
+ − 61 CASCADE_TYPE = 6,
+ − 62 PUSHRIGHT_TYPE = 7,
+ − 63 INCREMENTAL_TYPE = 8
+ − 64 } widget_value_type;
+ − 65
+ − 66 typedef enum _scroll_action
+ − 67 {
+ − 68 SCROLLBAR_LINE_UP = 0,
+ − 69 SCROLLBAR_LINE_DOWN = 1,
+ − 70 SCROLLBAR_PAGE_UP = 2,
+ − 71 SCROLLBAR_PAGE_DOWN = 3,
+ − 72 SCROLLBAR_DRAG = 4,
+ − 73 SCROLLBAR_CHANGE = 5,
+ − 74 SCROLLBAR_TOP = 6,
+ − 75 SCROLLBAR_BOTTOM = 7
+ − 76 } scroll_action;
+ − 77
+ − 78 typedef struct _scroll_event
+ − 79 {
+ − 80 scroll_action action;
+ − 81 int slider_value;
+ − 82 Time time;
+ − 83 } scroll_event;
+ − 84
+ − 85 typedef struct _scrollbar_values
+ − 86 {
+ − 87 int line_increment;
+ − 88 int page_increment;
+ − 89
+ − 90 int minimum;
+ − 91 int maximum;
+ − 92
+ − 93 int slider_size;
+ − 94 int slider_position;
+ − 95
+ − 96 int scrollbar_width, scrollbar_height;
+ − 97 int scrollbar_x, scrollbar_y;
+ − 98 } scrollbar_values;
+ − 99
434
+ − 100 typedef struct _widget_args
+ − 101 {
+ − 102 /* some things are only possible at creation time. args are applied
+ − 103 to widgets at creation time. */
+ − 104 ArgList args;
+ − 105 int nargs;
+ − 106 /* Copying args is impossible so we make the caller give us heap allocated
444
+ − 107 args and free them when no one wants them any more. */
434
+ − 108 int ref_count;
450
+ − 109 /* Since we are reference counting we need to be able to determine
+ − 110 when something has changed. */
+ − 111 Boolean args_changed;
434
+ − 112 } widget_args;
+ − 113
428
+ − 114 typedef struct _widget_value
+ − 115 {
+ − 116 /* This slot is only partially utilized right now. */
+ − 117 widget_value_type type;
+ − 118
+ − 119 /* name of widget */
+ − 120 char* name;
444
+ − 121 /* value (meaning BOGUSLY depends on widget type) */
428
+ − 122 char* value;
+ − 123 /* keyboard equivalent. no implications for XtTranslations */
+ − 124 char* key;
+ − 125 /* accelerator key. For XEmacs, this should be a Lisp_Object holding a
+ − 126 char or symbol suitable for passing to event_matches_key_specifier_p.
+ − 127 Outside of emacs, this can be anything: an X KeySym is a good idea.
+ − 128 lwlib provides support functions for keyboard traversal of menus. Actual
+ − 129 implementation of those accelerators is up to the application.
+ − 130 */
+ − 131 XtPointer accel;
+ − 132 /* true if enabled */
+ − 133 Boolean enabled;
+ − 134 /* true if selected */
+ − 135 Boolean selected;
+ − 136 /* true if was edited (maintained by get_value) */
+ − 137 Boolean edited;
+ − 138 /* true if has changed (maintained by lw library) */
+ − 139 change_type change;
444
+ − 140 /* Contents of sub-widgets, also selected slot for checkbox */
428
+ − 141 struct _widget_value* contents;
+ − 142 /* data passed to callback */
+ − 143 XtPointer call_data;
444
+ − 144 /* next in the list of siblings */
428
+ − 145 struct _widget_value* next;
+ − 146 /* slot for the toolkit dependent part. Always initialize to NULL. */
+ − 147 void* toolkit_data;
+ − 148 /* tell us if we should free the toolkit data slot when freeing the
+ − 149 widget_value itself. */
+ − 150 Boolean free_toolkit_data;
+ − 151
+ − 152 /* data defining a scrollbar; only valid if type == "scrollbar" */
+ − 153 scrollbar_values *scrollbar_data;
+ − 154
434
+ − 155 /* A reference counted arg structure. */
+ − 156 struct _widget_args *args;
428
+ − 157 /* we resource the widget_value structures; this points to the next
+ − 158 one on the free list if this one has been deallocated. */
+ − 159 struct _widget_value *free_list;
+ − 160
+ − 161 } widget_value;
+ − 162
+ − 163
+ − 164 typedef void (*lw_callback) (Widget w, LWLIB_ID id, XtPointer data);
+ − 165
+ − 166 /* menu stuff */
+ − 167 /* maybe this should go into a generic lwmenu.h */
+ − 168
+ − 169 extern int lw_menu_active;
+ − 170
+ − 171 #if defined (LWLIB_MENUBARS_LUCID)
+ − 172 #include "xlwmenu.h"
+ − 173 #define lw_set_menu xlw_set_menu
+ − 174 #define lw_push_menu xlw_push_menu
+ − 175 #define lw_pop_menu xlw_pop_menu
+ − 176 #define lw_set_item xlw_set_item
+ − 177 #define lw_map_menu xlw_map_menu
+ − 178 #define lw_display_menu xlw_display_menu
+ − 179 #define lw_kill_menus xlw_kill_menus
+ − 180 #define lw_get_entries xlw_get_entries
+ − 181 #define lw_menu_level xlw_menu_level
+ − 182 #else /* LWLIB_MENUBARS_LUCID */
+ − 183 /* do this for the other toolkits too */
+ − 184 #endif /* LWLIB_MENUBARS_LUCID */
+ − 185
+ − 186 #if defined (LWLIB_TABS_LUCID)
+ − 187 #include "xlwtabs.h"
+ − 188 #endif
+ − 189
442
+ − 190 void lw_register_widget (const char* type, const char* name, LWLIB_ID id,
428
+ − 191 widget_value* val, lw_callback pre_activate_cb,
+ − 192 lw_callback selection_cb,
+ − 193 lw_callback post_activate_cb);
+ − 194 Widget lw_get_widget (LWLIB_ID id, Widget parent, Boolean pop_up_p);
+ − 195 Widget lw_make_widget (LWLIB_ID id, Widget parent, Boolean pop_up_p);
442
+ − 196 Widget lw_create_widget (const char* type, const char* name, LWLIB_ID id,
428
+ − 197 widget_value* val, Widget parent, Boolean pop_up_p,
+ − 198 lw_callback pre_activate_cb,
+ − 199 lw_callback selection_cb,
+ − 200 lw_callback post_activate_cb);
+ − 201 LWLIB_ID lw_get_widget_id (Widget w);
+ − 202 int lw_map_widget_values (LWLIB_ID id, int (*mapfunc) (widget_value *value,
+ − 203 void *closure),
+ − 204 void *closure);
+ − 205 void lw_modify_all_widgets (LWLIB_ID id, widget_value* val, Boolean deep_p);
+ − 206 void lw_destroy_widget (Widget w);
+ − 207 void lw_destroy_all_widgets (LWLIB_ID id);
+ − 208 void lw_destroy_everything (void);
+ − 209 void lw_destroy_all_pop_ups (void);
+ − 210 Widget lw_raise_all_pop_up_widgets (void);
+ − 211 widget_value* lw_get_all_values (LWLIB_ID id);
+ − 212 Boolean lw_get_some_values (LWLIB_ID id, widget_value* val);
+ − 213 void lw_pop_up_all_widgets (LWLIB_ID id);
+ − 214 void lw_pop_down_all_widgets (LWLIB_ID id);
+ − 215 void lw_add_value_args_to_args (widget_value* wv, ArgList addto, int* offset);
434
+ − 216 void lw_add_widget_value_arg (widget_value* wv, String name, XtArgVal value);
639
+ − 217 XtArgVal lw_get_value_arg (widget_value* wv, String name);
434
+ − 218 void lw_copy_widget_value_args (widget_value* copy, widget_value* val);
442
+ − 219 widget_value * copy_widget_value_tree (widget_value *val, change_type change);
428
+ − 220
+ − 221 widget_value *malloc_widget_value (void);
+ − 222 void free_widget_value (widget_value *);
+ − 223 void free_widget_value_tree (widget_value *wv);
+ − 224 widget_value *replace_widget_value_tree (widget_value*, widget_value*);
+ − 225
+ − 226 void lw_popup_menu (Widget, XEvent *);
+ − 227
+ − 228 /* Toolkit independent way of focusing on a Widget at the Xt level. */
+ − 229 void lw_set_keyboard_focus (Widget parent, Widget w);
+ − 230
+ − 231 /* Silly Energize hack to invert the "sheet" button */
+ − 232 void lw_show_busy (Widget w, Boolean busy);
+ − 233
442
+ − 234 void lw_remove_accelerator_spec (char *val);
+ − 235
440
+ − 236 #endif /* INCLUDED_lwlib_h_ */