windows/winctrls.c

   1 /*
   2  * winctrls.c: routines to self-manage the controls in a dialog
   3  * box.
   4  */
   5
   6 /*
   7  * Possible TODO in new cross-platform config box stuff:
   8  *
   9  *  - When lining up two controls alongside each other, I wonder if
  10  *    we could conveniently arrange to centre them vertically?
  11  *    Particularly ugly in the current setup is the `Add new
  12  *    forwarded port:' static next to the rather taller `Remove'
  13  *    button.
  14  */
  15
  16 #include <assert.h>
  17 #include <ctype.h>
  18
  19 #include "putty.h"
  20 #include "misc.h"
  21 #include "dialog.h"
  22
  23 #include <commctrl.h>
  24
  25 #define GAPBETWEEN 3
  26 #define GAPWITHIN 1
  27 #define GAPXBOX 7
  28 #define GAPYBOX 4
  29 #define DLGWIDTH 168
  30 #define STATICHEIGHT 8
  31 #define TITLEHEIGHT 12
  32 #define CHECKBOXHEIGHT 8
  33 #define RADIOHEIGHT 8
  34 #define EDITHEIGHT 12
  35 #define LISTHEIGHT 11
  36 #define LISTINCREMENT 8
  37 #define COMBOHEIGHT 12
  38 #define PUSHBTNHEIGHT 14
  39 #define PROGBARHEIGHT 14
  40
  41 void ctlposinit(struct ctlpos *cp, HWND hwnd,
  42                 int leftborder, int rightborder, int topborder)
  43 {
  44     RECT r, r2;
  45     cp->hwnd = hwnd;
  46     cp->font = SendMessage(hwnd, WM_GETFONT, 0, 0);
  47     cp->ypos = topborder;
  48     GetClientRect(hwnd, &r);
  49     r2.left = r2.top = 0;
  50     r2.right = 4;
  51     r2.bottom = 8;
  52     MapDialogRect(hwnd, &r2);
  53     cp->dlu4inpix = r2.right;
  54     cp->width = (r.right * 4) / (r2.right) - 2 * GAPBETWEEN;
  55     cp->xoff = leftborder;
  56     cp->width -= leftborder + rightborder;
  57 }
  58
  59 HWND doctl(struct ctlpos *cp, RECT r,
  60            char *wclass, int wstyle, int exstyle, char *wtext, int wid)
  61 {
  62     HWND ctl;
  63     /*
  64      * Note nonstandard use of RECT. This is deliberate: by
  65      * transforming the width and height directly we arrange to
  66      * have all supposedly same-sized controls really same-sized.
  67      */
  68
  69     r.left += cp->xoff;
  70     MapDialogRect(cp->hwnd, &r);
  71
  72     /*
  73      * We can pass in cp->hwnd == NULL, to indicate a dry run
  74      * without creating any actual controls.
  75      */
  76     if (cp->hwnd) {
  77         ctl = CreateWindowEx(exstyle, wclass, wtext, wstyle,
  78                              r.left, r.top, r.right, r.bottom,
  79                              cp->hwnd, (HMENU) wid, hinst, NULL);
  80         SendMessage(ctl, WM_SETFONT, cp->font, MAKELPARAM(TRUE, 0));
  81
  82         if (!strcmp(wclass, "LISTBOX")) {
  83             /*
  84              * Bizarre Windows bug: the list box calculates its
  85              * number of lines based on the font it has at creation
  86              * time, but sending it WM_SETFONT doesn't cause it to
  87              * recalculate. So now, _after_ we've sent it
  88              * WM_SETFONT, we explicitly resize it (to the same
  89              * size it was already!) to force it to reconsider.
  90              */
  91             SetWindowPos(ctl, NULL, 0, 0, r.right, r.bottom,
  92                          SWP_NOACTIVATE | SWP_NOCOPYBITS |
  93                          SWP_NOMOVE | SWP_NOZORDER);
  94         }
  95     } else
  96         ctl = NULL;
  97     return ctl;
  98 }
  99
 100 /*
 101  * A title bar across the top of a sub-dialog.
 102  */
 103 void bartitle(struct ctlpos *cp, char *name, int id)
 104 {
 105     RECT r;
 106
 107     r.left = GAPBETWEEN;
 108     r.right = cp->width;
 109     r.top = cp->ypos;
 110     r.bottom = STATICHEIGHT;
 111     cp->ypos += r.bottom + GAPBETWEEN;
 112     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, name, id);
 113 }
 114
 115 /*
 116  * Begin a grouping box, with or without a group title.
 117  */
 118 void beginbox(struct ctlpos *cp, char *name, int idbox)
 119 {
 120     cp->boxystart = cp->ypos;
 121     if (!name)
 122         cp->boxystart -= STATICHEIGHT / 2;
 123     if (name)
 124         cp->ypos += STATICHEIGHT;
 125     cp->ypos += GAPYBOX;
 126     cp->width -= 2 * GAPXBOX;
 127     cp->xoff += GAPXBOX;
 128     cp->boxid = idbox;
 129     cp->boxtext = name;
 130 }
 131
 132 /*
 133  * End a grouping box.
 134  */
 135 void endbox(struct ctlpos *cp)
 136 {
 137     RECT r;
 138     cp->xoff -= GAPXBOX;
 139     cp->width += 2 * GAPXBOX;
 140     cp->ypos += GAPYBOX - GAPBETWEEN;
 141     r.left = GAPBETWEEN;
 142     r.right = cp->width;
 143     r.top = cp->boxystart;
 144     r.bottom = cp->ypos - cp->boxystart;
 145     doctl(cp, r, "BUTTON", BS_GROUPBOX | WS_CHILD | WS_VISIBLE, 0,
 146           cp->boxtext ? cp->boxtext : "", cp->boxid);
 147     cp->ypos += GAPYBOX;
 148 }
 149
 150 /*
 151  * A static line, followed by a full-width edit box.
 152  */
 153 void editboxfw(struct ctlpos *cp, int password, char *text,
 154                int staticid, int editid)
 155 {
 156     RECT r;
 157
 158     r.left = GAPBETWEEN;
 159     r.right = cp->width;
 160
 161     if (text) {
 162         r.top = cp->ypos;
 163         r.bottom = STATICHEIGHT;
 164         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, text, staticid);
 165         cp->ypos += STATICHEIGHT + GAPWITHIN;
 166     }
 167     r.top = cp->ypos;
 168     r.bottom = EDITHEIGHT;
 169     doctl(cp, r, "EDIT",
 170           WS_CHILD | WS_VISIBLE | WS_TABSTOP | ES_AUTOHSCROLL |
 171           (password ? ES_PASSWORD : 0),
 172           WS_EX_CLIENTEDGE, "", editid);
 173     cp->ypos += EDITHEIGHT + GAPBETWEEN;
 174 }
 175
 176 /*
 177  * A static line, followed by a full-width combo box.
 178  */
 179 void combobox(struct ctlpos *cp, char *text, int staticid, int listid)
 180 {
 181     RECT r;
 182
 183     r.left = GAPBETWEEN;
 184     r.right = cp->width;
 185
 186     if (text) {
 187         r.top = cp->ypos;
 188         r.bottom = STATICHEIGHT;
 189         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, text, staticid);
 190         cp->ypos += STATICHEIGHT + GAPWITHIN;
 191     }
 192     r.top = cp->ypos;
 193     r.bottom = COMBOHEIGHT * 10;
 194     doctl(cp, r, "COMBOBOX",
 195           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL |
 196           CBS_DROPDOWN | CBS_HASSTRINGS, WS_EX_CLIENTEDGE, "", listid);
 197     cp->ypos += COMBOHEIGHT + GAPBETWEEN;
 198 }
 199
 200 struct radio { char *text; int id; };
 201
 202 static void radioline_common(struct ctlpos *cp, char *text, int id,
 203                              int nacross, struct radio *buttons, int nbuttons)
 204 {
 205     RECT r;
 206     int group;
 207     int i;
 208     int j;
 209
 210     if (text) {
 211         r.left = GAPBETWEEN;
 212         r.top = cp->ypos;
 213         r.right = cp->width;
 214         r.bottom = STATICHEIGHT;
 215         cp->ypos += r.bottom + GAPWITHIN;
 216         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, text, id);
 217     }
 218
 219     group = WS_GROUP;
 220     i = 0;
 221     for (j = 0; j < nbuttons; j++) {
 222         char *btext = buttons[j].text;
 223         int bid = buttons[j].id;
 224
 225         if (i == nacross) {
 226             cp->ypos += r.bottom + (nacross > 1 ? GAPBETWEEN : GAPWITHIN);
 227             i = 0;
 228         }
 229         r.left = GAPBETWEEN + i * (cp->width + GAPBETWEEN) / nacross;
 230         if (j < nbuttons-1)
 231             r.right =
 232                 (i + 1) * (cp->width + GAPBETWEEN) / nacross - r.left;
 233         else
 234             r.right = cp->width - r.left;
 235         r.top = cp->ypos;
 236         r.bottom = RADIOHEIGHT;
 237         doctl(cp, r, "BUTTON",
 238               BS_NOTIFY | BS_AUTORADIOBUTTON | WS_CHILD |
 239               WS_VISIBLE | WS_TABSTOP | group, 0, btext, bid);
 240         group = 0;
 241         i++;
 242     }
 243     cp->ypos += r.bottom + GAPBETWEEN;
 244 }
 245
 246 /*
 247  * A set of radio buttons on the same line, with a static above
 248  * them. `nacross' dictates how many parts the line is divided into
 249  * (you might want this not to equal the number of buttons if you
 250  * needed to line up some 2s and some 3s to look good in the same
 251  * panel).
 252  *
 253  * There's a bit of a hack in here to ensure that if nacross
 254  * exceeds the actual number of buttons, the rightmost button
 255  * really does get all the space right to the edge of the line, so
 256  * you can do things like
 257  *
 258  * (*) Button1  (*) Button2  (*) ButtonWithReallyLongTitle
 259  */
 260 void radioline(struct ctlpos *cp, char *text, int id, int nacross, ...)
 261 {
 262     va_list ap;
 263     struct radio *buttons;
 264     int i, nbuttons;
 265
 266     va_start(ap, nacross);
 267     nbuttons = 0;
 268     while (1) {
 269         char *btext = va_arg(ap, char *);
 270         int bid;
 271         if (!btext)
 272             break;
 273         bid = va_arg(ap, int);
 274         nbuttons++;
 275     }
 276     va_end(ap);
 277     buttons = snewn(nbuttons, struct radio);
 278     va_start(ap, nacross);
 279     for (i = 0; i < nbuttons; i++) {
 280         buttons[i].text = va_arg(ap, char *);
 281         buttons[i].id = va_arg(ap, int);
 282     }
 283     va_end(ap);
 284     radioline_common(cp, text, id, nacross, buttons, nbuttons);
 285     sfree(buttons);
 286 }
 287
 288 /*
 289  * A set of radio buttons on the same line, without a static above
 290  * them. Otherwise just like radioline.
 291  */
 292 void bareradioline(struct ctlpos *cp, int nacross, ...)
 293 {
 294     va_list ap;
 295     struct radio *buttons;
 296     int i, nbuttons;
 297
 298     va_start(ap, nacross);
 299     nbuttons = 0;
 300     while (1) {
 301         char *btext = va_arg(ap, char *);
 302         int bid;
 303         if (!btext)
 304             break;
 305         bid = va_arg(ap, int);
 306     }
 307     va_end(ap);
 308     buttons = snewn(nbuttons, struct radio);
 309     va_start(ap, nacross);
 310     for (i = 0; i < nbuttons; i++) {
 311         buttons[i].text = va_arg(ap, char *);
 312         buttons[i].id = va_arg(ap, int);
 313     }
 314     va_end(ap);
 315     radioline_common(cp, NULL, 0, nacross, buttons, nbuttons);
 316     sfree(buttons);
 317 }
 318
 319 /*
 320  * A set of radio buttons on multiple lines, with a static above
 321  * them.
 322  */
 323 void radiobig(struct ctlpos *cp, char *text, int id, ...)
 324 {
 325     va_list ap;
 326     struct radio *buttons;
 327     int i, nbuttons;
 328
 329     va_start(ap, id);
 330     nbuttons = 0;
 331     while (1) {
 332         char *btext = va_arg(ap, char *);
 333         int bid;
 334         if (!btext)
 335             break;
 336         bid = va_arg(ap, int);
 337     }
 338     va_end(ap);
 339     buttons = snewn(nbuttons, struct radio);
 340     va_start(ap, id);
 341     for (i = 0; i < nbuttons; i++) {
 342         buttons[i].text = va_arg(ap, char *);
 343         buttons[i].id = va_arg(ap, int);
 344     }
 345     va_end(ap);
 346     radioline_common(cp, text, id, 1, buttons, nbuttons);
 347     sfree(buttons);
 348 }
 349
 350 /*
 351  * A single standalone checkbox.
 352  */
 353 void checkbox(struct ctlpos *cp, char *text, int id)
 354 {
 355     RECT r;
 356
 357     r.left = GAPBETWEEN;
 358     r.top = cp->ypos;
 359     r.right = cp->width;
 360     r.bottom = CHECKBOXHEIGHT;
 361     cp->ypos += r.bottom + GAPBETWEEN;
 362     doctl(cp, r, "BUTTON",
 363           BS_NOTIFY | BS_AUTOCHECKBOX | WS_CHILD | WS_VISIBLE | WS_TABSTOP, 0,
 364           text, id);
 365 }
 366
 367 /*
 368  * Wrap a piece of text for a static text control. Returns the
 369  * wrapped text (a malloc'ed string containing \ns), and also
 370  * returns the number of lines required.
 371  */
 372 char *staticwrap(struct ctlpos *cp, HWND hwnd, char *text, int *lines)
 373 {
 374     HDC hdc = GetDC(hwnd);
 375     int lpx = GetDeviceCaps(hdc, LOGPIXELSX);
 376     int width, nlines, j;
 377     INT *pwidths, nfit;
 378     SIZE size;
 379     char *ret, *p, *q;
 380     RECT r;
 381     HFONT oldfont, newfont;
 382
 383     ret = snewn(1+strlen(text), char);
 384     p = text;
 385     q = ret;
 386     pwidths = snewn(1+strlen(text), INT);
 387
 388     /*
 389      * Work out the width the text will need to fit in, by doing
 390      * the same adjustment that the `statictext' function itself
 391      * will perform.
 392      */
 393     SetMapMode(hdc, MM_TEXT);          /* ensure logical units == pixels */
 394     r.left = r.top = r.bottom = 0;
 395     r.right = cp->width;
 396     MapDialogRect(hwnd, &r);
 397     width = r.right;
 398
 399     nlines = 1;
 400
 401     /*
 402      * We must select the correct font into the HDC before calling
 403      * GetTextExtent*, or silly things will happen.
 404      */
 405     newfont = (HFONT)SendMessage(hwnd, WM_GETFONT, 0, 0);
 406     oldfont = SelectObject(hdc, newfont);
 407
 408     while (*p) {
 409         if (!GetTextExtentExPoint(hdc, p, strlen(p), width,
 410                                   &nfit, pwidths, &size) ||
 411             (size_t)nfit >= strlen(p)) {
 412             /*
 413              * Either GetTextExtentExPoint returned failure, or the
 414              * whole of the rest of the text fits on this line.
 415              * Either way, we stop wrapping, copy the remainder of
 416              * the input string unchanged to the output, and leave.
 417              */
 418             strcpy(q, p);
 419             break;
 420         }
 421
 422         /*
 423          * Now we search backwards along the string from `nfit',
 424          * looking for a space at which to break the line. If we
 425          * don't find one at all, that's fine - we'll just break
 426          * the line at `nfit'.
 427          */
 428         for (j = nfit; j > 0; j--) {
 429             if (isspace((unsigned char)p[j])) {
 430                 nfit = j;
 431                 break;
 432             }
 433         }
 434
 435         strncpy(q, p, nfit);
 436         q[nfit] = '\n';
 437         q += nfit+1;
 438
 439         p += nfit;
 440         while (*p && isspace((unsigned char)*p))
 441             p++;
 442
 443         nlines++;
 444     }
 445
 446     SelectObject(hdc, oldfont);
 447     ReleaseDC(cp->hwnd, hdc);
 448
 449     if (lines) *lines = nlines;
 450
 451     return ret;
 452 }
 453
 454 /*
 455  * A single standalone static text control.
 456  */
 457 void statictext(struct ctlpos *cp, char *text, int lines, int id)
 458 {
 459     RECT r;
 460
 461     r.left = GAPBETWEEN;
 462     r.top = cp->ypos;
 463     r.right = cp->width;
 464     r.bottom = STATICHEIGHT * lines;
 465     cp->ypos += r.bottom + GAPBETWEEN;
 466     doctl(cp, r, "STATIC",
 467           WS_CHILD | WS_VISIBLE | SS_LEFTNOWORDWRAP,
 468           0, text, id);
 469 }
 470
 471 /*
 472  * An owner-drawn static text control for a panel title.
 473  */
 474 void paneltitle(struct ctlpos *cp, int id)
 475 {
 476     RECT r;
 477
 478     r.left = GAPBETWEEN;
 479     r.top = cp->ypos;
 480     r.right = cp->width;
 481     r.bottom = TITLEHEIGHT;
 482     cp->ypos += r.bottom + GAPBETWEEN;
 483     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE | SS_OWNERDRAW,
 484           0, NULL, id);
 485 }
 486
 487 /*
 488  * A button on the right hand side, with a static to its left.
 489  */
 490 void staticbtn(struct ctlpos *cp, char *stext, int sid,
 491                char *btext, int bid)
 492 {
 493     const int height = (PUSHBTNHEIGHT > STATICHEIGHT ?
 494                         PUSHBTNHEIGHT : STATICHEIGHT);
 495     RECT r;
 496     int lwid, rwid, rpos;
 497
 498     rpos = GAPBETWEEN + 3 * (cp->width + GAPBETWEEN) / 4;
 499     lwid = rpos - 2 * GAPBETWEEN;
 500     rwid = cp->width + GAPBETWEEN - rpos;
 501
 502     r.left = GAPBETWEEN;
 503     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 504     r.right = lwid;
 505     r.bottom = STATICHEIGHT;
 506     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 507
 508     r.left = rpos;
 509     r.top = cp->ypos + (height - PUSHBTNHEIGHT) / 2;
 510     r.right = rwid;
 511     r.bottom = PUSHBTNHEIGHT;
 512     doctl(cp, r, "BUTTON",
 513           BS_NOTIFY | WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON,
 514           0, btext, bid);
 515
 516     cp->ypos += height + GAPBETWEEN;
 517 }
 518
 519 /*
 520  * A simple push button.
 521  */
 522 void button(struct ctlpos *cp, char *btext, int bid, int defbtn)
 523 {
 524     RECT r;
 525
 526     r.left = GAPBETWEEN;
 527     r.top = cp->ypos;
 528     r.right = cp->width;
 529     r.bottom = PUSHBTNHEIGHT;
 530
 531     /* Q67655: the _dialog box_ must know which button is default
 532      * as well as the button itself knowing */
 533     if (defbtn && cp->hwnd)
 534         SendMessage(cp->hwnd, DM_SETDEFID, bid, 0);
 535
 536     doctl(cp, r, "BUTTON",
 537           BS_NOTIFY | WS_CHILD | WS_VISIBLE | WS_TABSTOP |
 538           (defbtn ? BS_DEFPUSHBUTTON : 0) | BS_PUSHBUTTON,
 539           0, btext, bid);
 540
 541     cp->ypos += PUSHBTNHEIGHT + GAPBETWEEN;
 542 }
 543
 544 /*
 545  * Like staticbtn, but two buttons.
 546  */
 547 void static2btn(struct ctlpos *cp, char *stext, int sid,
 548                 char *btext1, int bid1, char *btext2, int bid2)
 549 {
 550     const int height = (PUSHBTNHEIGHT > STATICHEIGHT ?
 551                         PUSHBTNHEIGHT : STATICHEIGHT);
 552     RECT r;
 553     int lwid, rwid1, rwid2, rpos1, rpos2;
 554
 555     rpos1 = GAPBETWEEN + (cp->width + GAPBETWEEN) / 2;
 556     rpos2 = GAPBETWEEN + 3 * (cp->width + GAPBETWEEN) / 4;
 557     lwid = rpos1 - 2 * GAPBETWEEN;
 558     rwid1 = rpos2 - rpos1 - GAPBETWEEN;
 559     rwid2 = cp->width + GAPBETWEEN - rpos2;
 560
 561     r.left = GAPBETWEEN;
 562     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 563     r.right = lwid;
 564     r.bottom = STATICHEIGHT;
 565     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 566
 567     r.left = rpos1;
 568     r.top = cp->ypos + (height - PUSHBTNHEIGHT) / 2;
 569     r.right = rwid1;
 570     r.bottom = PUSHBTNHEIGHT;
 571     doctl(cp, r, "BUTTON",
 572           BS_NOTIFY | WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON,
 573           0, btext1, bid1);
 574
 575     r.left = rpos2;
 576     r.top = cp->ypos + (height - PUSHBTNHEIGHT) / 2;
 577     r.right = rwid2;
 578     r.bottom = PUSHBTNHEIGHT;
 579     doctl(cp, r, "BUTTON",
 580           BS_NOTIFY | WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON,
 581           0, btext2, bid2);
 582
 583     cp->ypos += height + GAPBETWEEN;
 584 }
 585
 586 /*
 587  * An edit control on the right hand side, with a static to its left.
 588  */
 589 static void staticedit_internal(struct ctlpos *cp, char *stext,
 590                                 int sid, int eid, int percentedit,
 591                                 int style)
 592 {
 593     const int height = (EDITHEIGHT > STATICHEIGHT ?
 594                         EDITHEIGHT : STATICHEIGHT);
 595     RECT r;
 596     int lwid, rwid, rpos;
 597
 598     rpos =
 599         GAPBETWEEN + (100 - percentedit) * (cp->width + GAPBETWEEN) / 100;
 600     lwid = rpos - 2 * GAPBETWEEN;
 601     rwid = cp->width + GAPBETWEEN - rpos;
 602
 603     r.left = GAPBETWEEN;
 604     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 605     r.right = lwid;
 606     r.bottom = STATICHEIGHT;
 607     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 608
 609     r.left = rpos;
 610     r.top = cp->ypos + (height - EDITHEIGHT) / 2;
 611     r.right = rwid;
 612     r.bottom = EDITHEIGHT;
 613     doctl(cp, r, "EDIT",
 614           WS_CHILD | WS_VISIBLE | WS_TABSTOP | ES_AUTOHSCROLL | style,
 615           WS_EX_CLIENTEDGE, "", eid);
 616
 617     cp->ypos += height + GAPBETWEEN;
 618 }
 619
 620 void staticedit(struct ctlpos *cp, char *stext,
 621                 int sid, int eid, int percentedit)
 622 {
 623     staticedit_internal(cp, stext, sid, eid, percentedit, 0);
 624 }
 625
 626 void staticpassedit(struct ctlpos *cp, char *stext,
 627                     int sid, int eid, int percentedit)
 628 {
 629     staticedit_internal(cp, stext, sid, eid, percentedit, ES_PASSWORD);
 630 }
 631
 632 /*
 633  * A drop-down list box on the right hand side, with a static to
 634  * its left.
 635  */
 636 void staticddl(struct ctlpos *cp, char *stext,
 637                int sid, int lid, int percentlist)
 638 {
 639     const int height = (COMBOHEIGHT > STATICHEIGHT ?
 640                         COMBOHEIGHT : STATICHEIGHT);
 641     RECT r;
 642     int lwid, rwid, rpos;
 643
 644     rpos =
 645         GAPBETWEEN + (100 - percentlist) * (cp->width + GAPBETWEEN) / 100;
 646     lwid = rpos - 2 * GAPBETWEEN;
 647     rwid = cp->width + GAPBETWEEN - rpos;
 648
 649     r.left = GAPBETWEEN;
 650     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 651     r.right = lwid;
 652     r.bottom = STATICHEIGHT;
 653     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 654
 655     r.left = rpos;
 656     r.top = cp->ypos + (height - EDITHEIGHT) / 2;
 657     r.right = rwid;
 658     r.bottom = COMBOHEIGHT*4;
 659     doctl(cp, r, "COMBOBOX",
 660           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL |
 661           CBS_DROPDOWNLIST | CBS_HASSTRINGS, WS_EX_CLIENTEDGE, "", lid);
 662
 663     cp->ypos += height + GAPBETWEEN;
 664 }
 665
 666 /*
 667  * A combo box on the right hand side, with a static to its left.
 668  */
 669 void staticcombo(struct ctlpos *cp, char *stext,
 670                  int sid, int lid, int percentlist)
 671 {
 672     const int height = (COMBOHEIGHT > STATICHEIGHT ?
 673                         COMBOHEIGHT : STATICHEIGHT);
 674     RECT r;
 675     int lwid, rwid, rpos;
 676
 677     rpos =
 678         GAPBETWEEN + (100 - percentlist) * (cp->width + GAPBETWEEN) / 100;
 679     lwid = rpos - 2 * GAPBETWEEN;
 680     rwid = cp->width + GAPBETWEEN - rpos;
 681
 682     r.left = GAPBETWEEN;
 683     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 684     r.right = lwid;
 685     r.bottom = STATICHEIGHT;
 686     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 687
 688     r.left = rpos;
 689     r.top = cp->ypos + (height - EDITHEIGHT) / 2;
 690     r.right = rwid;
 691     r.bottom = COMBOHEIGHT*10;
 692     doctl(cp, r, "COMBOBOX",
 693           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL |
 694           CBS_DROPDOWN | CBS_HASSTRINGS, WS_EX_CLIENTEDGE, "", lid);
 695
 696     cp->ypos += height + GAPBETWEEN;
 697 }
 698
 699 /*
 700  * A static, with a full-width drop-down list box below it.
 701  */
 702 void staticddlbig(struct ctlpos *cp, char *stext,
 703                   int sid, int lid)
 704 {
 705     RECT r;
 706
 707     if (stext) {
 708         r.left = GAPBETWEEN;
 709         r.top = cp->ypos;
 710         r.right = cp->width;
 711         r.bottom = STATICHEIGHT;
 712         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 713         cp->ypos += STATICHEIGHT;
 714     }
 715
 716     r.left = GAPBETWEEN;
 717     r.top = cp->ypos;
 718     r.right = cp->width;
 719     r.bottom = COMBOHEIGHT*4;
 720     doctl(cp, r, "COMBOBOX",
 721           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL |
 722           CBS_DROPDOWNLIST | CBS_HASSTRINGS, WS_EX_CLIENTEDGE, "", lid);
 723     cp->ypos += COMBOHEIGHT + GAPBETWEEN;
 724 }
 725
 726 /*
 727  * A big multiline edit control with a static labelling it.
 728  */
 729 void bigeditctrl(struct ctlpos *cp, char *stext,
 730                  int sid, int eid, int lines)
 731 {
 732     RECT r;
 733
 734     if (stext) {
 735         r.left = GAPBETWEEN;
 736         r.top = cp->ypos;
 737         r.right = cp->width;
 738         r.bottom = STATICHEIGHT;
 739         cp->ypos += r.bottom + GAPWITHIN;
 740         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 741     }
 742
 743     r.left = GAPBETWEEN;
 744     r.top = cp->ypos;
 745     r.right = cp->width;
 746     r.bottom = EDITHEIGHT + (lines - 1) * STATICHEIGHT;
 747     cp->ypos += r.bottom + GAPBETWEEN;
 748     doctl(cp, r, "EDIT",
 749           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL | ES_MULTILINE,
 750           WS_EX_CLIENTEDGE, "", eid);
 751 }
 752
 753 /*
 754  * A list box with a static labelling it.
 755  */
 756 void listbox(struct ctlpos *cp, char *stext,
 757              int sid, int lid, int lines, int multi)
 758 {
 759     RECT r;
 760
 761     if (stext != NULL) {
 762         r.left = GAPBETWEEN;
 763         r.top = cp->ypos;
 764         r.right = cp->width;
 765         r.bottom = STATICHEIGHT;
 766         cp->ypos += r.bottom + GAPWITHIN;
 767         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 768     }
 769
 770     r.left = GAPBETWEEN;
 771     r.top = cp->ypos;
 772     r.right = cp->width;
 773     r.bottom = LISTHEIGHT + (lines - 1) * LISTINCREMENT;
 774     cp->ypos += r.bottom + GAPBETWEEN;
 775     doctl(cp, r, "LISTBOX",
 776           WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_VSCROLL |
 777           LBS_NOTIFY | LBS_HASSTRINGS | LBS_USETABSTOPS |
 778           (multi ? LBS_MULTIPLESEL : 0),
 779           WS_EX_CLIENTEDGE, "", lid);
 780 }
 781
 782 /*
 783  * A tab-control substitute when a real tab control is unavailable.
 784  */
 785 void ersatztab(struct ctlpos *cp, char *stext, int sid, int lid, int s2id)
 786 {
 787     const int height = (COMBOHEIGHT > STATICHEIGHT ?
 788                         COMBOHEIGHT : STATICHEIGHT);
 789     RECT r;
 790     int bigwid, lwid, rwid, rpos;
 791     static const int BIGGAP = 15;
 792     static const int MEDGAP = 3;
 793
 794     bigwid = cp->width + 2 * GAPBETWEEN - 2 * BIGGAP;
 795     cp->ypos += MEDGAP;
 796     rpos = BIGGAP + (bigwid + BIGGAP) / 2;
 797     lwid = rpos - 2 * BIGGAP;
 798     rwid = bigwid + BIGGAP - rpos;
 799
 800     r.left = BIGGAP;
 801     r.top = cp->ypos + (height - STATICHEIGHT) / 2;
 802     r.right = lwid;
 803     r.bottom = STATICHEIGHT;
 804     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 805
 806     r.left = rpos;
 807     r.top = cp->ypos + (height - COMBOHEIGHT) / 2;
 808     r.right = rwid;
 809     r.bottom = COMBOHEIGHT * 10;
 810     doctl(cp, r, "COMBOBOX",
 811           WS_CHILD | WS_VISIBLE | WS_TABSTOP |
 812           CBS_DROPDOWNLIST | CBS_HASSTRINGS, WS_EX_CLIENTEDGE, "", lid);
 813
 814     cp->ypos += height + MEDGAP + GAPBETWEEN;
 815
 816     r.left = GAPBETWEEN;
 817     r.top = cp->ypos;
 818     r.right = cp->width;
 819     r.bottom = 2;
 820     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE | SS_ETCHEDHORZ,
 821           0, "", s2id);
 822 }
 823
 824 /*
 825  * A static line, followed by an edit control on the left hand side
 826  * and a button on the right.
 827  */
 828 void editbutton(struct ctlpos *cp, char *stext, int sid,
 829                 int eid, char *btext, int bid)
 830 {
 831     const int height = (EDITHEIGHT > PUSHBTNHEIGHT ?
 832                         EDITHEIGHT : PUSHBTNHEIGHT);
 833     RECT r;
 834     int lwid, rwid, rpos;
 835
 836     r.left = GAPBETWEEN;
 837     r.top = cp->ypos;
 838     r.right = cp->width;
 839     r.bottom = STATICHEIGHT;
 840     cp->ypos += r.bottom + GAPWITHIN;
 841     doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 842
 843     rpos = GAPBETWEEN + 3 * (cp->width + GAPBETWEEN) / 4;
 844     lwid = rpos - 2 * GAPBETWEEN;
 845     rwid = cp->width + GAPBETWEEN - rpos;
 846
 847     r.left = GAPBETWEEN;
 848     r.top = cp->ypos + (height - EDITHEIGHT) / 2;
 849     r.right = lwid;
 850     r.bottom = EDITHEIGHT;
 851     doctl(cp, r, "EDIT",
 852           WS_CHILD | WS_VISIBLE | WS_TABSTOP | ES_AUTOHSCROLL,
 853           WS_EX_CLIENTEDGE, "", eid);
 854
 855     r.left = rpos;
 856     r.top = cp->ypos + (height - PUSHBTNHEIGHT) / 2;
 857     r.right = rwid;
 858     r.bottom = PUSHBTNHEIGHT;
 859     doctl(cp, r, "BUTTON",
 860           BS_NOTIFY | WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON,
 861           0, btext, bid);
 862
 863     cp->ypos += height + GAPBETWEEN;
 864 }
 865
 866 /*
 867  * A special control for manipulating an ordered preference list
 868  * (eg. for cipher selection).
 869  * XXX: this is a rough hack and could be improved.
 870  */
 871 void prefslist(struct prefslist *hdl, struct ctlpos *cp, int lines,
 872                char *stext, int sid, int listid, int upbid, int dnbid)
 873 {
 874     const static int percents[] = { 5, 75, 20 };
 875     RECT r;
 876     int xpos, percent = 0, i;
 877     int listheight = LISTHEIGHT + (lines - 1) * LISTINCREMENT;
 878     const int BTNSHEIGHT = 2*PUSHBTNHEIGHT + GAPBETWEEN;
 879     int totalheight, buttonpos;
 880
 881     /* Squirrel away IDs. */
 882     hdl->listid = listid;
 883     hdl->upbid  = upbid;
 884     hdl->dnbid  = dnbid;
 885
 886     /* The static label. */
 887     if (stext != NULL) {
 888         r.left = GAPBETWEEN;
 889         r.top = cp->ypos;
 890         r.right = cp->width;
 891         r.bottom = STATICHEIGHT;
 892         cp->ypos += r.bottom + GAPWITHIN;
 893         doctl(cp, r, "STATIC", WS_CHILD | WS_VISIBLE, 0, stext, sid);
 894     }
 895
 896     if (listheight > BTNSHEIGHT) {
 897         totalheight = listheight;
 898         buttonpos = (listheight - BTNSHEIGHT) / 2;
 899     } else {
 900         totalheight = BTNSHEIGHT;
 901         buttonpos = 0;
 902     }
 903
 904     for (i=0; i<3; i++) {
 905         int left, wid;
 906         xpos = (cp->width + GAPBETWEEN) * percent / 100;
 907         left = xpos + GAPBETWEEN;
 908         percent += percents[i];
 909         xpos = (cp->width + GAPBETWEEN) * percent / 100;
 910         wid = xpos - left;
 911
 912         switch (i) {
 913           case 1:
 914             /* The drag list box. */
 915             r.left = left; r.right = wid;
 916             r.top = cp->ypos; r.bottom = listheight;
 917             {
 918                 HWND ctl;
 919                 ctl = doctl(cp, r, "LISTBOX",
 920                             WS_CHILD | WS_VISIBLE | WS_TABSTOP |
 921                             WS_VSCROLL | LBS_HASSTRINGS | LBS_USETABSTOPS,
 922                             WS_EX_CLIENTEDGE,
 923                             "", listid);
 924                 MakeDragList(ctl);
 925             }
 926             break;
 927
 928           case 2:
 929             /* The "Up" and "Down" buttons. */
 930             /* XXX worry about accelerators if we have more than one
 931              * prefslist on a panel */
 932             r.left = left; r.right = wid;
 933             r.top = cp->ypos + buttonpos; r.bottom = PUSHBTNHEIGHT;
 934             doctl(cp, r, "BUTTON",
 935                   BS_NOTIFY | WS_CHILD | WS_VISIBLE |
 936                   WS_TABSTOP | BS_PUSHBUTTON,
 937                   0, "&Up", upbid);
 938
 939             r.left = left; r.right = wid;
 940             r.top = cp->ypos + buttonpos + PUSHBTNHEIGHT + GAPBETWEEN;
 941             r.bottom = PUSHBTNHEIGHT;
 942             doctl(cp, r, "BUTTON",
 943                   BS_NOTIFY | WS_CHILD | WS_VISIBLE |
 944                   WS_TABSTOP | BS_PUSHBUTTON,
 945                   0, "&Down", dnbid);
 946
 947             break;
 948
 949         }
 950     }
 951
 952     cp->ypos += totalheight + GAPBETWEEN;
 953
 954 }
 955
 956 /*
 957  * Helper function for prefslist: move item in list box.
 958  */
 959 static void pl_moveitem(HWND hwnd, int listid, int src, int dst)
 960 {
 961     int tlen, val;
 962     char *txt;
 963     /* Get the item's data. */
 964     tlen = SendDlgItemMessage (hwnd, listid, LB_GETTEXTLEN, src, 0);
 965     txt = snewn(tlen+1, char);
 966     SendDlgItemMessage (hwnd, listid, LB_GETTEXT, src, (LPARAM) txt);
 967     val = SendDlgItemMessage (hwnd, listid, LB_GETITEMDATA, src, 0);
 968     /* Deselect old location. */
 969     SendDlgItemMessage (hwnd, listid, LB_SETSEL, FALSE, src);
 970     /* Delete it at the old location. */
 971     SendDlgItemMessage (hwnd, listid, LB_DELETESTRING, src, 0);
 972     /* Insert it at new location. */
 973     SendDlgItemMessage (hwnd, listid, LB_INSERTSTRING, dst,
 974                         (LPARAM) txt);
 975     SendDlgItemMessage (hwnd, listid, LB_SETITEMDATA, dst,
 976                         (LPARAM) val);
 977     /* Set selection. */
 978     SendDlgItemMessage (hwnd, listid, LB_SETCURSEL, dst, 0);
 979     sfree (txt);
 980 }
 981
 982 int pl_itemfrompt(HWND hwnd, POINT cursor, BOOL scroll)
 983 {
 984     int ret;
 985     POINT uppoint, downpoint;
 986     int updist, downdist, upitem, downitem, i;
 987
 988     /*
 989      * Ghastly hackery to try to figure out not which
 990      * _item_, but which _gap between items_, the user
 991      * is pointing at. We do this by first working out
 992      * which list item is under the cursor, and then
 993      * working out how far the cursor would have to
 994      * move up or down before the answer was different.
 995      * Then we put the insertion point _above_ the
 996      * current item if the upper edge is closer than
 997      * the lower edge, or _below_ it if vice versa.
 998      */
 999     ret = LBItemFromPt(hwnd, cursor, scroll);
1000     if (ret == -1)
1001         return ret;
1002     ret = LBItemFromPt(hwnd, cursor, FALSE);
1003     updist = downdist = 0;
1004     for (i = 1; i < 4096 && (!updist || !downdist); i++) {
1005         uppoint = downpoint = cursor;
1006         uppoint.y -= i;
1007         downpoint.y += i;
1008         upitem = LBItemFromPt(hwnd, uppoint, FALSE);
1009         downitem = LBItemFromPt(hwnd, downpoint, FALSE);
1010         if (!updist && upitem != ret)
1011             updist = i;
1012         if (!downdist && downitem != ret)
1013             downdist = i;
1014     }
1015     if (downdist < updist)
1016         ret++;
1017     return ret;
1018 }
1019
1020 /*
1021  * Handler for prefslist above.
1022  *
1023  * Return value has bit 0 set if the dialog box procedure needs to
1024  * return TRUE from handling this message; it has bit 1 set if a
1025  * change may have been made in the contents of the list.
1026  */
1027 int handle_prefslist(struct prefslist *hdl,
1028                      int *array, int maxmemb,
1029                      int is_dlmsg, HWND hwnd,
1030                      WPARAM wParam, LPARAM lParam)
1031 {
1032     int i;
1033     int ret = 0;
1034
1035     if (is_dlmsg) {
1036
1037         if ((int)wParam == hdl->listid) {
1038             DRAGLISTINFO *dlm = (DRAGLISTINFO *)lParam;
1039             int dest = 0;              /* initialise to placate gcc */
1040             switch (dlm->uNotification) {
1041               case DL_BEGINDRAG:
1042                 /* Add a dummy item to make pl_itemfrompt() work
1043                  * better.
1044                  * FIXME: this causes scrollbar glitches if the count of
1045                  *        listbox contains >= its height. */
1046                 hdl->dummyitem =
1047                     SendDlgItemMessage(hwnd, hdl->listid,
1048                                        LB_ADDSTRING, 0, (LPARAM) "");
1049
1050                 hdl->srcitem = LBItemFromPt(dlm->hWnd, dlm->ptCursor, TRUE);
1051                 hdl->dragging = 0;
1052                 /* XXX hack Q183115 */
1053                 SetWindowLongPtr(hwnd, DWLP_MSGRESULT, TRUE);
1054                 ret |= 1; break;
1055               case DL_CANCELDRAG:
1056                 DrawInsert(hwnd, dlm->hWnd, -1);     /* Clear arrow */
1057                 SendDlgItemMessage(hwnd, hdl->listid,
1058                                    LB_DELETESTRING, hdl->dummyitem, 0);
1059                 hdl->dragging = 0;
1060                 ret |= 1; break;
1061               case DL_DRAGGING:
1062                 hdl->dragging = 1;
1063                 dest = pl_itemfrompt(dlm->hWnd, dlm->ptCursor, TRUE);
1064                 if (dest > hdl->dummyitem) dest = hdl->dummyitem;
1065                 DrawInsert (hwnd, dlm->hWnd, dest);
1066                 if (dest >= 0)
1067                     SetWindowLongPtr(hwnd, DWLP_MSGRESULT, DL_MOVECURSOR);
1068                 else
1069                     SetWindowLongPtr(hwnd, DWLP_MSGRESULT, DL_STOPCURSOR);
1070                 ret |= 1; break;
1071               case DL_DROPPED:
1072                 if (hdl->dragging) {
1073                     dest = pl_itemfrompt(dlm->hWnd, dlm->ptCursor, TRUE);
1074                     if (dest > hdl->dummyitem) dest = hdl->dummyitem;
1075                     DrawInsert (hwnd, dlm->hWnd, -1);
1076                 }
1077                 SendDlgItemMessage(hwnd, hdl->listid,
1078                                    LB_DELETESTRING, hdl->dummyitem, 0);
1079                 if (hdl->dragging) {
1080                     hdl->dragging = 0;
1081                     if (dest >= 0) {
1082                         /* Correct for "missing" item. */
1083                         if (dest > hdl->srcitem) dest--;
1084                         pl_moveitem(hwnd, hdl->listid, hdl->srcitem, dest);
1085                     }
1086                     ret |= 2;
1087                 }
1088                 ret |= 1; break;
1089             }
1090         }
1091
1092     } else {
1093
1094         if (((LOWORD(wParam) == hdl->upbid) ||
1095              (LOWORD(wParam) == hdl->dnbid)) &&
1096             ((HIWORD(wParam) == BN_CLICKED) ||
1097              (HIWORD(wParam) == BN_DOUBLECLICKED))) {
1098             /* Move an item up or down the list. */
1099             /* Get the current selection, if any. */
1100             int selection = SendDlgItemMessage (hwnd, hdl->listid, LB_GETCURSEL, 0, 0);
1101             if (selection == LB_ERR) {
1102                 MessageBeep(0);
1103             } else {
1104                 int nitems;
1105                 /* Get the total number of items. */
1106                 nitems = SendDlgItemMessage (hwnd, hdl->listid, LB_GETCOUNT, 0, 0);
1107                 /* Should we do anything? */
1108                 if (LOWORD(wParam) == hdl->upbid && (selection > 0))
1109                     pl_moveitem(hwnd, hdl->listid, selection, selection - 1);
1110                 else if (LOWORD(wParam) == hdl->dnbid && (selection < nitems - 1))
1111                     pl_moveitem(hwnd, hdl->listid, selection, selection + 1);
1112                 ret |= 2;
1113             }
1114
1115         }
1116
1117     }
1118
1119     if (array) {
1120         /* Update array to match the list box. */
1121         for (i=0; i < maxmemb; i++)
1122             array[i] = SendDlgItemMessage (hwnd, hdl->listid, LB_GETITEMDATA,
1123                                            i, 0);
1124     }
1125
1126     return ret;
1127 }
1128
1129 /*
1130  * A progress bar (from Common Controls). We like our progress bars
1131  * to be smooth and unbroken, without those ugly divisions; some
1132  * older compilers may not support that, but that's life.
1133  */
1134 void progressbar(struct ctlpos *cp, int id)
1135 {
1136     RECT r;
1137
1138     r.left = GAPBETWEEN;
1139     r.top = cp->ypos;
1140     r.right = cp->width;
1141     r.bottom = PROGBARHEIGHT;
1142     cp->ypos += r.bottom + GAPBETWEEN;
1143
1144     doctl(cp, r, PROGRESS_CLASS, WS_CHILD | WS_VISIBLE
1145 #ifdef PBS_SMOOTH
1146           | PBS_SMOOTH
1147 #endif
1148           , WS_EX_CLIENTEDGE, "", id);
1149 }
1150
1151 /* ----------------------------------------------------------------------
1152  * Platform-specific side of portable dialog-box mechanism.
1153  */
1154
1155 /*
1156  * This function takes a string, escapes all the ampersands, and
1157  * places a single (unescaped) ampersand in front of the first
1158  * occurrence of the given shortcut character (which may be
1159  * NO_SHORTCUT).
1160  *
1161  * Return value is a malloc'ed copy of the processed version of the
1162  * string.
1163  */
1164 static char *shortcut_escape(char *text, char shortcut)
1165 {
1166     char *ret;
1167     char *p, *q;
1168
1169     if (!text)
1170         return NULL;                   /* sfree won't choke on this */
1171
1172     ret = snewn(2*strlen(text)+1, char);   /* size potentially doubles! */
1173     shortcut = tolower((unsigned char)shortcut);
1174
1175     p = text;
1176     q = ret;
1177     while (*p) {
1178         if (shortcut != NO_SHORTCUT &&
1179             tolower((unsigned char)*p) == shortcut) {
1180             *q++ = '&';
1181             shortcut = NO_SHORTCUT;    /* stop it happening twice */
1182         } else if (*p == '&') {
1183             *q++ = '&';
1184         }
1185         *q++ = *p++;
1186     }
1187     *q = '\0';
1188     return ret;
1189 }
1190
1191 void winctrl_add_shortcuts(struct dlgparam *dp, struct winctrl *c)
1192 {
1193     int i;
1194     for (i = 0; i < lenof(c->shortcuts); i++)
1195         if (c->shortcuts[i] != NO_SHORTCUT) {
1196             unsigned char s = tolower((unsigned char)c->shortcuts[i]);
1197             assert(!dp->shortcuts[s]);
1198             dp->shortcuts[s] = TRUE;
1199         }
1200 }
1201
1202 void winctrl_rem_shortcuts(struct dlgparam *dp, struct winctrl *c)
1203 {
1204     int i;
1205     for (i = 0; i < lenof(c->shortcuts); i++)
1206         if (c->shortcuts[i] != NO_SHORTCUT) {
1207             unsigned char s = tolower((unsigned char)c->shortcuts[i]);
1208             assert(dp->shortcuts[s]);
1209             dp->shortcuts[s] = FALSE;
1210         }
1211 }
1212
1213 static int winctrl_cmp_byctrl(void *av, void *bv)
1214 {
1215     struct winctrl *a = (struct winctrl *)av;
1216     struct winctrl *b = (struct winctrl *)bv;
1217     if (a->ctrl < b->ctrl)
1218         return -1;
1219     else if (a->ctrl > b->ctrl)
1220         return +1;
1221     else
1222         return 0;
1223 }
1224 static int winctrl_cmp_byid(void *av, void *bv)
1225 {
1226     struct winctrl *a = (struct winctrl *)av;
1227     struct winctrl *b = (struct winctrl *)bv;
1228     if (a->base_id < b->base_id)
1229         return -1;
1230     else if (a->base_id > b->base_id)
1231         return +1;
1232     else
1233         return 0;
1234 }
1235 static int winctrl_cmp_byctrl_find(void *av, void *bv)
1236 {
1237     union control *a = (union control *)av;
1238     struct winctrl *b = (struct winctrl *)bv;
1239     if (a < b->ctrl)
1240         return -1;
1241     else if (a > b->ctrl)
1242         return +1;
1243     else
1244         return 0;
1245 }
1246 static int winctrl_cmp_byid_find(void *av, void *bv)
1247 {
1248     int *a = (int *)av;
1249     struct winctrl *b = (struct winctrl *)bv;
1250     if (*a < b->base_id)
1251         return -1;
1252     else if (*a >= b->base_id + b->num_ids)
1253         return +1;
1254     else
1255         return 0;
1256 }
1257
1258 void winctrl_init(struct winctrls *wc)
1259 {
1260     wc->byctrl = newtree234(winctrl_cmp_byctrl);
1261     wc->byid = newtree234(winctrl_cmp_byid);
1262 }
1263 void winctrl_cleanup(struct winctrls *wc)
1264 {
1265     struct winctrl *c;
1266
1267     while ((c = index234(wc->byid, 0)) != NULL) {
1268         winctrl_remove(wc, c);
1269         sfree(c->data);
1270         sfree(c);
1271     }
1272
1273     freetree234(wc->byctrl);
1274     freetree234(wc->byid);
1275     wc->byctrl = wc->byid = NULL;
1276 }
1277
1278 void winctrl_add(struct winctrls *wc, struct winctrl *c)
1279 {
1280     struct winctrl *ret;
1281     if (c->ctrl) {
1282         ret = add234(wc->byctrl, c);
1283         assert(ret == c);
1284     }
1285     ret = add234(wc->byid, c);
1286     assert(ret == c);
1287 }
1288
1289 void winctrl_remove(struct winctrls *wc, struct winctrl *c)
1290 {
1291     struct winctrl *ret;
1292     ret = del234(wc->byctrl, c);
1293     ret = del234(wc->byid, c);
1294     assert(ret == c);
1295 }
1296
1297 struct winctrl *winctrl_findbyctrl(struct winctrls *wc, union control *ctrl)
1298 {
1299     return find234(wc->byctrl, ctrl, winctrl_cmp_byctrl_find);
1300 }
1301
1302 struct winctrl *winctrl_findbyid(struct winctrls *wc, int id)
1303 {
1304     return find234(wc->byid, &id, winctrl_cmp_byid_find);
1305 }
1306
1307 struct winctrl *winctrl_findbyindex(struct winctrls *wc, int index)
1308 {
1309     return index234(wc->byid, index);
1310 }
1311
1312 void winctrl_layout(struct dlgparam *dp, struct winctrls *wc,
1313                     struct ctlpos *cp, struct controlset *s, int *id)
1314 {
1315     struct ctlpos columns[16];
1316     int ncols, colstart, colspan;
1317
1318     struct ctlpos tabdelays[16];
1319     union control *tabdelayed[16];
1320     int ntabdelays;
1321
1322     struct ctlpos pos;
1323
1324     char shortcuts[MAX_SHORTCUTS_PER_CTRL];
1325     int nshortcuts;
1326     char *escaped;
1327     int i, actual_base_id, base_id, num_ids;
1328     void *data;
1329
1330     base_id = *id;
1331
1332     /* Start a containing box, if we have a boxname. */
1333     if (s->boxname && *s->boxname) {
1334         struct winctrl *c = snew(struct winctrl);
1335         c->ctrl = NULL;
1336         c->base_id = base_id;
1337         c->num_ids = 1;
1338         c->data = NULL;
1339         memset(c->shortcuts, NO_SHORTCUT, lenof(c->shortcuts));
1340         winctrl_add(wc, c);
1341         beginbox(cp, s->boxtitle, base_id);
1342         base_id++;
1343     }
1344
1345     /* Draw a title, if we have one. */
1346     if (!s->boxname && s->boxtitle) {
1347         struct winctrl *c = snew(struct winctrl);
1348         c->ctrl = NULL;
1349         c->base_id = base_id;
1350         c->num_ids = 1;
1351         c->data = dupstr(s->boxtitle);
1352         memset(c->shortcuts, NO_SHORTCUT, lenof(c->shortcuts));
1353         winctrl_add(wc, c);
1354         paneltitle(cp, base_id);
1355         base_id++;
1356     }
1357
1358     /* Initially we have just one column. */
1359     ncols = 1;
1360     columns[0] = *cp;                  /* structure copy */
1361
1362     /* And initially, there are no pending tab-delayed controls. */
1363     ntabdelays = 0;
1364
1365     /* Loop over each control in the controlset. */
1366     for (i = 0; i < s->ncontrols; i++) {
1367         union control *ctrl = s->ctrls[i];
1368
1369         /*
1370          * Generic processing that pertains to all control types.
1371          * At the end of this if statement, we'll have produced
1372          * `ctrl' (a pointer to the control we have to create, or
1373          * think about creating, in this iteration of the loop),
1374          * `pos' (a suitable ctlpos with which to position it), and
1375          * `c' (a winctrl structure to receive details of the
1376          * dialog IDs). Or we'll have done a `continue', if it was
1377          * CTRL_COLUMNS and doesn't require any control creation at
1378          * all.
1379          */
1380         if (ctrl->generic.type == CTRL_COLUMNS) {
1381             assert((ctrl->columns.ncols == 1) ^ (ncols == 1));
1382
1383             if (ncols == 1) {
1384                 /*
1385                  * We're splitting into multiple columns.
1386                  */
1387                 int lpercent, rpercent, lx, rx, i;
1388
1389                 ncols = ctrl->columns.ncols;
1390                 assert(ncols <= lenof(columns));
1391                 for (i = 1; i < ncols; i++)
1392                     columns[i] = columns[0];   /* structure copy */
1393
1394                 lpercent = 0;
1395                 for (i = 0; i < ncols; i++) {
1396                     rpercent = lpercent + ctrl->columns.percentages[i];
1397                     lx = columns[i].xoff + lpercent *
1398                         (columns[i].width + GAPBETWEEN) / 100;
1399                     rx = columns[i].xoff + rpercent *
1400                         (columns[i].width + GAPBETWEEN) / 100;
1401                     columns[i].xoff = lx;
1402                     columns[i].width = rx - lx - GAPBETWEEN;
1403                     lpercent = rpercent;
1404                 }
1405             } else {
1406                 /*
1407                  * We're recombining the various columns into one.
1408                  */
1409                 int maxy = columns[0].ypos;
1410                 int i;
1411                 for (i = 1; i < ncols; i++)
1412                     if (maxy < columns[i].ypos)
1413                         maxy = columns[i].ypos;
1414                 ncols = 1;
1415                 columns[0] = *cp;      /* structure copy */
1416                 columns[0].ypos = maxy;
1417             }
1418
1419             continue;
1420         } else if (ctrl->generic.type == CTRL_TABDELAY) {
1421             int i;
1422
1423             assert(!ctrl->generic.tabdelay);
1424             ctrl = ctrl->tabdelay.ctrl;
1425
1426             for (i = 0; i < ntabdelays; i++)
1427                 if (tabdelayed[i] == ctrl)
1428                     break;
1429             assert(i < ntabdelays);    /* we have to have found it */
1430
1431             pos = tabdelays[i];        /* structure copy */
1432
1433             colstart = colspan = -1;   /* indicate this was tab-delayed */
1434
1435         } else {
1436             /*
1437              * If it wasn't one of those, it's a genuine control;
1438              * so we'll have to compute a position for it now, by
1439              * checking its column span.
1440              */
1441             int col;
1442
1443             colstart = COLUMN_START(ctrl->generic.column);
1444             colspan = COLUMN_SPAN(ctrl->generic.column);
1445
1446             pos = columns[colstart];   /* structure copy */
1447             pos.width = columns[colstart+colspan-1].width +
1448                 (columns[colstart+colspan-1].xoff - columns[colstart].xoff);
1449
1450             for (col = colstart; col < colstart+colspan; col++)
1451                 if (pos.ypos < columns[col].ypos)
1452                     pos.ypos = columns[col].ypos;
1453
1454             /*
1455              * If this control is to be tabdelayed, add it to the
1456              * tabdelay list, and unset pos.hwnd to inhibit actual
1457              * control creation.
1458              */
1459             if (ctrl->generic.tabdelay) {
1460                 assert(ntabdelays < lenof(tabdelays));
1461                 tabdelays[ntabdelays] = pos;   /* structure copy */
1462                 tabdelayed[ntabdelays] = ctrl;
1463                 ntabdelays++;
1464                 pos.hwnd = NULL;
1465             }
1466         }
1467
1468         /* Most controls don't need anything in c->data. */
1469         data = NULL;
1470
1471         /* And they all start off with no shortcuts registered. */
1472         memset(shortcuts, NO_SHORTCUT, lenof(shortcuts));
1473         nshortcuts = 0;
1474
1475         /* Almost all controls start at base_id. */
1476         actual_base_id = base_id;
1477
1478         /*
1479          * Now we're ready to actually create the control, by
1480          * switching on its type.
1481          */
1482         switch (ctrl->generic.type) {
1483           case CTRL_TEXT:
1484             {
1485                 char *wrapped, *escaped;
1486                 int lines;
1487                 num_ids = 1;
1488                 wrapped = staticwrap(&pos, cp->hwnd,
1489                                      ctrl->generic.label, &lines);
1490                 escaped = shortcut_escape(wrapped, NO_SHORTCUT);
1491                 statictext(&pos, escaped, lines, base_id);
1492                 sfree(escaped);
1493                 sfree(wrapped);
1494             }
1495             break;
1496           case CTRL_EDITBOX:
1497             num_ids = 2;               /* static, edit */
1498             escaped = shortcut_escape(ctrl->editbox.label,
1499                                       ctrl->editbox.shortcut);
1500             shortcuts[nshortcuts++] = ctrl->editbox.shortcut;
1501             if (ctrl->editbox.percentwidth == 100) {
1502                 if (ctrl->editbox.has_list)
1503                     combobox(&pos, escaped,
1504                              base_id, base_id+1);
1505                 else
1506                     editboxfw(&pos, ctrl->editbox.password, escaped,
1507                               base_id, base_id+1);
1508             } else {
1509                 if (ctrl->editbox.has_list) {
1510                     staticcombo(&pos, escaped, base_id, base_id+1,
1511                                 ctrl->editbox.percentwidth);
1512                 } else {
1513                     (ctrl->editbox.password ? staticpassedit : staticedit)
1514                         (&pos, escaped, base_id, base_id+1,
1515                          ctrl->editbox.percentwidth);
1516                 }
1517             }
1518             sfree(escaped);
1519             break;
1520           case CTRL_RADIO:
1521             num_ids = ctrl->radio.nbuttons + 1;   /* label as well */
1522             {
1523                 struct radio *buttons;
1524                 int i;
1525
1526                 escaped = shortcut_escape(ctrl->radio.label,
1527                                           ctrl->radio.shortcut);
1528                 shortcuts[nshortcuts++] = ctrl->radio.shortcut;
1529
1530                 buttons = snewn(ctrl->radio.nbuttons, struct radio);
1531
1532                 for (i = 0; i < ctrl->radio.nbuttons; i++) {
1533                     buttons[i].text =
1534                         shortcut_escape(ctrl->radio.buttons[i],
1535                                         (char)(ctrl->radio.shortcuts ?
1536                                                ctrl->radio.shortcuts[i] :
1537                                                NO_SHORTCUT));
1538                     buttons[i].id = base_id + 1 + i;
1539                     if (ctrl->radio.shortcuts) {
1540                         assert(nshortcuts < MAX_SHORTCUTS_PER_CTRL);
1541                         shortcuts[nshortcuts++] = ctrl->radio.shortcuts[i];
1542                     }
1543                 }
1544
1545                 radioline_common(&pos, escaped, base_id,
1546                                  ctrl->radio.ncolumns,
1547                                  buttons, ctrl->radio.nbuttons);
1548
1549                 for (i = 0; i < ctrl->radio.nbuttons; i++) {
1550                     sfree(buttons[i].text);
1551                 }
1552                 sfree(buttons);
1553                 sfree(escaped);
1554             }
1555             break;
1556           case CTRL_CHECKBOX:
1557             num_ids = 1;
1558             escaped = shortcut_escape(ctrl->checkbox.label,
1559                                       ctrl->checkbox.shortcut);
1560             shortcuts[nshortcuts++] = ctrl->checkbox.shortcut;
1561             checkbox(&pos, escaped, base_id);
1562             sfree(escaped);
1563             break;
1564           case CTRL_BUTTON:
1565             escaped = shortcut_escape(ctrl->button.label,
1566                                       ctrl->button.shortcut);
1567             shortcuts[nshortcuts++] = ctrl->button.shortcut;
1568             if (ctrl->button.iscancel)
1569                 actual_base_id = IDCANCEL;
1570             num_ids = 1;
1571             button(&pos, escaped, actual_base_id, ctrl->button.isdefault);
1572             sfree(escaped);
1573             break;
1574           case CTRL_LISTBOX:
1575             num_ids = 2;
1576             escaped = shortcut_escape(ctrl->listbox.label,
1577                                       ctrl->listbox.shortcut);
1578             shortcuts[nshortcuts++] = ctrl->listbox.shortcut;
1579             if (ctrl->listbox.draglist) {
1580                 data = snew(struct prefslist);
1581                 num_ids = 4;
1582                 prefslist(data, &pos, ctrl->listbox.height, escaped,
1583                           base_id, base_id+1, base_id+2, base_id+3);
1584                 shortcuts[nshortcuts++] = 'u';   /* Up */
1585                 shortcuts[nshortcuts++] = 'd';   /* Down */
1586             } else if (ctrl->listbox.height == 0) {
1587                 /* Drop-down list. */
1588                 if (ctrl->listbox.percentwidth == 100) {
1589                     staticddlbig(&pos, escaped,
1590                                  base_id, base_id+1);
1591                 } else {
1592                     staticddl(&pos, escaped, base_id,
1593                               base_id+1, ctrl->listbox.percentwidth);
1594                 }
1595             } else {
1596                 /* Ordinary list. */
1597                 listbox(&pos, escaped, base_id, base_id+1,
1598                         ctrl->listbox.height, ctrl->listbox.multisel);
1599             }
1600             if (ctrl->listbox.ncols) {
1601                 /*
1602                  * This method of getting the box width is a bit of
1603                  * a hack; we'd do better to try to retrieve the
1604                  * actual width in dialog units from doctl() just
1605                  * before MapDialogRect. But that's going to be no
1606                  * fun, and this should be good enough accuracy.
1607                  */
1608                 int width = cp->width * ctrl->listbox.percentwidth;
1609                 int *tabarray;
1610                 int i, percent;
1611
1612                 tabarray = snewn(ctrl->listbox.ncols-1, int);
1613                 percent = 0;
1614                 for (i = 0; i < ctrl->listbox.ncols-1; i++) {
1615                     percent += ctrl->listbox.percentages[i];
1616                     tabarray[i] = width * percent / 10000;
1617                 }
1618                 SendDlgItemMessage(cp->hwnd, base_id+1, LB_SETTABSTOPS,
1619                                    ctrl->listbox.ncols-1, (LPARAM)tabarray);
1620                 sfree(tabarray);
1621             }
1622             sfree(escaped);
1623             break;
1624           case CTRL_FILESELECT:
1625             num_ids = 3;
1626             escaped = shortcut_escape(ctrl->fileselect.label,
1627                                       ctrl->fileselect.shortcut);
1628             shortcuts[nshortcuts++] = ctrl->fileselect.shortcut;
1629             editbutton(&pos, escaped, base_id, base_id+1,
1630                        "Bro&wse...", base_id+2);
1631             shortcuts[nshortcuts++] = 'w';
1632             sfree(escaped);
1633             break;
1634           case CTRL_FONTSELECT:
1635             num_ids = 3;
1636             escaped = shortcut_escape(ctrl->fontselect.label,
1637                                       ctrl->fontselect.shortcut);
1638             shortcuts[nshortcuts++] = ctrl->fontselect.shortcut;
1639             statictext(&pos, escaped, 1, base_id);
1640             staticbtn(&pos, "", base_id+1, "Change...", base_id+2);
1641             sfree(escaped);
1642             data = snew(FontSpec);
1643             break;
1644           default:
1645             assert(!"Can't happen");
1646             num_ids = 0;               /* placate gcc */
1647             break;
1648         }
1649
1650         /*
1651          * Create a `struct winctrl' for this control, and advance
1652          * the dialog ID counter, if it's actually been created
1653          * (and isn't tabdelayed).
1654          */
1655         if (pos.hwnd) {
1656             struct winctrl *c = snew(struct winctrl);
1657
1658             c->ctrl = ctrl;
1659             c->base_id = actual_base_id;
1660             c->num_ids = num_ids;
1661             c->data = data;
1662             memcpy(c->shortcuts, shortcuts, sizeof(shortcuts));
1663             winctrl_add(wc, c);
1664             winctrl_add_shortcuts(dp, c);
1665             if (actual_base_id == base_id)
1666                 base_id += num_ids;
1667         }
1668
1669         if (colstart >= 0) {
1670             /*
1671              * Update the ypos in all columns crossed by this
1672              * control.
1673              */
1674             int i;
1675             for (i = colstart; i < colstart+colspan; i++)
1676                 columns[i].ypos = pos.ypos;
1677         }
1678     }
1679
1680     /*
1681      * We've now finished laying out the controls; so now update
1682      * the ctlpos and control ID that were passed in, terminate
1683      * any containing box, and return.
1684      */
1685     for (i = 0; i < ncols; i++)
1686         if (cp->ypos < columns[i].ypos)
1687             cp->ypos = columns[i].ypos;
1688     *id = base_id;
1689
1690     if (s->boxname && *s->boxname)
1691         endbox(cp);
1692 }
1693
1694 static void winctrl_set_focus(union control *ctrl, struct dlgparam *dp,
1695                               int has_focus)
1696 {
1697     if (has_focus) {
1698         if (dp->focused)
1699             dp->lastfocused = dp->focused;
1700         dp->focused = ctrl;
1701     } else if (!has_focus && dp->focused == ctrl) {
1702         dp->lastfocused = dp->focused;
1703         dp->focused = NULL;
1704     }
1705 }
1706
1707 union control *dlg_last_focused(union control *ctrl, void *dlg)
1708 {
1709     struct dlgparam *dp = (struct dlgparam *)dlg;
1710     return dp->focused == ctrl ? dp->lastfocused : dp->focused;
1711 }
1712
1713 /*
1714  * The dialog-box procedure calls this function to handle Windows
1715  * messages on a control we manage.
1716  */
1717 int winctrl_handle_command(struct dlgparam *dp, UINT msg,
1718                            WPARAM wParam, LPARAM lParam)
1719 {
1720     struct winctrl *c;
1721     union control *ctrl;
1722     int i, id, ret;
1723     static UINT draglistmsg = WM_NULL;
1724
1725     /*
1726      * Filter out pointless window messages. Our interest is in
1727      * WM_COMMAND and the drag list message, and nothing else.
1728      */
1729     if (draglistmsg == WM_NULL)
1730         draglistmsg = RegisterWindowMessage (DRAGLISTMSGSTRING);
1731
1732     if (msg != draglistmsg && msg != WM_COMMAND && msg != WM_DRAWITEM)
1733         return 0;
1734
1735     /*
1736      * Look up the control ID in our data.
1737      */
1738     c = NULL;
1739     for (i = 0; i < dp->nctrltrees; i++) {
1740         c = winctrl_findbyid(dp->controltrees[i], LOWORD(wParam));
1741         if (c)
1742             break;
1743     }
1744     if (!c)
1745         return 0;                      /* we have nothing to do */
1746
1747     if (msg == WM_DRAWITEM) {
1748         /*
1749          * Owner-draw request for a panel title.
1750          */
1751         LPDRAWITEMSTRUCT di = (LPDRAWITEMSTRUCT) lParam;
1752         HDC hdc = di->hDC;
1753         RECT r = di->rcItem;
1754         SIZE s;
1755
1756         SetMapMode(hdc, MM_TEXT);      /* ensure logical units == pixels */
1757
1758         GetTextExtentPoint32(hdc, (char *)c->data,
1759                                  strlen((char *)c->data), &s);
1760         DrawEdge(hdc, &r, EDGE_ETCHED, BF_ADJUST | BF_RECT);
1761         TextOut(hdc,
1762                 r.left + (r.right-r.left-s.cx)/2,
1763                 r.top + (r.bottom-r.top-s.cy)/2,
1764                 (char *)c->data, strlen((char *)c->data));
1765
1766         return TRUE;
1767     }
1768
1769     ctrl = c->ctrl;
1770     id = LOWORD(wParam) - c->base_id;
1771
1772     if (!ctrl || !ctrl->generic.handler)
1773         return 0;                      /* nothing we can do here */
1774
1775     /*
1776      * From here on we do not issue `return' statements until the
1777      * very end of the dialog box: any event handler is entitled to
1778      * ask for a colour selector, so we _must_ always allow control
1779      * to reach the end of this switch statement so that the
1780      * subsequent code can test dp->coloursel_wanted().
1781      */
1782     ret = 0;
1783     dp->coloursel_wanted = FALSE;
1784
1785     /*
1786      * Now switch on the control type and the message.
1787      */
1788     switch (ctrl->generic.type) {
1789       case CTRL_EDITBOX:
1790         if (msg == WM_COMMAND && !ctrl->editbox.has_list &&
1791             (HIWORD(wParam) == EN_SETFOCUS || HIWORD(wParam) == EN_KILLFOCUS))
1792             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == EN_SETFOCUS);
1793         if (msg == WM_COMMAND && ctrl->editbox.has_list &&
1794             (HIWORD(wParam)==CBN_SETFOCUS || HIWORD(wParam)==CBN_KILLFOCUS))
1795             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == CBN_SETFOCUS);
1796
1797         if (msg == WM_COMMAND && !ctrl->editbox.has_list &&
1798             HIWORD(wParam) == EN_CHANGE)
1799             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1800         if (msg == WM_COMMAND &&
1801             ctrl->editbox.has_list) {
1802             if (HIWORD(wParam) == CBN_SELCHANGE) {
1803                 int index, len;
1804                 char *text;
1805
1806                 index = SendDlgItemMessage(dp->hwnd, c->base_id+1,
1807                                            CB_GETCURSEL, 0, 0);
1808                 len = SendDlgItemMessage(dp->hwnd, c->base_id+1,
1809                                          CB_GETLBTEXTLEN, index, 0);
1810                 text = snewn(len+1, char);
1811                 SendDlgItemMessage(dp->hwnd, c->base_id+1, CB_GETLBTEXT,
1812                                    index, (LPARAM)text);
1813                 SetDlgItemText(dp->hwnd, c->base_id+1, text);
1814                 sfree(text);
1815                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1816             } else if (HIWORD(wParam) == CBN_EDITCHANGE) {
1817                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1818             } else if (HIWORD(wParam) == CBN_KILLFOCUS) {
1819                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_REFRESH);
1820             }
1821
1822         }
1823         break;
1824       case CTRL_RADIO:
1825         if (msg == WM_COMMAND &&
1826             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1827             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1828         /*
1829          * We sometimes get spurious BN_CLICKED messages for the
1830          * radio button that is just about to _lose_ selection, if
1831          * we're switching using the arrow keys. Therefore we
1832          * double-check that the button in wParam is actually
1833          * checked before generating an event.
1834          */
1835         if (msg == WM_COMMAND &&
1836             (HIWORD(wParam) == BN_CLICKED ||
1837              HIWORD(wParam) == BN_DOUBLECLICKED) &&
1838             IsDlgButtonChecked(dp->hwnd, LOWORD(wParam))) {
1839             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1840         }
1841         break;
1842       case CTRL_CHECKBOX:
1843         if (msg == WM_COMMAND &&
1844             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1845             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1846         if (msg == WM_COMMAND &&
1847             (HIWORD(wParam) == BN_CLICKED ||
1848              HIWORD(wParam) == BN_DOUBLECLICKED)) {
1849             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1850         }
1851         break;
1852       case CTRL_BUTTON:
1853         if (msg == WM_COMMAND &&
1854             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1855             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1856         if (msg == WM_COMMAND &&
1857             (HIWORD(wParam) == BN_CLICKED ||
1858              HIWORD(wParam) == BN_DOUBLECLICKED)) {
1859             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_ACTION);
1860         }
1861         break;
1862       case CTRL_LISTBOX:
1863         if (msg == WM_COMMAND && ctrl->listbox.height != 0 &&
1864             (HIWORD(wParam)==LBN_SETFOCUS || HIWORD(wParam)==LBN_KILLFOCUS))
1865             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == LBN_SETFOCUS);
1866         if (msg == WM_COMMAND && ctrl->listbox.height == 0 &&
1867             (HIWORD(wParam)==CBN_SETFOCUS || HIWORD(wParam)==CBN_KILLFOCUS))
1868             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == CBN_SETFOCUS);
1869         if (msg == WM_COMMAND && id >= 2 &&
1870             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1871             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1872         if (ctrl->listbox.draglist) {
1873             int pret;
1874             pret = handle_prefslist(c->data, NULL, 0, (msg != WM_COMMAND),
1875                                     dp->hwnd, wParam, lParam);
1876             if (pret & 2)
1877                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1878             ret = pret & 1;
1879         } else {
1880             if (msg == WM_COMMAND && HIWORD(wParam) == LBN_DBLCLK) {
1881                 SetCapture(dp->hwnd);
1882                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_ACTION);
1883             } else if (msg == WM_COMMAND && HIWORD(wParam) == LBN_SELCHANGE) {
1884                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_SELCHANGE);
1885             }
1886         }
1887         break;
1888       case CTRL_FILESELECT:
1889         if (msg == WM_COMMAND && id == 1 &&
1890             (HIWORD(wParam) == EN_SETFOCUS || HIWORD(wParam) == EN_KILLFOCUS))
1891             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == EN_SETFOCUS);
1892         if (msg == WM_COMMAND && id == 2 &&
1893             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1894             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1895         if (msg == WM_COMMAND && id == 1 && HIWORD(wParam) == EN_CHANGE)
1896             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1897         if (id == 2 &&
1898             (msg == WM_COMMAND &&
1899              (HIWORD(wParam) == BN_CLICKED ||
1900               HIWORD(wParam) == BN_DOUBLECLICKED))) {
1901             OPENFILENAME of;
1902             char filename[FILENAME_MAX];
1903
1904             memset(&of, 0, sizeof(of));
1905             of.hwndOwner = dp->hwnd;
1906             if (ctrl->fileselect.filter)
1907                 of.lpstrFilter = ctrl->fileselect.filter;
1908             else
1909                 of.lpstrFilter = "All Files (*.*)\0*\0\0\0";
1910             of.lpstrCustomFilter = NULL;
1911             of.nFilterIndex = 1;
1912             of.lpstrFile = filename;
1913             GetDlgItemText(dp->hwnd, c->base_id+1, filename, lenof(filename));
1914             filename[lenof(filename)-1] = '\0';
1915             of.nMaxFile = lenof(filename);
1916             of.lpstrFileTitle = NULL;
1917             of.lpstrTitle = ctrl->fileselect.title;
1918             of.Flags = 0;
1919             if (request_file(NULL, &of, FALSE, ctrl->fileselect.for_writing)) {
1920                 SetDlgItemText(dp->hwnd, c->base_id + 1, filename);
1921                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1922             }
1923         }
1924         break;
1925       case CTRL_FONTSELECT:
1926         if (msg == WM_COMMAND && id == 2 &&
1927             (HIWORD(wParam) == BN_SETFOCUS || HIWORD(wParam) == BN_KILLFOCUS))
1928             winctrl_set_focus(ctrl, dp, HIWORD(wParam) == BN_SETFOCUS);
1929         if (id == 2 &&
1930             (msg == WM_COMMAND &&
1931              (HIWORD(wParam) == BN_CLICKED ||
1932               HIWORD(wParam) == BN_DOUBLECLICKED))) {
1933             CHOOSEFONT cf;
1934             LOGFONT lf;
1935             HDC hdc;
1936             FontSpec fs = *(FontSpec *)c->data;
1937
1938             hdc = GetDC(0);
1939             lf.lfHeight = -MulDiv(fs.height,
1940                                   GetDeviceCaps(hdc, LOGPIXELSY), 72);
1941             ReleaseDC(0, hdc);
1942             lf.lfWidth = lf.lfEscapement = lf.lfOrientation = 0;
1943             lf.lfItalic = lf.lfUnderline = lf.lfStrikeOut = 0;
1944             lf.lfWeight = (fs.isbold ? FW_BOLD : 0);
1945             lf.lfCharSet = fs.charset;
1946             lf.lfOutPrecision = OUT_DEFAULT_PRECIS;
1947             lf.lfClipPrecision = CLIP_DEFAULT_PRECIS;
1948             lf.lfQuality = DEFAULT_QUALITY;
1949             lf.lfPitchAndFamily = FIXED_PITCH | FF_DONTCARE;
1950             strncpy(lf.lfFaceName, fs.name,
1951                     sizeof(lf.lfFaceName) - 1);
1952             lf.lfFaceName[sizeof(lf.lfFaceName) - 1] = '\0';
1953
1954             cf.lStructSize = sizeof(cf);
1955             cf.hwndOwner = dp->hwnd;
1956             cf.lpLogFont = &lf;
1957             cf.Flags = CF_FIXEDPITCHONLY | CF_FORCEFONTEXIST |
1958                 CF_INITTOLOGFONTSTRUCT | CF_SCREENFONTS;
1959
1960             if (ChooseFont(&cf)) {
1961                 strncpy(fs.name, lf.lfFaceName,
1962                         sizeof(fs.name) - 1);
1963                 fs.name[sizeof(fs.name) - 1] = '\0';
1964                 fs.isbold = (lf.lfWeight == FW_BOLD);
1965                 fs.charset = lf.lfCharSet;
1966                 fs.height = cf.iPointSize / 10;
1967                 dlg_fontsel_set(ctrl, dp, fs);
1968                 ctrl->generic.handler(ctrl, dp, dp->data, EVENT_VALCHANGE);
1969             }
1970         }
1971         break;
1972     }
1973
1974     /*
1975      * If the above event handler has asked for a colour selector,
1976      * now is the time to generate one.
1977      */
1978     if (dp->coloursel_wanted) {
1979         static CHOOSECOLOR cc;
1980         static DWORD custom[16] = { 0 };    /* zero initialisers */
1981         cc.lStructSize = sizeof(cc);
1982         cc.hwndOwner = dp->hwnd;
1983         cc.hInstance = (HWND) hinst;
1984         cc.lpCustColors = custom;
1985         cc.rgbResult = RGB(dp->coloursel_result.r,
1986                            dp->coloursel_result.g,
1987                            dp->coloursel_result.b);
1988         cc.Flags = CC_FULLOPEN | CC_RGBINIT;
1989         if (ChooseColor(&cc)) {
1990             dp->coloursel_result.r =
1991                 (unsigned char) (cc.rgbResult & 0xFF);
1992             dp->coloursel_result.g =
1993                 (unsigned char) (cc.rgbResult >> 8) & 0xFF;
1994             dp->coloursel_result.b =
1995                 (unsigned char) (cc.rgbResult >> 16) & 0xFF;
1996             dp->coloursel_result.ok = TRUE;
1997         } else
1998             dp->coloursel_result.ok = FALSE;
1999         ctrl->generic.handler(ctrl, dp, dp->data, EVENT_CALLBACK);
2000     }
2001
2002     return ret;
2003 }
2004
2005 /*
2006  * This function can be called to produce context help on a
2007  * control. Returns TRUE if it has actually launched WinHelp.
2008  */
2009 int winctrl_context_help(struct dlgparam *dp, HWND hwnd, int id)
2010 {
2011     int i;
2012     struct winctrl *c;
2013     char *cmd;
2014
2015     /*
2016      * Look up the control ID in our data.
2017      */
2018     c = NULL;
2019     for (i = 0; i < dp->nctrltrees; i++) {
2020         c = winctrl_findbyid(dp->controltrees[i], id);
2021         if (c)
2022             break;
2023     }
2024     if (!c)
2025         return 0;                      /* we have nothing to do */
2026
2027     /*
2028      * This is the Windows front end, so we're allowed to assume
2029      * `helpctx.p' is a context string.
2030      */
2031     if (!c->ctrl || !c->ctrl->generic.helpctx.p)
2032         return 0;                      /* no help available for this ctrl */
2033
2034     cmd = dupprintf("JI(`',`%s')", c->ctrl->generic.helpctx.p);
2035     WinHelp(hwnd, help_path, HELP_COMMAND, (DWORD)cmd);
2036     sfree(cmd);
2037     return 1;
2038 }
2039
2040 /*
2041  * Now the various functions that the platform-independent
2042  * mechanism can call to access the dialog box entries.
2043  */
2044
2045 static struct winctrl *dlg_findbyctrl(struct dlgparam *dp, union control *ctrl)
2046 {
2047     int i;
2048
2049     for (i = 0; i < dp->nctrltrees; i++) {
2050         struct winctrl *c = winctrl_findbyctrl(dp->controltrees[i], ctrl);
2051         if (c)
2052             return c;
2053     }
2054     return NULL;
2055 }
2056
2057 void dlg_radiobutton_set(union control *ctrl, void *dlg, int whichbutton)
2058 {
2059     struct dlgparam *dp = (struct dlgparam *)dlg;
2060     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2061     assert(c && c->ctrl->generic.type == CTRL_RADIO);
2062     CheckRadioButton(dp->hwnd,
2063                      c->base_id + 1,
2064                      c->base_id + c->ctrl->radio.nbuttons,
2065                      c->base_id + 1 + whichbutton);
2066 }
2067
2068 int dlg_radiobutton_get(union control *ctrl, void *dlg)
2069 {
2070     struct dlgparam *dp = (struct dlgparam *)dlg;
2071     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2072     int i;
2073     assert(c && c->ctrl->generic.type == CTRL_RADIO);
2074     for (i = 0; i < c->ctrl->radio.nbuttons; i++)
2075         if (IsDlgButtonChecked(dp->hwnd, c->base_id + 1 + i))
2076             return i;
2077     assert(!"No radio button was checked?!");
2078     return 0;
2079 }
2080
2081 void dlg_checkbox_set(union control *ctrl, void *dlg, int checked)
2082 {
2083     struct dlgparam *dp = (struct dlgparam *)dlg;
2084     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2085     assert(c && c->ctrl->generic.type == CTRL_CHECKBOX);
2086     CheckDlgButton(dp->hwnd, c->base_id, (checked != 0));
2087 }
2088
2089 int dlg_checkbox_get(union control *ctrl, void *dlg)
2090 {
2091     struct dlgparam *dp = (struct dlgparam *)dlg;
2092     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2093     assert(c && c->ctrl->generic.type == CTRL_CHECKBOX);
2094     return 0 != IsDlgButtonChecked(dp->hwnd, c->base_id);
2095 }
2096
2097 void dlg_editbox_set(union control *ctrl, void *dlg, char const *text)
2098 {
2099     struct dlgparam *dp = (struct dlgparam *)dlg;
2100     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2101     assert(c && c->ctrl->generic.type == CTRL_EDITBOX);
2102     SetDlgItemText(dp->hwnd, c->base_id+1, text);
2103 }
2104
2105 void dlg_editbox_get(union control *ctrl, void *dlg, char *buffer, int length)
2106 {
2107     struct dlgparam *dp = (struct dlgparam *)dlg;
2108     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2109     assert(c && c->ctrl->generic.type == CTRL_EDITBOX);
2110     GetDlgItemText(dp->hwnd, c->base_id+1, buffer, length);
2111     buffer[length-1] = '\0';
2112 }
2113
2114 /* The `listbox' functions can also apply to combo boxes. */
2115 void dlg_listbox_clear(union control *ctrl, void *dlg)
2116 {
2117     struct dlgparam *dp = (struct dlgparam *)dlg;
2118     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2119     int msg;
2120     assert(c &&
2121            (c->ctrl->generic.type == CTRL_LISTBOX ||
2122             (c->ctrl->generic.type == CTRL_EDITBOX &&
2123              c->ctrl->editbox.has_list)));
2124     msg = (c->ctrl->generic.type==CTRL_LISTBOX && c->ctrl->listbox.height!=0 ?
2125            LB_RESETCONTENT : CB_RESETCONTENT);
2126     SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, 0, 0);
2127 }
2128
2129 void dlg_listbox_del(union control *ctrl, void *dlg, int index)
2130 {
2131     struct dlgparam *dp = (struct dlgparam *)dlg;
2132     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2133     int msg;
2134     assert(c &&
2135            (c->ctrl->generic.type == CTRL_LISTBOX ||
2136             (c->ctrl->generic.type == CTRL_EDITBOX &&
2137              c->ctrl->editbox.has_list)));
2138     msg = (c->ctrl->generic.type==CTRL_LISTBOX && c->ctrl->listbox.height!=0 ?
2139            LB_DELETESTRING : CB_DELETESTRING);
2140     SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, index, 0);
2141 }
2142
2143 void dlg_listbox_add(union control *ctrl, void *dlg, char const *text)
2144 {
2145     struct dlgparam *dp = (struct dlgparam *)dlg;
2146     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2147     int msg;
2148     assert(c &&
2149            (c->ctrl->generic.type == CTRL_LISTBOX ||
2150             (c->ctrl->generic.type == CTRL_EDITBOX &&
2151              c->ctrl->editbox.has_list)));
2152     msg = (c->ctrl->generic.type==CTRL_LISTBOX && c->ctrl->listbox.height!=0 ?
2153            LB_ADDSTRING : CB_ADDSTRING);
2154     SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, 0, (LPARAM)text);
2155 }
2156
2157 /*
2158  * Each listbox entry may have a numeric id associated with it.
2159  * Note that some front ends only permit a string to be stored at
2160  * each position, which means that _if_ you put two identical
2161  * strings in any listbox then you MUST not assign them different
2162  * IDs and expect to get meaningful results back.
2163  */
2164 void dlg_listbox_addwithid(union control *ctrl, void *dlg,
2165                            char const *text, int id)
2166 {
2167     struct dlgparam *dp = (struct dlgparam *)dlg;
2168     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2169     int msg, msg2, index;
2170     assert(c &&
2171            (c->ctrl->generic.type == CTRL_LISTBOX ||
2172             (c->ctrl->generic.type == CTRL_EDITBOX &&
2173              c->ctrl->editbox.has_list)));
2174     msg = (c->ctrl->generic.type==CTRL_LISTBOX && c->ctrl->listbox.height!=0 ?
2175            LB_ADDSTRING : CB_ADDSTRING);
2176     msg2 = (c->ctrl->generic.type==CTRL_LISTBOX && c->ctrl->listbox.height!=0 ?
2177            LB_SETITEMDATA : CB_SETITEMDATA);
2178     index = SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, 0, (LPARAM)text);
2179     SendDlgItemMessage(dp->hwnd, c->base_id+1, msg2, index, (LPARAM)id);
2180 }
2181
2182 int dlg_listbox_getid(union control *ctrl, void *dlg, int index)
2183 {
2184     struct dlgparam *dp = (struct dlgparam *)dlg;
2185     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2186     int msg;
2187     assert(c && c->ctrl->generic.type == CTRL_LISTBOX);
2188     msg = (c->ctrl->listbox.height != 0 ? LB_GETITEMDATA : CB_GETITEMDATA);
2189     return
2190         SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, index, 0);
2191 }
2192
2193 /* dlg_listbox_index returns <0 if no single element is selected. */
2194 int dlg_listbox_index(union control *ctrl, void *dlg)
2195 {
2196     struct dlgparam *dp = (struct dlgparam *)dlg;
2197     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2198     int msg, ret;
2199     assert(c && c->ctrl->generic.type == CTRL_LISTBOX &&
2200            !c->ctrl->listbox.multisel);
2201     msg = (c->ctrl->listbox.height != 0 ? LB_GETCURSEL : CB_GETCURSEL);
2202     ret = SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, 0, 0);
2203     if (ret == LB_ERR)
2204         return -1;
2205     else
2206         return ret;
2207 }
2208
2209 int dlg_listbox_issel(union control *ctrl, void *dlg, int index)
2210 {
2211     struct dlgparam *dp = (struct dlgparam *)dlg;
2212     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2213     assert(c && c->ctrl->generic.type == CTRL_LISTBOX &&
2214            c->ctrl->listbox.multisel &&
2215            c->ctrl->listbox.height != 0);
2216     return
2217         SendDlgItemMessage(dp->hwnd, c->base_id+1, LB_GETSEL, index, 0);
2218 }
2219
2220 void dlg_listbox_select(union control *ctrl, void *dlg, int index)
2221 {
2222     struct dlgparam *dp = (struct dlgparam *)dlg;
2223     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2224     int msg;
2225     assert(c && c->ctrl->generic.type == CTRL_LISTBOX &&
2226            !c->ctrl->listbox.multisel);
2227     msg = (c->ctrl->listbox.height != 0 ? LB_SETCURSEL : CB_SETCURSEL);
2228     SendDlgItemMessage(dp->hwnd, c->base_id+1, msg, index, 0);
2229 }
2230
2231 void dlg_text_set(union control *ctrl, void *dlg, char const *text)
2232 {
2233     struct dlgparam *dp = (struct dlgparam *)dlg;
2234     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2235     assert(c && c->ctrl->generic.type == CTRL_TEXT);
2236     SetDlgItemText(dp->hwnd, c->base_id, text);
2237 }
2238
2239 void dlg_filesel_set(union control *ctrl, void *dlg, Filename fn)
2240 {
2241     struct dlgparam *dp = (struct dlgparam *)dlg;
2242     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2243     assert(c && c->ctrl->generic.type == CTRL_FILESELECT);
2244     SetDlgItemText(dp->hwnd, c->base_id+1, fn.path);
2245 }
2246
2247 void dlg_filesel_get(union control *ctrl, void *dlg, Filename *fn)
2248 {
2249     struct dlgparam *dp = (struct dlgparam *)dlg;
2250     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2251     assert(c && c->ctrl->generic.type == CTRL_FILESELECT);
2252     GetDlgItemText(dp->hwnd, c->base_id+1, fn->path, lenof(fn->path));
2253     fn->path[lenof(fn->path)-1] = '\0';
2254 }
2255
2256 void dlg_fontsel_set(union control *ctrl, void *dlg, FontSpec fs)
2257 {
2258     char *buf, *boldstr;
2259     struct dlgparam *dp = (struct dlgparam *)dlg;
2260     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2261     assert(c && c->ctrl->generic.type == CTRL_FONTSELECT);
2262
2263     *(FontSpec *)c->data = fs;         /* structure copy */
2264
2265     boldstr = (fs.isbold ? "bold, " : "");
2266     if (fs.height == 0)
2267         buf = dupprintf("Font: %s, %sdefault height", fs.name, boldstr);
2268     else
2269         buf = dupprintf("Font: %s, %s%d-%s", fs.name, boldstr,
2270                         (fs.height < 0 ? -fs.height : fs.height),
2271                         (fs.height < 0 ? "pixel" : "point"));
2272     SetDlgItemText(dp->hwnd, c->base_id+1, buf);
2273     sfree(buf);
2274 }
2275
2276 void dlg_fontsel_get(union control *ctrl, void *dlg, FontSpec *fs)
2277 {
2278     struct dlgparam *dp = (struct dlgparam *)dlg;
2279     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2280     assert(c && c->ctrl->generic.type == CTRL_FONTSELECT);
2281     *fs = *(FontSpec *)c->data;        /* structure copy */
2282 }
2283
2284 /*
2285  * Bracketing a large set of updates in these two functions will
2286  * cause the front end (if possible) to delay updating the screen
2287  * until it's all complete, thus avoiding flicker.
2288  */
2289 void dlg_update_start(union control *ctrl, void *dlg)
2290 {
2291     struct dlgparam *dp = (struct dlgparam *)dlg;
2292     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2293     if (c && c->ctrl->generic.type == CTRL_LISTBOX) {
2294         SendDlgItemMessage(dp->hwnd, c->base_id+1, WM_SETREDRAW, FALSE, 0);
2295     }
2296 }
2297
2298 void dlg_update_done(union control *ctrl, void *dlg)
2299 {
2300     struct dlgparam *dp = (struct dlgparam *)dlg;
2301     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2302     if (c && c->ctrl->generic.type == CTRL_LISTBOX) {
2303         HWND hw = GetDlgItem(dp->hwnd, c->base_id+1);
2304         SendMessage(hw, WM_SETREDRAW, TRUE, 0);
2305         InvalidateRect(hw, NULL, TRUE);
2306     }
2307 }
2308
2309 void dlg_set_focus(union control *ctrl, void *dlg)
2310 {
2311     struct dlgparam *dp = (struct dlgparam *)dlg;
2312     struct winctrl *c = dlg_findbyctrl(dp, ctrl);
2313     int id;
2314     HWND ctl;
2315     switch (ctrl->generic.type) {
2316       case CTRL_EDITBOX: id = c->base_id + 1; break;
2317       case CTRL_RADIO:
2318         for (id = c->base_id + ctrl->radio.nbuttons; id > 1; id--)
2319             if (IsDlgButtonChecked(dp->hwnd, id))
2320                 break;
2321         /*
2322          * In the theoretically-unlikely case that no button was
2323          * selected, id should come out of this as 1, which is a
2324          * reasonable enough choice.
2325          */
2326         break;
2327       case CTRL_CHECKBOX: id = c->base_id; break;
2328       case CTRL_BUTTON: id = c->base_id; break;
2329       case CTRL_LISTBOX: id = c->base_id + 1; break;
2330       case CTRL_FILESELECT: id = c->base_id + 1; break;
2331       case CTRL_FONTSELECT: id = c->base_id + 2; break;
2332       default: id = c->base_id; break;
2333     }
2334     ctl = GetDlgItem(dp->hwnd, id);
2335     SetFocus(ctl);
2336 }
2337
2338 /*
2339  * During event processing, you might well want to give an error
2340  * indication to the user. dlg_beep() is a quick and easy generic
2341  * error; dlg_error() puts up a message-box or equivalent.
2342  */
2343 void dlg_beep(void *dlg)
2344 {
2345     /* struct dlgparam *dp = (struct dlgparam *)dlg; */
2346     MessageBeep(0);
2347 }
2348
2349 void dlg_error_msg(void *dlg, char *msg)
2350 {
2351     struct dlgparam *dp = (struct dlgparam *)dlg;
2352     MessageBox(dp->hwnd, msg,
2353                dp->errtitle ? dp->errtitle : NULL,
2354                MB_OK | MB_ICONERROR);
2355 }
2356
2357 /*
2358  * This function signals to the front end that the dialog's
2359  * processing is completed, and passes an integer value (typically
2360  * a success status).
2361  */
2362 void dlg_end(void *dlg, int value)
2363 {
2364     struct dlgparam *dp = (struct dlgparam *)dlg;
2365     dp->ended = TRUE;
2366     dp->endresult = value;
2367 }
2368
2369 void dlg_refresh(union control *ctrl, void *dlg)
2370 {
2371     struct dlgparam *dp = (struct dlgparam *)dlg;
2372     int i, j;
2373     struct winctrl *c;
2374
2375     if (!ctrl) {
2376         /*
2377          * Send EVENT_REFRESH to absolutely everything.
2378          */
2379         for (j = 0; j < dp->nctrltrees; j++) {
2380             for (i = 0;
2381                  (c = winctrl_findbyindex(dp->controltrees[j], i)) != NULL;
2382                  i++) {
2383                 if (c->ctrl && c->ctrl->generic.handler != NULL)
2384                     c->ctrl->generic.handler(c->ctrl, dp,
2385                                              dp->data, EVENT_REFRESH);
2386             }
2387         }
2388     } else {
2389         /*
2390          * Send EVENT_REFRESH to a specific control.
2391          */
2392         if (ctrl->generic.handler != NULL)
2393             ctrl->generic.handler(ctrl, dp, dp->data, EVENT_REFRESH);
2394     }
2395 }
2396
2397 void dlg_coloursel_start(union control *ctrl, void *dlg, int r, int g, int b)
2398 {
2399     struct dlgparam *dp = (struct dlgparam *)dlg;
2400     dp->coloursel_wanted = TRUE;
2401     dp->coloursel_result.r = r;
2402     dp->coloursel_result.g = g;
2403     dp->coloursel_result.b = b;
2404 }
2405
2406 int dlg_coloursel_results(union control *ctrl, void *dlg,
2407                           int *r, int *g, int *b)
2408 {
2409     struct dlgparam *dp = (struct dlgparam *)dlg;
2410     if (dp->coloursel_result.ok) {
2411         *r = dp->coloursel_result.r;
2412         *g = dp->coloursel_result.g;
2413         *b = dp->coloursel_result.b;
2414         return 1;
2415     } else
2416         return 0;
2417 }
2418
2419 struct perctrl_privdata {
2420     union control *ctrl;
2421     void *data;
2422     int needs_free;
2423 };
2424
2425 static int perctrl_privdata_cmp(void *av, void *bv)
2426 {
2427     struct perctrl_privdata *a = (struct perctrl_privdata *)av;
2428     struct perctrl_privdata *b = (struct perctrl_privdata *)bv;
2429     if (a->ctrl < b->ctrl)
2430         return -1;
2431     else if (a->ctrl > b->ctrl)
2432         return +1;
2433     return 0;
2434 }
2435
2436 void dp_init(struct dlgparam *dp)
2437 {
2438     dp->nctrltrees = 0;
2439     dp->data = NULL;
2440     dp->ended = FALSE;
2441     dp->focused = dp->lastfocused = NULL;
2442     memset(dp->shortcuts, 0, sizeof(dp->shortcuts));
2443     dp->hwnd = NULL;
2444     dp->wintitle = dp->errtitle = NULL;
2445     dp->privdata = newtree234(perctrl_privdata_cmp);
2446 }
2447
2448 void dp_add_tree(struct dlgparam *dp, struct winctrls *wc)
2449 {
2450     assert(dp->nctrltrees < lenof(dp->controltrees));
2451     dp->controltrees[dp->nctrltrees++] = wc;
2452 }
2453
2454 void dp_cleanup(struct dlgparam *dp)
2455 {
2456     struct perctrl_privdata *p;
2457
2458     if (dp->privdata) {
2459         while ( (p = index234(dp->privdata, 0)) != NULL ) {
2460             del234(dp->privdata, p);
2461             if (p->needs_free)
2462                 sfree(p->data);
2463             sfree(p);
2464         }
2465         freetree234(dp->privdata);
2466         dp->privdata = NULL;
2467     }
2468     sfree(dp->wintitle);
2469     sfree(dp->errtitle);
2470 }
2471
2472 void *dlg_get_privdata(union control *ctrl, void *dlg)
2473 {
2474     struct dlgparam *dp = (struct dlgparam *)dlg;
2475     struct perctrl_privdata tmp, *p;
2476     tmp.ctrl = ctrl;
2477     p = find234(dp->privdata, &tmp, NULL);
2478     if (p)
2479         return p->data;
2480     else
2481         return NULL;
2482 }
2483
2484 void dlg_set_privdata(union control *ctrl, void *dlg, void *ptr)
2485 {
2486     struct dlgparam *dp = (struct dlgparam *)dlg;
2487     struct perctrl_privdata tmp, *p;
2488     tmp.ctrl = ctrl;
2489     p = find234(dp->privdata, &tmp, NULL);
2490     if (!p) {
2491         p = snew(struct perctrl_privdata);
2492         p->ctrl = ctrl;
2493         p->needs_free = FALSE;
2494         add234(dp->privdata, p);
2495     }
2496     p->data = ptr;
2497 }
2498
2499 void *dlg_alloc_privdata(union control *ctrl, void *dlg, size_t size)
2500 {
2501     struct dlgparam *dp = (struct dlgparam *)dlg;
2502     struct perctrl_privdata tmp, *p;
2503     tmp.ctrl = ctrl;
2504     p = find234(dp->privdata, &tmp, NULL);
2505     if (!p) {
2506         p = snew(struct perctrl_privdata);
2507         p->ctrl = ctrl;
2508         p->needs_free = FALSE;
2509         add234(dp->privdata, p);
2510     }
2511     assert(!p->needs_free);
2512     p->needs_free = TRUE;
2513     /*
2514      * This is an internal allocation routine, so it's allowed to
2515      * use smalloc directly.
2516      */
2517     p->data = smalloc(size);
2518     return p->data;
2519 }