[bpt/emacs.git] / lwlib / lwlib.h

#ifndef LWLIB_H
#define LWLIB_H

#include <X11/Intrinsic.h>

/*
** Widget values depend on the Widget type:
** 
** widget:   (name value key enabled data contents/selected)
**
** label:    ("name" "string" NULL NULL NULL NULL)
** button:   ("name" "string" "key" T/F data <default-button-p>)
** button w/menu: 
**           ("name" "string" "key" T/F data (label|button|button w/menu...))
** menubar:  ("name" NULL NULL T/F data (button w/menu))
** selectable thing:
**           ("name" "string" "key" T/F data T/F)
** checkbox: selectable thing
** radio:    ("name" NULL NULL T/F data (selectable thing...))
** strings:  ("name" NULL NULL T/F data (selectable thing...))
** text:     ("name" "string" <ign> T/F data)
*/

typedef unsigned long LWLIB_ID;

typedef enum _change_type
{
  NO_CHANGE = 0,
  INVISIBLE_CHANGE = 1,
  VISIBLE_CHANGE = 2,
  STRUCTURAL_CHANGE = 3
} change_type;

typedef struct _widget_value
{
  /* name of widget */
  char*		name;
  /* value (meaning depend on widget type) */
  char*		value;
  /* keyboard equivalent. no implications for XtTranslations */ 
  char*		key;
  /* true if enabled */
  Boolean	enabled;
  /* true if selected */
  Boolean	selected;
  /* true if was edited (maintained by get_value) */
  Boolean	edited;
  /* true if has changed (maintained by lw library) */
  change_type	change;
  /* Contents of the sub-widgets, also selected slot for checkbox */
  struct _widget_value*	contents;
  /* data passed to callback */
  XtPointer	call_data;
  /* next one in the list */
  struct _widget_value*	next;
  /* slot for the toolkit dependent part.  Always initialize to NULL. */
  void* toolkit_data;
  /* tell us if we should free the toolkit data slot when freeing the
     widget_value itself. */
  Boolean free_toolkit_data;

  /* we resource the widget_value structures; this points to the next
     one on the free list if this one has been deallocated.
   */
  struct _widget_value *free_list;
} widget_value;


typedef void (*lw_callback) ();

void  lw_register_widget ();
Widget lw_get_widget ();
Widget lw_make_widget ();
Widget lw_create_widget ();
LWLIB_ID lw_get_widget_id ();
void lw_modify_all_widgets ();
void lw_destroy_widget ();
void lw_destroy_all_widgets ();
void lw_destroy_everything ();
void lw_destroy_all_pop_ups ();
Widget lw_raise_all_pop_up_widgets ();
widget_value* lw_get_all_values ();
Boolean lw_get_some_values ();
void lw_pop_up_all_widgets ();
void lw_pop_down_all_widgets ();
widget_value *malloc_widget_value ();
void free_widget_value ();
void lw_popup_menu ();

/* Toolkit independent way of focusing on a Widget at the Xt level. */
void lw_set_keyboard_focus ();

/* Silly Energize hack to invert the "sheet" button */
void lw_show_busy ();

#endif /* LWLIB_H */
Commit	Line	Data
07bf635f RS	1	#ifndef LWLIB_H
	2	#define LWLIB_H
	3
	4	#include <X11/Intrinsic.h>
	5
	6	/*
	7	** Widget values depend on the Widget type:
	8	**
	9	** widget: (name value key enabled data contents/selected)
	10	**
	11	** label: ("name" "string" NULL NULL NULL NULL)
	12	** button: ("name" "string" "key" T/F data <default-button-p>)
	13	** button w/menu:
	14	** ("name" "string" "key" T/F data (label\|button\|button w/menu...))
	15	** menubar: ("name" NULL NULL T/F data (button w/menu))
	16	** selectable thing:
	17	** ("name" "string" "key" T/F data T/F)
	18	** checkbox: selectable thing
	19	** radio: ("name" NULL NULL T/F data (selectable thing...))
	20	** strings: ("name" NULL NULL T/F data (selectable thing...))
	21	** text: ("name" "string" <ign> T/F data)
	22	*/
	23
	24	typedef unsigned long LWLIB_ID;
	25
	26	typedef enum _change_type
	27	{
	28	NO_CHANGE = 0,
	29	INVISIBLE_CHANGE = 1,
	30	VISIBLE_CHANGE = 2,
	31	STRUCTURAL_CHANGE = 3
	32	} change_type;
	33
	34	typedef struct _widget_value
	35	{
	36	/* name of widget */
	37	char* name;
	38	/* value (meaning depend on widget type) */
	39	char* value;
	40	/* keyboard equivalent. no implications for XtTranslations */
	41	char* key;
	42	/* true if enabled */
	43	Boolean enabled;
	44	/* true if selected */
	45	Boolean selected;
	46	/* true if was edited (maintained by get_value) */
	47	Boolean edited;
	48	/* true if has changed (maintained by lw library) */
	49	change_type change;
	50	/* Contents of the sub-widgets, also selected slot for checkbox */
	51	struct _widget_value* contents;
	52	/* data passed to callback */
	53	XtPointer call_data;
	54	/* next one in the list */
	55	struct _widget_value* next;
	56	/* slot for the toolkit dependent part. Always initialize to NULL. */
	57	void* toolkit_data;
	58	/* tell us if we should free the toolkit data slot when freeing the
	59	widget_value itself. */
	60	Boolean free_toolkit_data;
	61
	62	/* we resource the widget_value structures; this points to the next
	63	one on the free list if this one has been deallocated.
	64	*/
65	struct _widget_value *free_list;
66	} widget_value;
67
68
01492d1b	69	typedef void (*lw_callback) ();
07bf635f	70
01492d1b RS	71	void lw_register_widget ();
	72	Widget lw_get_widget ();
	73	Widget lw_make_widget ();
	74	Widget lw_create_widget ();
	75	LWLIB_ID lw_get_widget_id ();
	76	void lw_modify_all_widgets ();
	77	void lw_destroy_widget ();
	78	void lw_destroy_all_widgets ();
	79	void lw_destroy_everything ();
	80	void lw_destroy_all_pop_ups ();
	81	Widget lw_raise_all_pop_up_widgets ();
	82	widget_value* lw_get_all_values ();
	83	Boolean lw_get_some_values ();
	84	void lw_pop_up_all_widgets ();
	85	void lw_pop_down_all_widgets ();
07bf635f	86	widget_value *malloc_widget_value ();
01492d1b RS	87	void free_widget_value ();
01492d1b RS	88	void lw_popup_menu ();
07bf635f RS	89
07bf635f RS	90	/* Toolkit independent way of focusing on a Widget at the Xt level. */
01492d1b	91	void lw_set_keyboard_focus ();
07bf635f RS	92
07bf635f RS	93	/* Silly Energize hack to invert the "sheet" button */
01492d1b	94	void lw_show_busy ();
07bf635f RS	95
07bf635f RS	96	#endif /* LWLIB_H */