3 * This source code is part of
7 * GROningen MAchine for Chemical Simulations
10 * Written by David van der Spoel, Erik Lindahl, Berk Hess, and others.
11 * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
12 * Copyright (c) 2001-2004, The GROMACS development team,
13 * check out http://www.gromacs.org for more information.
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License
17 * as published by the Free Software Foundation; either version 2
18 * of the License, or (at your option) any later version.
20 * If you want to redistribute modifications, please consider that
21 * scientific software is very special. Version control is crucial -
22 * bugs must be traceable. We will be happy to consider code for
23 * inclusion in the official distribution, but derived work must not
24 * be called official GROMACS. Details are found in the README & COPYING
25 * files - if they are missing, get the official version at www.gromacs.org.
27 * To help us fund GROMACS development, we humbly ask that you cite
28 * the papers on the package - you can find them in the top README file.
30 * For more info, check our website at http://www.gromacs.org
33 * Gyas ROwers Mature At Cryogenic Speed
41 #define DLG_SHOW (1<<0)
42 #define DLG_HIDE (1<<1)
43 #define DLG_SHOWANDHIDE (DLG_SHOW | DLG_HIDE)
44 #define DLG_SYSTEMMODAL (1<<2)
45 #define DLG_APPLMODAL (1<<3)
46 #define DLG_HIDEONBUTTON (1<<4)
47 #define DLG_FREEONBUTTON (1<<5)
53 typedef void DlgCallback (t_x11 *x11, int dlg_mess, int item_id,
54 char *set, void *data);
55 /* User function that can be called by the dialog box. All setting of
56 * check-boxes and radio-buttons etc., is done by the dialog manager,
57 * the user can let himself be informed about mouse activity also.
61 t_x11 *x11; /* All about X */
62 t_windata win; /* The position and size of the window */
63 char *title; /* Window name */
64 Window wDad; /* The parent window */
65 unsigned int xmax, ymax; /* Dimensions of parent window */
66 unsigned long flags; /* Flags for display */
67 unsigned long fg, bg; /* The colours */
68 bool bPop; /* Should we pop the mouse back */
69 bool bGrab; /* Have we grabbed the mouse ? */
70 int nitem; /* The number of items */
71 t_dlgitem **dlgitem; /* The array of item pointers */
72 DlgCallback *cb; /* User call back function */
73 void *data; /* User data */
76 /*****************************
78 * Routine to create the DLG structure, returns NULL on failure
79 * cb and data may be NULL.
81 ****************************/
82 t_dlg *CreateDlg(t_x11 *x11, Window Parent, const char *title,
83 int x0, int y0, int w, int h, int bw,
84 DlgCallback *cb, void *data);
86 /*****************************
88 * Routine to add an item to the dialog box
89 * The pointer to the item is copied to the dlg struct,
90 * the item itself may not be freed until the dlg is done with
92 ****************************/
93 void AddDlgItem(t_dlg *dlg, t_dlgitem *item);
95 void AddDlgItems(t_dlg *dlg, int nitem, t_dlgitem *item[]);
97 /*****************************
99 * Routines to manipulate items on a dialog box
100 * They return true on succes, false otherwise
101 * false will mean most of the time, that item id was not found
103 ****************************/
104 bool QueryDlgItemSize(t_dlg *dlg, t_id id, int *w, int *h);
106 bool QueryDlgItemPos(t_dlg *dlg, t_id id, int *x0, int *y0);
108 int QueryDlgItemX(t_dlg *dlg, t_id id);
110 int QueryDlgItemY(t_dlg *dlg, t_id id);
112 int QueryDlgItemW(t_dlg *dlg, t_id id);
114 int QueryDlgItemH(t_dlg *dlg, t_id id);
116 bool SetDlgItemSize(t_dlg *dlg, t_id id, int w, int h);
118 bool SetDlgItemPos(t_dlg *dlg, t_id id, int x0, int y0);
120 void SetDlgSize(t_dlg *dlg, int w, int h, bool bAutoPosition);
122 /*****************************
124 * Routines to extract information from the dlg proc
125 * after dlg is exec'ed
127 ****************************/
128 bool IsCBChecked(t_dlg *dlg, t_id id);
130 t_id RBSelected(t_dlg *dlg, int gid);
132 int EditTextLen(t_dlg *dlg, t_id id);
134 char *EditText(t_dlg *dlg, t_id id);
136 /*****************************
138 * Routines to do internal things
140 ****************************/
141 t_dlgitem *FindWin(t_dlg *dlg, Window win);
143 t_dlgitem *FindItem(t_dlg *dlg, t_id id);
145 void HelpDlg(t_dlg *dlg);
147 void HelpNow(t_dlg *dlg, t_dlgitem *dlgitem);
149 void NoHelp(t_dlg *dlg);
151 /*****************************
153 * Exececute the dialog box procedure
154 * Returns when a button is pushed.
155 * return value is the ID of the button
157 ****************************/
158 void ShowDlg(t_dlg *dlg);
160 void HideDlg(t_dlg *dlg);
162 void FreeDlgItem(t_dlg *dlg, t_id id);
164 void FreeDlg(t_dlg *dlg);