Changeset 80

Timestamp:

Jun 4, 2001, 9:13:58 AM (24 years ago)

Author:

umoeller

Message:

Final sources for 0.9.12 release.

File:

• trunk/src/helpers/dialog.c (modified) (15 diffs)

trunk/src/helpers/dialog.c

@@ -957 +957 @@
 /*
  *@@ dlghCreateDlg:
- *      replacement for WinCreateDlg for creating a dialog
- *      from a settings array in memory, which is formatted
- *      automatically.
+ *      replacement for WinCreateDlg/WinLoadDlg for creating a
+ *      dialog from a settings array in memory, which is
+ *      formatted automatically.
  *
  *      This does NOT use regular dialog templates from
@@ -977 +977 @@
  *      Like WinLoadDlg, this creates a standard WC_FRAME and
  *      subclasses it with fnwpMyDlgProc. It then sends WM_INITDLG
- *      to the dialog with pCreateParams in mp2. You can use
- *      WinProcessDlg as usual. In your dlg proc, use WinDefDlgProc
- *      as usual.
+ *      to the dialog with pCreateParams in mp2.
+ *
+ *      If this func returns no error, you can then use
+ *      WinProcessDlg with the newly created dialog as usual. In
+ *      your dlg proc, use WinDefDlgProc as usual.
  *
  *      There is NO run-time overhead after creation; after this
@@ -994 +996 @@
  *      at compile time.
  *
+ *      Essentially, such a dialog item operates similarly to
+ *      HTML tables. There are rows and columns in the table,
+ *      and each control which is specified must be a column
+ *      in some table. Tables may also nest (see below).
+ *
  *      The macros are:
  *
@@ -999 +1006 @@
  *          but must each be properly terminated with END_TABLE.
  *
- *      --  START_ROW(fl) starts a new row in a table.
+ *      --  START_GROUP_TABLE(pDef) starts a group. This
+ *          behaves exacly like START_TABLE, but in addition,
+ *          it produces a static group control around the table.
+ *          Useful for group boxes. pDef must point to a
+ *          _CONTROLDEF describing the control to be used for
+ *          the group (usually a WC_STATIC with SS_GROUP style),
+ *          whose size parameter is ignored.
+ *
+ *          As with START_TABLE, START_GROUP_TABLE must be
+ *          terminated with END_TABLE.
+ *
+ *      --  START_ROW(fl) starts a new row in a table (regular
+ *          or group). This must also be the first item after
+ *          the (group) table tag.
  *
  *          fl specifies formatting flags for the row. This
  *          can be one of ROW_VALIGN_BOTTOM, ROW_VALIGN_CENTER,
  *          ROW_VALIGN_TOP and affects all items in the control.
- *
- *      --  START_GROUP_TABLE(pDef) starts a group. This
- *          behaves exacly like START_TABLE, but in addition,
- *          it produces a control around the table. Useful
- *          for group boxes. pDef must point to a _CONTROLDEF,
- *          whose size parameter is ignored.
- *
- *          This must also be terminated with END_TABLE.
  *
  *      --  CONTROL_DEF(pDef) defines a control in a table row.
@@ -1021 +1033 @@
  *          Instead, the structure only contains the _size_
  *          of the control. All positions are computed by
- *          this function, depending on the position of the
- *          control and its nesting within the various tables.
+ *          this function, depending on the sizes of the
+ *          controls and their nesting within the various tables.
  *
  *          If you specify SZL_AUTOSIZE, the size of the
  *          control is even computed automatically. Presently,
- *          this only works for statics with SS_TEXT and
- *          SS_BITMAP.
- *
- *          Unless separated with TYPE_START_NEW_ROW items,
- *          subsequent control items will be considered
- *          to be in the same row (== positioned next to
- *          each other).
+ *          this only works for statics with SS_TEXT, SS_ICON,
+ *          and SS_BITMAP.
+ *
+ *          Unless separated with START_ROW items, subsequent
+ *          control items will be considered to be in the same
+ *          row (== positioned next to each other).
  *
  *      There are a few rules, whose violation will produce
@@ -1075 +1086 @@
  +          DLGHITEM DlgTemplate[] =
  +              {
- +                  START_TABLE,            // root table, must exist
- +                      START_ROW(0),       // row 1 in the root table
+ +                  START_TABLE,            // root table, required
+ +                      START_ROW(0),       // row 1 in the root table, required
  +                          // create group on top
  +      (1)                 START_GROUP_TABLE(&Group),
@@ -1153 +1164 @@
  +                                        fnwpMyDlgProc,
  +                                        "My Dlg Title",
- +                                        G_aMyDialogTemplate,
- +                                        ARRAYITEMSIZE(G_aMyDialogTemplate),
+ +                                        DlgTemplate,      // DLGHITEM array
+ +                                        ARRAYITEMSIZE(DlgTemplate),
  +                                        NULL))
  +          {
- +              ULONG idReturn = WinProcessDlg(pDlgData->hwndDlg);
+ +              ULONG idReturn = WinProcessDlg(hwndDlg);
  +              WinDestroyWindow(hwndDlg);
  +          }
@@ -1378 +1389 @@
         else
         {
+            HWND    hwndDlg = pDlgData->hwndDlg;
             SIZEL   szlClient = {0};
             RECTL   rclClient;
@@ -1383 +1395 @@
 
             /*
-             *  3) compute size of client after computing all control sizes
+             *  3) compute size of all controls
              *
              */
@@ -1394 +1406 @@
                 WinReleasePS(pDlgData->hps);
 
-            WinSubclassWindow(pDlgData->hwndDlg, pfnwpDialogProc);
+            /*
+             *  4) compute size of dialog client from total
+             *     size of all controls
+             */
+
+            WinSubclassWindow(hwndDlg, pfnwpDialogProc);
 
             // calculate the frame size from the client size
@@ -1401 +1418 @@
             rclClient.xRight = szlClient.cx + 2 * SPACING;
             rclClient.yTop = szlClient.cy + 2 * SPACING;
-            WinCalcFrameRect(pDlgData->hwndDlg,
+            WinCalcFrameRect(hwndDlg,
                              &rclClient,
                              FALSE);            // frame from client
 
-            WinSetWindowPos(pDlgData->hwndDlg,
+            WinSetWindowPos(hwndDlg,
                             0,
                             10,
@@ -1414 +1431 @@
 
             /*
-             *  4) compute positions of all controls
+             *  5) compute _positions_ of all controls
              *
              */
@@ -1423 +1440 @@
 
             /*
-             *  5) create control windows, finally
+             *  6) create control windows, finally
              *
              */
@@ -1435 +1452 @@
 
             /*
-             *  6) WM_INITDLG, set focus
+             *  7) WM_INITDLG, set focus
              *
              */
@@ -1441 +1458 @@
             hwndFocusItem = (pDlgData->hwndFirstFocus)
                                     ? pDlgData->hwndFirstFocus
-                                    : pDlgData->hwndDlg;
-            if (!WinSendMsg(pDlgData->hwndDlg,
+                                    : hwndDlg;
+            if (!WinSendMsg(hwndDlg,
                             WM_INITDLG,
                             (MPARAM)hwndFocusItem,