source: trunk/include/helpers/dialog.h@ 166

Last change on this file since 166 was 166, checked in by umoeller, 23 years ago

Bunch of fixes.
  • Property svn:eol-style set to CRLF
  • Property svn:keywords set to Author Date Id Revision
File size: 24.6 KB
Line 
1
2/*
3 *@@sourcefile dialog.h:
4 * header file for dialog.c. See remarks there.
5 *
6 * Note: Version numbering in this file relates to XWorkplace version
7 * numbering.
8 *
9 *@@added V0.9.9 (2001-04-01) [umoeller]
10 *@@include <os2.h>
11 *@@include #include "helpers\linklist.h" // for mnemonic helpers
12 *@@include #include "helpers\dialog.h"
13 */
14
15/* Copyright (C) 2001 Ulrich M”ller.
16 * This file is part of the "XWorkplace helpers" source package.
17 * This is free software; you can redistribute it and/or modify
18 * it under the terms of the GNU General Public License as published
19 * by the Free Software Foundation, in version 2 as it comes in the
20 * "COPYING" file of the XWorkplace main distribution.
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
25 */
26
27#if __cplusplus
28extern "C" {
29#endif
30
31#ifndef DIALOG_HEADER_INCLUDED
32 #define DIALOG_HEADER_INCLUDED
33
34 #ifndef NULL_POINT
35 #define NULL_POINT {0, 0}
36 #endif
37
38 /* ******************************************************************
39 *
40 * Error codes
41 *
42 ********************************************************************/
43
44 #define ERROR_DLG_FIRST 43000
45
46 #define DLGERR_ROW_BEFORE_TABLE (ERROR_DLG_FIRST)
47 #define DLGERR_CONTROL_BEFORE_ROW (ERROR_DLG_FIRST + 1)
48 #define DLGERR_NULL_CTL_DEF (ERROR_DLG_FIRST + 2)
49 #define DLGERR_CANNOT_CREATE_FRAME (ERROR_DLG_FIRST + 3)
50 #define DLGERR_INVALID_CODE (ERROR_DLG_FIRST + 4)
51 #define DLGERR_TABLE_NOT_CLOSED (ERROR_DLG_FIRST + 5)
52 #define DLGERR_TOO_MANY_TABLES_CLOSED (ERROR_DLG_FIRST + 6)
53 #define DLGERR_CANNOT_CREATE_CONTROL (ERROR_DLG_FIRST + 7)
54 #define DLGERR_ARRAY_TOO_SMALL (ERROR_DLG_FIRST + 8)
55 #define DLGERR_INVALID_CONTROL_TITLE (ERROR_DLG_FIRST + 9)
56 #define DLGERR_INVALID_STATIC_BITMAP (ERROR_DLG_FIRST + 10)
57
58 #define ERROR_DLG_LAST (ERROR_DLG_FIRST + 10)
59
60 /* ******************************************************************
61 *
62 * Structures
63 *
64 ********************************************************************/
65
66 #define SZL_AUTOSIZE (-1)
67
68 #define CTL_COMMON_FONT ((PCSZ)-1)
69
70 #define ROW_VALIGN_MASK 0x0003
71 #define ROW_VALIGN_BOTTOM 0x0000
72 #define ROW_VALIGN_CENTER 0x0001
73 #define ROW_VALIGN_TOP 0x0002
74
75 /*
76 *@@ CONTROLDEF:
77 * defines a single control. Used
78 * with the TYPE_CONTROL_DEF type in
79 * DLGHITEM.
80 *
81 *@@changed V0.9.12 (2001-05-31) [umoeller]: added control data
82 */
83
84 typedef struct _CONTROLDEF
85 {
86 const char *pcszClass; // registered PM window class
87 const char *pcszText;
88 // window text (class-specific)
89 // special hacks:
90 // -- For WS_STATIC with SS_BITMAP or SS_ICON set,
91 // you may specify the exact HPOINTER here.
92 // The dlg routine will then subclass the static
93 //
94
95 ULONG flStyle; // standard window styles
96
97 USHORT usID; // dlg item ID
98
99 const char *pcszFont; // font presparam, or NULL for no presparam,
100 // or CTL_COMMON_FONT for standard dialog
101 // font specified on input to dlghCreateDlg
102
103 USHORT usAdjustPosition;
104 // flags for winhAdjustControls; any combination of
105 // XAC_MOVEX, XAC_MOVEY, XAC_SIZEX, XAC_SIZEY
106 // @@todo not implemented yet
107
108 SIZEL szlDlgUnits;
109 // proposed size for the control. Note that starting
110 // with V0.9.19, these are now dialog units to
111 // finally fix the bad alignment problems with
112 // lower resolutions. The dialog formatter applies
113 // an internal factor to these things based on
114 // what WinMapDlgPoints gives us.
115 // A number of special flags are available per
116 // cx and cy field:
117 // -- SZL_AUTOSIZE (-1): determine size automatically.
118 // Works only for statics with SS_TEXT and
119 // SS_BITMAP.
120 // -- Any other _negative_ value is considered a
121 // percentage of the largest row width in the
122 // table. For example, -50 would mean 50% of
123 // the largest row in the table. This is valid
124 // for the CX field only.
125 // If the CONTROLDEF appears with a START_NEW_TABLE
126 // type in _DLGHITEM (to specify a group table)
127 // and they are not SZL_AUTOSIZE, they specify the
128 // size of the inner table of the group (to override
129 // the automatic formatting). Note that the dialog
130 // adds extra spacing to this size:
131 // -- the group control's cx will be
132 // szlControlProposed.cx
133 // + 2 * ulSpacing
134 // + 2 * GROUP_INNER_SPACING_X
135 // -- the group control's cy will be
136 // szlControlProposed.cy
137 // + 2 * ulSpacing
138 // + GROUP_INNER_SPACING_Y
139 // + GROUP_INNER_SPACING_TOP
140
141 ULONG duSpacing;
142 // spacing around control; this is now in dialog
143 // units too V0.9.19 (2002-04-24) [umoeller]
144
145 PVOID pvCtlData; // for WinCreateWindow
146
147 } CONTROLDEF, *PCONTROLDEF;
148
149 typedef const struct _CONTROLDEF *PCCONTROLDEF;
150
151 /*
152 *@@ DLGHITEMTYPE:
153 *
154 */
155
156 typedef enum _DLGHITEMTYPE
157 {
158 TYPE_START_NEW_TABLE, // beginning of a new table; may nest
159 TYPE_START_NEW_ROW, // beginning of a new row in a table
160 TYPE_CONTROL_DEF, // control definition
161 TYPE_END_TABLE // end of a table
162 } DLGHITEMTYPE;
163
164 // a few handy macros for defining templates
165
166 #define START_TABLE { TYPE_START_NEW_TABLE, 0 }
167
168 // this macro is slightly insane, but performs type checking
169 // in case the user gives a pointer which is not of CONTROLDEF
170 #define START_GROUP_TABLE(pDef) { TYPE_START_NEW_TABLE, \
171 ( (ULONG)(&(pDef)->pcszClass) ) }
172
173 #define END_TABLE { TYPE_END_TABLE, 0 }
174
175 #define START_ROW(fl) { TYPE_START_NEW_ROW, fl }
176
177 #define CONTROL_DEF(pDef) { TYPE_CONTROL_DEF, \
178 ( (ULONG)(&(pDef)->pcszClass) ) }
179
180 /*
181 *@@ DLGHITEM:
182 * dialog format array item.
183 *
184 * An array of these must be passed to dlghCreateDlg
185 * to tell it what controls the dialog contains.
186 * See dlghCreateDlg for details.
187 *
188 */
189
190 typedef struct _DLGHITEM
191 {
192 DLGHITEMTYPE Type;
193 // one of:
194 // TYPE_START_NEW_TABLE, // beginning of a new table
195 // TYPE_START_NEW_ROW, // beginning of a new row in a table
196 // TYPE_CONTROL_DEF // control definition
197 // TYPE_END_TABLE // end of table
198
199 ULONG ulData;
200 // -- with TYPE_START_NEW_TABLE: if NULL, this starts
201 // an invisible table (for formatting only).
202 // Otherwise a _CONTROLDEF pointer to specify
203 // a control to be produced around the table.
204 // For example, you can specify a WC_STATIC
205 // with SS_GROUPBOX to create a group around
206 // the table.
207 // -- with TYPE_START_NEW_ROW: ROW_* formatting flags.
208 // -- with TYPE_CONTROL_DEF: _CONTROLDEF pointer to a control definition
209 } DLGHITEM, *PDLGHITEM;
210
211 typedef const struct _DLGHITEM *PCDLGHITEM;
212
213 /* ******************************************************************
214 *
215 * Macros
216 *
217 ********************************************************************/
218
219 #define LOAD_STRING ((PCSZ)-1)
220
221 // if the following is defined, we ignore the Y factor
222 // when scaling dialog units to pixels but use the X
223 // factor twice. This will result in something specified
224 // to be 10x10 units to be square, but will result in
225 // problems because dialog units are based on the
226 // system default fonts and x is different from y then.
227 // #define USE_SQUARE_CORRELATION
228
229 // if you still want something to be vaguely square,
230 // try the following macro to calculate the CY from a CX
231 #ifdef USE_SQUARE_CORRELATION
232 #define MAKE_SQUARE_CY(cx) (cx)
233 #else
234 #define MAKE_SQUARE_CY(cx) (cx * 200 / 250)
235 #endif
236
237 #define DLG_OUTER_SPACING_X 4
238 // outer spacing applied around entire dialog;
239 // we now use 4 to match the spacing in Warp 4
240 // notebook pages V0.9.19 (2002-04-24) [umoeller]
241 #define DLG_OUTER_SPACING_Y 3
242
243 #define COMMON_SPACING 1
244
245 #define GROUP_INNER_SPACING_X 3
246 #define GROUP_OUTER_SPACING_BOTTOM 1
247 #define GROUP_INNER_SPACING_BOTTOM 3
248 #define GROUP_INNER_SPACING_TOP 8
249 #define GROUP_OUTER_SPACING_TOP 0
250
251 #define STD_BUTTON_WIDTH 50
252
253 #ifdef USE_SQUARE_CORRELATION
254 #define STD_BUTTON_HEIGHT 15
255 #define STD_SPIN_HEIGHT 10
256 #else
257 #define STD_BUTTON_HEIGHT 12
258 #define STD_SPIN_HEIGHT 8
259 #endif
260
261 #define DEFAULT_TABLE_WIDTH 150
262
263 // the following require INCL_WINSTATICS
264
265 #define CONTROLDEF_GROUP(pcsz, id, cx, cy) { WC_STATIC, pcsz, \
266 WS_VISIBLE | SS_GROUPBOX | DT_MNEMONIC, \
267 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
268
269 #define LOADDEF_GROUP(id, cx) CONTROLDEF_GROUP(LOAD_STRING, id, cx, SZL_AUTOSIZE)
270
271 #define CONTROLDEF_TEXT(pcsz, id, cx, cy) { WC_STATIC, pcsz, \
272 WS_VISIBLE | SS_TEXT | DT_LEFT | DT_VCENTER | DT_MNEMONIC, \
273 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
274
275 #define LOADDEF_TEXT(id) CONTROLDEF_TEXT(LOAD_STRING, id, SZL_AUTOSIZE, SZL_AUTOSIZE)
276
277 #define CONTROLDEF_TEXT_CENTER(pcsz, id, cx, cy) { WC_STATIC, pcsz, \
278 WS_VISIBLE | SS_TEXT | DT_CENTER | DT_VCENTER | DT_MNEMONIC, \
279 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
280
281 #define CONTROLDEF_TEXT_RIGHT(pcsz, id, cx, cy) { WC_STATIC, pcsz, \
282 WS_VISIBLE | SS_TEXT | DT_RIGHT | DT_VCENTER | DT_MNEMONIC, \
283 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
284
285 #define LOADDEF_TEXT_RIGHT(id) CONTROLDEF_TEXT_RIGHT(LOAD_STRING, id, SZL_AUTOSIZE, SZL_AUTOSIZE)
286
287 #define CONTROLDEF_TEXT_WORDBREAK(pcsz, id, cx) { WC_STATIC, pcsz, \
288 WS_VISIBLE | SS_TEXT | DT_LEFT | DT_TOP | DT_WORDBREAK, \
289 id, CTL_COMMON_FONT, 0, {cx, SZL_AUTOSIZE}, COMMON_SPACING }
290
291 #define LOADDEF_TEXT_WORDBREAK(id, cx) CONTROLDEF_TEXT_WORDBREAK(LOAD_STRING, id, cx)
292
293 #define CONTROLDEF_TEXT_WORDBREAK_MNEMONIC(pcsz, id, cx) { WC_STATIC, pcsz, \
294 WS_VISIBLE | SS_TEXT | DT_LEFT | DT_TOP | DT_WORDBREAK | DT_MNEMONIC, \
295 id, CTL_COMMON_FONT, 0, {cx, SZL_AUTOSIZE}, COMMON_SPACING }
296
297 #define LOADDEF_TEXT_WORDBREAK_MNEMONIC(id, cx) CONTROLDEF_TEXT_WORDBREAK_MNEMONIC(LOAD_STRING, id, cx)
298
299 #define CONTROLDEF_ICON(hptr, id) { WC_STATIC, (PCSZ)(hptr), \
300 WS_VISIBLE | SS_ICON | DT_LEFT | DT_VCENTER, \
301 id, CTL_COMMON_FONT, 0, {SZL_AUTOSIZE, SZL_AUTOSIZE}, COMMON_SPACING }
302
303 #define CONTROLDEF_BITMAP(hbm, id) { WC_STATIC, (PCSZ)(hbm), \
304 WS_VISIBLE | SS_BITMAP | DT_LEFT | DT_VCENTER, \
305 id, CTL_COMMON_FONT, 0, {SZL_AUTOSIZE, SZL_AUTOSIZE}, COMMON_SPACING }
306
307 // the following require INCL_WINBUTTONS
308
309 #define CONTROLDEF_DEFPUSHBUTTON(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
310 WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON | BS_DEFAULT, \
311 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
312
313 #define LOADDEF_DEFPUSHBUTTON(id) CONTROLDEF_DEFPUSHBUTTON(LOAD_STRING, id, STD_BUTTON_WIDTH, STD_BUTTON_HEIGHT)
314
315 #define CONTROLDEF_PUSHBUTTON(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
316 WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON, \
317 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
318
319 #define LOADDEF_PUSHBUTTON(id) CONTROLDEF_PUSHBUTTON(LOAD_STRING, id, STD_BUTTON_WIDTH, STD_BUTTON_HEIGHT)
320
321 #define CONTROLDEF_DEFNOFOCUSBUTTON(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
322 WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON | BS_DEFAULT | BS_NOPOINTERFOCUS, \
323 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
324
325 #define CONTROLDEF_NOFOCUSBUTTON(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
326 WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON | BS_NOPOINTERFOCUS, \
327 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
328
329 #define LOADDEF_NOFOCUSBUTTON(id) CONTROLDEF_NOFOCUSBUTTON(LOAD_STRING, id, STD_BUTTON_WIDTH, STD_BUTTON_HEIGHT)
330
331 #define CONTROLDEF_HELPPUSHBUTTON(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
332 WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON | BS_HELP | BS_NOPOINTERFOCUS, \
333 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
334
335 #define LOADDEF_HELPPUSHBUTTON(id) CONTROLDEF_HELPPUSHBUTTON(LOAD_STRING, id, STD_BUTTON_WIDTH, STD_BUTTON_HEIGHT)
336
337 #define CONTROLDEF_AUTOCHECKBOX(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
338 WS_VISIBLE | WS_TABSTOP | BS_AUTOCHECKBOX, \
339 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
340
341 #define LOADDEF_AUTOCHECKBOX(id) CONTROLDEF_AUTOCHECKBOX(LOAD_STRING, id, SZL_AUTOSIZE, SZL_AUTOSIZE)
342
343 #define CONTROLDEF_FIRST_AUTORADIO(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
344 WS_VISIBLE | WS_TABSTOP | BS_AUTORADIOBUTTON | WS_GROUP, \
345 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
346
347 #define LOADDEF_FIRST_AUTORADIO(id) CONTROLDEF_FIRST_AUTORADIO(LOAD_STRING, id, SZL_AUTOSIZE, SZL_AUTOSIZE)
348
349 #define CONTROLDEF_NEXT_AUTORADIO(pcsz, id, cx, cy) { WC_BUTTON, pcsz, \
350 WS_VISIBLE | WS_TABSTOP | BS_AUTORADIOBUTTON, \
351 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
352
353 #define LOADDEF_NEXT_AUTORADIO(id) CONTROLDEF_NEXT_AUTORADIO(LOAD_STRING, id, SZL_AUTOSIZE, SZL_AUTOSIZE)
354
355 // the following require INCL_WINENTRYFIELDS
356
357 #define CONTROLDEF_ENTRYFIELD(pcsz, id, cx, cy) { WC_ENTRYFIELD, pcsz, \
358 WS_VISIBLE | WS_TABSTOP | ES_MARGIN | ES_AUTOSCROLL, \
359 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
360
361 #define CONTROLDEF_ENTRYFIELD_RO(pcsz, id, cx, cy) { WC_ENTRYFIELD, pcsz, \
362 WS_VISIBLE | WS_TABSTOP | ES_MARGIN | ES_READONLY | ES_AUTOSCROLL, \
363 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
364
365 // the following require INCL_WINMLE
366
367 #define CONTROLDEF_MLE(pcsz, id, cx, cy) { WC_MLE, pcsz, \
368 WS_VISIBLE | WS_TABSTOP | MLS_BORDER | MLS_IGNORETAB | MLS_WORDWRAP, \
369 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
370
371 // the following require INCL_WINLISTBOXES
372
373 #define CONTROLDEF_LISTBOX(id, cx, cy) { WC_LISTBOX, NULL, \
374 WS_VISIBLE | WS_TABSTOP | LS_HORZSCROLL | LS_NOADJUSTPOS, \
375 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
376
377 // the following require INCL_WINLISTBOXES and INCL_WINENTRYFIELDS
378
379 #define CONTROLDEF_DROPDOWN(id, cx, cy) { WC_COMBOBOX, NULL, \
380 WS_VISIBLE | WS_TABSTOP | LS_HORZSCROLL | CBS_DROPDOWN, \
381 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
382
383 #define CONTROLDEF_DROPDOWNLIST(id, cx, cy) { WC_COMBOBOX, NULL, \
384 WS_VISIBLE | WS_TABSTOP | LS_HORZSCROLL | CBS_DROPDOWNLIST, \
385 id, CTL_COMMON_FONT, 0, { cx, cy }, COMMON_SPACING }
386
387 // the following require INCL_WINSTDSPIN
388
389 #define CONTROLDEF_SPINBUTTON(id, cx, cy) { WC_SPINBUTTON, NULL, \
390 WS_VISIBLE | WS_TABSTOP | SPBS_MASTER | SPBS_NUMERICONLY | SPBS_JUSTCENTER | SPBS_FASTSPIN, \
391 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
392
393 // the following require INCL_WINSTDCNR
394
395 #define CONTROLDEF_CONTAINER(id, cx, cy) { WC_CONTAINER, NULL, \
396 WS_VISIBLE | WS_TABSTOP | 0, \
397 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING }
398
399 // the following require INCL_WINSTDSLIDER
400
401 #define CONTROLDEF_SLIDER(id, cx, cy, pctldata) { WC_SLIDER, NULL, \
402 WS_VISIBLE | WS_TABSTOP | WS_GROUP | SLS_HORIZONTAL | SLS_PRIMARYSCALE1 \
403 | SLS_BUTTONSRIGHT | SLS_SNAPTOINCREMENT, \
404 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING, pctldata }
405
406 #define CONTROLDEF_VSLIDER(id, cx, cy, pctldata) { WC_SLIDER, NULL, \
407 WS_VISIBLE | WS_TABSTOP | WS_GROUP | SLS_VERTICAL | SLS_PRIMARYSCALE1 \
408 | SLS_BUTTONSRIGHT | SLS_SNAPTOINCREMENT, \
409 id, CTL_COMMON_FONT, 0, {cx, cy}, COMMON_SPACING, pctldata }
410
411 /* ******************************************************************
412 *
413 * Dialog formatter entry points
414 *
415 ********************************************************************/
416
417 #ifndef FCF_CLOSEBUTTON
418 #define FCF_CLOSEBUTTON 0x04000000L // toolkit 4 only
419 #endif
420
421 #define FCF_FIXED_DLG FCF_TITLEBAR | FCF_SYSMENU | FCF_DLGBORDER | FCF_NOBYTEALIGN | FCF_CLOSEBUTTON
422 #define FCF_SIZEABLE_DLG FCF_TITLEBAR | FCF_SYSMENU | FCF_SIZEBORDER | FCF_NOBYTEALIGN | FCF_CLOSEBUTTON
423
424 APIRET XWPENTRY dlghCreateDlg(HWND *phwndDlg,
425 HWND hwndOwner,
426 ULONG flCreateFlags,
427 PFNWP pfnwpDialogProc,
428 PCSZ pcszDlgTitle,
429 PCDLGHITEM paDlgItems,
430 ULONG cDlgItems,
431 PVOID pCreateParams,
432 PCSZ pcszControlsFont);
433 typedef APIRET XWPENTRY DLGHCREATEDLG(HWND *phwndDlg,
434 HWND hwndOwner,
435 ULONG flCreateFlags,
436 PFNWP pfnwpDialogProc,
437 PCSZ pcszDlgTitle,
438 PCDLGHITEM paDlgItems,
439 ULONG cDlgItems,
440 PVOID pCreateParams,
441 PCSZ pcszControlsFont);
442 typedef DLGHCREATEDLG *PDLGHCREATEDLG;
443
444 #define DFFL_CREATECONTROLS 0x0002
445
446 APIRET dlghFormatDlg(HWND hwndDlg,
447 PCDLGHITEM paDlgItems,
448 ULONG cDlgItems,
449 PCSZ pcszControlsFont,
450 ULONG flFlags,
451 PSIZEL pszlClient,
452 PVOID *ppllControls);
453
454 VOID dlghResizeFrame(HWND hwndDlg,
455 PSIZEL pszlClient);
456
457 /* ******************************************************************
458 *
459 * Dialog arrays
460 *
461 ********************************************************************/
462
463 /*
464 *@@ DLGARRAY:
465 * dialog array structure used with dlghCreateArray.
466 * See remarks there.
467 *
468 *@@added V0.9.16 (2001-10-15) [umoeller]
469 */
470
471 typedef struct _DLGARRAY
472 {
473 DLGHITEM *paDlgItems; // array of DLGHITEM's, allocated once
474 // by dlghCreateArray
475 ULONG cDlgItemsMax, // copied from dlghCreateArray
476 cDlgItemsNow; // initially 0, raised after each
477 // dlghAppendToArray; pass this to the
478 // dialog formatter
479 } DLGARRAY, *PDLGARRAY;
480
481 APIRET dlghCreateArray(ULONG cMaxItems,
482 PDLGARRAY *ppArray);
483
484 APIRET dlghFreeArray(PDLGARRAY *ppArray);
485
486 APIRET dlghAppendToArray(PDLGARRAY pArray,
487 PCDLGHITEM paItems,
488 ULONG cItems);
489
490 /* ******************************************************************
491 *
492 * Standard dialogs
493 *
494 ********************************************************************/
495
496 /*
497 *@@ MSGBOXSTRINGS:
498 *
499 *@@added V0.9.13 (2001-06-21) [umoeller]
500 */
501
502 typedef struct _MSGBOXSTRINGS
503 {
504 const char *pcszYes, // "~Yes"
505 *pcszNo, // "~No"
506 *pcszOK, // "~OK"
507 *pcszCancel, // "~Cancel"
508 *pcszAbort, // "~Abort"
509 *pcszRetry, // "~Retry"
510 *pcszIgnore, // "~Ignore"
511 *pcszEnter, // "~Help"
512 *pcszYesToAll, // "Yes to ~all"
513 *pcszHelp; // "~Help"
514 } MSGBOXSTRINGS, *PMSGBOXSTRINGS;
515
516 /* the following are in os2.h somewhere:
517 #define MB_OK 0x0000
518 #define MB_OKCANCEL 0x0001
519 #define MB_RETRYCANCEL 0x0002
520 #define MB_ABORTRETRYIGNORE 0x0003
521 #define MB_YESNO 0x0004
522 #define MB_YESNOCANCEL 0x0005
523 #define MB_CANCEL 0x0006
524 #define MB_ENTER 0x0007
525 #define MB_ENTERCANCEL 0x0008 */
526 // we add:
527 #define MB_YES_YES2ALL_NO 0x0009
528
529 /* the following are in os2.h somewhere:
530 #define MBID_OK 1
531 #define MBID_CANCEL 2
532 #define MBID_ABORT 3
533 #define MBID_RETRY 4
534 #define MBID_IGNORE 5
535 #define MBID_YES 6
536 #define MBID_NO 7
537 #define MBID_HELP 8
538 #define MBID_ENTER 9 */
539 // we add:
540 #define MBID_YES2ALL 10
541
542 typedef VOID APIENTRY FNHELP(HWND hwndDlg);
543 typedef FNHELP *PFNHELP;
544
545 APIRET dlghCreateMessageBox(HWND *phwndDlg,
546 HWND hwndOwner,
547 HPOINTER hptrIcon,
548 PCSZ pcszTitle,
549 PCSZ pcszMessage,
550 PFNHELP pfnHelp,
551 ULONG flFlags,
552 PCSZ pcszFont,
553 const MSGBOXSTRINGS *pStrings,
554 PULONG pulAlarmFlag);
555
556 ULONG dlghMessageBox(HWND hwndOwner,
557 HPOINTER hptrIcon,
558 PCSZ pcszTitle,
559 PCSZ pcszMessage,
560 PFNHELP pfnHelp,
561 ULONG flFlags,
562 PCSZ pcszFont,
563 const MSGBOXSTRINGS *pStrings);
564
565 #define TEBF_REMOVETILDE 0x0001
566 #define TEBF_REMOVEELLIPSE 0x0002
567 #define TEBF_SELECTALL 0x0004
568
569 PSZ dlghTextEntryBox(HWND hwndOwner,
570 PCSZ pcszTitle,
571 PCSZ pcszDescription,
572 PCSZ pcszDefault,
573 PCSZ pcszOK,
574 PCSZ pcszCancel,
575 ULONG ulMaxLen,
576 ULONG fl,
577 PCSZ pcszFont);
578
579 /* ******************************************************************
580 *
581 * Dialog input handlers
582 *
583 ********************************************************************/
584
585 VOID dlghSetPrevFocus(PVOID pvllWindows);
586
587 VOID dlghSetNextFocus(PVOID pvllWindows);
588
589 HWND dlghProcessMnemonic(PVOID pvllWindows,
590 USHORT usch);
591
592 BOOL dlghEnter(PVOID pvllWindows);
593
594#endif
595
596#if __cplusplus
597}
598#endif
599
Note: See TracBrowser for help on using the repository browser.