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 gmx_bool bPop
; /* Should we pop the mouse back */
69 gmx_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
, unsigned long fg
, unsigned long bg
,
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 gmx_bool
QueryDlgItemSize(t_dlg
*dlg
, t_id id
, int *w
, int *h
);
106 gmx_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 gmx_bool
SetDlgItemSize(t_dlg
*dlg
, t_id id
, int w
, int h
);
118 gmx_bool
SetDlgItemPos(t_dlg
*dlg
, t_id id
, int x0
, int y0
);
120 void SetDlgSize(t_dlg
*dlg
, int w
, int h
, gmx_bool bAutoPosition
);
122 /*****************************
124 * Routines to extract information from the dlg proc
125 * after dlg is exec'ed
127 ****************************/
128 gmx_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
);