Changeset 1673 for trunk/dll/mainwnd.c


Ignore:
Timestamp:
Dec 30, 2012, 7:51:01 PM (13 years ago)
Author:
Gregg Young
Message:

Update to Doxygen comment style Ticket 55. Also some minor code cleanup.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/dll/mainwnd.c

    r1672 r1673  
    262262  case UM_SETUP4:
    263263  case UM_SETUP5:
    264     /*
    265      * feed setup messages to main window
    266      */
     264    // feed setup messages to main window
    267265    PostMsg(hwndMain, msg, mp1, mp2);
    268266    return 0;
    269267
    270268  case UM_SETUP6:
    271     /*
    272      * handle bubble help requests from drive bar buttons
    273      */
     269    // handle bubble help requests from drive bar buttons
    274270    {
    275271      char dv[3], d;
    … …  
    365361
    366362  case UM_NOTIFY:
    367     /*
    368      * bring up notify messages for various windows
    369      */
     363    // bring up notify messages for various windows
    370364    if (mp1)
    371365      return MRFROMLONG(DoNotify((char *)mp1));
    … …  
    600594  noattrib &= (~(SWP_SHOW | SWP_ZORDER));
    601595  noattrib |= SWP_HIDE;
    602   /* count tools */
     596  // count tools
    603597  tool = toolhead;
    604598  for (numtools = 0L; tool; numtools++)
    605599    tool = tool->next;
    606   /* allocate swp array for WinSetMultWindowPos */
     600  // allocate swp array for WinSetMultWindowPos
    607601  swp = xmallocz(sizeof(SWP) * (numtools + 2), pszSrcFile, __LINE__);
    608602  if (swp) {
    … …  
    995989    hwndActive = WinQueryActiveWindow(HWND_DESKTOP);
    996990    if (hwndActive) {
    997       /* don't bring up help if window isn't active */
     991      // don't bring up help if window isn't active
    998992      if (!WinIsChild(hwnd, hwndActive))
    999993        return;
    … …  
    1001995    hwndActive = WinQueryFocus(HWND_DESKTOP);
    1002996    if (WinQueryClassName(hwndActive, sizeof(ucClassname), ucClassname)) {
    1003       /* don't bring up help if a menu is active */
     997      // don't bring up help if a menu is active
    1004998      if (!strcmp(ucClassname, "#4"))
    1005999        return;
    … …  
    13431337      break;
    13441338
    1345     case IDM_HIDEANYTOOL:               /* hide any tool */
    1346     case IDM_HIDETOOL:                  /* hide tool */
     1339    case IDM_HIDEANYTOOL:               // hide any tool
     1340    case IDM_HIDETOOL:                  // hide tool
    13471341      if (SHORT1FROMMP(mp1) == IDM_HIDETOOL)
    13481342        id = WinQueryWindowUShort(hwnd, QWS_ID);
    … …  
    13601354      break;
    13611355
    1362     case IDM_SHOWTOOLS:                 /* show all tools */
     1356    case IDM_SHOWTOOLS:                 // show all tools
    13631357      tool = toolhead;
    13641358      while (tool) {
    … …  
    13691363      break;
    13701364
    1371     case IDM_DELETEANYTOOL:             /* delete any button */
    1372     case IDM_DELETETOOL:                /* delete button */
     1365    case IDM_DELETEANYTOOL:             // delete any button
     1366    case IDM_DELETETOOL:                // delete button
    13731367      if (SHORT1FROMMP(mp1) == IDM_DELETETOOL)
    13741368        id = WinQueryWindowUShort(hwnd, QWS_ID);
    … …  
    13821376      return 0;
    13831377
    1384     case IDM_EDITANYTOOL:               /* edit any button */
    1385     case IDM_EDITTOOL:                  /* edit button */
     1378    case IDM_EDITANYTOOL:               // edit any button
     1379    case IDM_EDITTOOL:                  // edit button
    13861380      if (SHORT1FROMMP(mp1) == IDM_EDITTOOL)
    13871381        id = WinQueryWindowUShort(hwnd, QWS_ID);
    … …  
    14041398      break;
    14051399
    1406     case IDM_ADDTOOL:                   /* add tool */
     1400    case IDM_ADDTOOL:                   // add tool
    14071401      id = (USHORT) WinDlgBox(HWND_DESKTOP, hwnd, AddToolProc, FM3ModHandle,
    14081402                              ADDBTN_FRAME, MPVOID);
    … …  
    14151409      break;
    14161410
    1417     case IDM_REORDERTOOLS:              /* reorder tools */
     1411    case IDM_REORDERTOOLS:              // reorder tools
    14181412      WinDlgBox(HWND_DESKTOP,
    14191413                hwnd, ReOrderToolsProc, FM3ModHandle, RE_FRAME, MPVOID);
    … …  
    14431437
    14441438  case WM_CONTEXTMENU:
    1445     //DosEnterCritSec(); //GKY 11-29-08
    14461439    DosRequestMutexSem(hmtxFM2Globals, SEM_INDEFINITE_WAIT);
    14471440    if (!hwndMenu)
    14481441      hwndMenu = WinLoadMenu(hwnd, FM3ModHandle, ID_BUTTONMENU);
    14491442    DosReleaseMutexSem(hmtxFM2Globals);
    1450     //DosExitCritSec();
    14511443    //fixme to allow user to change font 1-10-09 GKY
    14521444    SetPresParams(hwndMenu, NULL, NULL, NULL, FNT_10SYSTEMPROPORT);
    … …  
    14571449  case DM_DRAGOVER:
    14581450    {
    1459       PDRAGINFO pDInfo;                 /* Pointer to DRAGINFO */
    1460 
    1461       pDInfo = (PDRAGINFO) mp1;         /* Get DRAGINFO pointer */
    1462       DrgAccessDraginfo(pDInfo);        /* Access DRAGINFO */
     1451      PDRAGINFO pDInfo;                 // Pointer to DRAGINFO
     1452
     1453      pDInfo = (PDRAGINFO) mp1;         // Get DRAGINFO pointer
     1454      DrgAccessDraginfo(pDInfo);        // Access DRAGINFO
    14631455      id = WinQueryWindowUShort(hwnd, QWS_ID);
    14641456      tool = find_tool(id);
    14651457      if (!tool) {
    14661458        DrgFreeDraginfo(pDInfo);
    1467         return (MRFROM2SHORT(DOR_NEVERDROP, 0));        /* Drop not valid */
     1459        return (MRFROM2SHORT(DOR_NEVERDROP, 0));        // Drop not valid
    14681460      }
    14691461      if (!(tool->flags & T_DROPABLE)) {
    14701462        DrgFreeDraginfo(pDInfo);
    1471         return (MRFROM2SHORT(DOR_NEVERDROP, 0));        /* Drop not valid */
     1463        return (MRFROM2SHORT(DOR_NEVERDROP, 0));        // Drop not valid
    14721464      }
    14731465      {
    1474         PDRAGITEM pDItem;               /* Pointer to DRAGITEM */
    1475 
    1476         pDItem = DrgQueryDragitemPtr(pDInfo,    /* Access DRAGITEM */
    1477                                      0);        /* Index to DRAGITEM */
    1478         if (DrgVerifyRMF(pDItem,        /* Check valid rendering */
    1479                          (CHAR *) DRM_OS2FILE,   /* mechanisms and data */
    1480                          NULL)) {       /* formats */
     1466        PDRAGITEM pDItem;               // Pointer to DRAGITEM
     1467
     1468        pDItem = DrgQueryDragitemPtr(pDInfo,    // Access DRAGITEM
     1469                                     0);        // Index to DRAGITEM
     1470        if (DrgVerifyRMF(pDItem,                // Check valid rendering
     1471                         (CHAR *) DRM_OS2FILE,  // mechanisms and data
     1472                         NULL)) {               // formats
    14811473          if (!(tool->flags & T_EMPHASIZED)) {
    14821474            tool->flags |= T_EMPHASIZED;
    … …  
    14841476            DrgFreeDraginfo(pDInfo);
    14851477          }
    1486           return (MRFROM2SHORT(DOR_DROP,        /* Return okay to drop */
    1487                                DO_MOVE));       /* Move operation valid */
     1478          return (MRFROM2SHORT(DOR_DROP,        // Return okay to drop
     1479                               DO_MOVE));       // Move operation valid
    14881480        }
    14891481        DrgFreeDraginfo(pDInfo);
    14901482      }
    14911483    }
    1492     return (MRFROM2SHORT(DOR_NEVERDROP, 0));    /* Drop not valid */
     1484    return (MRFROM2SHORT(DOR_NEVERDROP, 0));    // Drop not valid
    14931485
    14941486  case DM_DROPHELP:
    … …  
    22922284          WinEnableMenuItem(hwndMenu, IDM_CHKDSK, FALSE);
    22932285        }
    2294         /* fixme to be gone?
    2295           if (!rdy || ~driveflags[iDrv] & DRIVE_CDROM) {
    2296             WinEnableMenuItem(hwndMenu, IDM_CLOSETRAY, FALSE);
    2297           }
    2298         */
    22992286        PopupMenu(hwnd, hwnd, hwndMenu);
    23002287      }
    … …  
    29822969    return 0;
    29832970
    2984   case UM_SETUP2:  /* Used to load a new a toolbar */
     2971  case UM_SETUP2:  // Used to load a new a toolbar
    29852972    BuildTools(hwnd, TRUE);
    29862973    return 0;
    … …  
    31993186BOOL CloseDirCnrChildren(HWND hwndClient)
    32003187{
    3201   /* returns TRUE if a directory container window was told to close */
     3188  // returns TRUE if a directory container window was told to close
    32023189
    32033190  HENUM henum;
    … …  
    36803667    if (ulCnt == (ULONG) - 1) {
    36813668      ulCnt = CountChildren(hwndClient, &ulNumMinChildren);
    3682       /* return these values to the caller for later use */
     3669      // return these values to the caller for later use
    36833670      *ulCntR = ulCnt;
    36843671      *ulNumMinChildrenR = ulNumMinChildren;
    … …  
    38973884                           SHORT newcx, SHORT newcy)
    38983885{
    3899   /*
     3886  /**
    39003887   * resize all children of the client to maintain their proportional
    39013888   * sizes and positions
    … …  
    42374224      mr = oldproc(hwnd, msg, mp1, mp2);
    42384225
    4239       /*
     4226      /**
    42404227       * Calculate the position of the client rectangle.
    42414228       * Otherwise, we'll see a lot of redraw when we move the
    … …  
    43164303      soldCount = sCount;
    43174304
    4318       /*
     4305      /**
    43194306       * Reformat the frame to "squeeze" the client
    43204307       * and make room for status window sibling beneath
    … …  
    56605647    hwndFrame = WinQueryWindow(hwnd, QW_PARENT);
    56615648
    5662     /*
    5663      * create frame children (not client children, frame children)
    5664      */
     5649    // create frame children (not client children, frame children)
    56655650    DosSleep(1);
    56665651    WinQueryWindowPos(hwndFrame, &swp);
    … …  
    59325917
    59335918  case UM_SETUP:
    5934     /*
    5935      * start up some initial children
    5936      */
     5919    // start up some initial children
    59375920    WinShowWindow(WinQueryWindow(hwnd, QW_PARENT), TRUE);
    59385921    PostMsg(MainObjectHwnd, UM_SETUP2, mp1, mp2);
    … …  
    59945977
    59955978  case UM_SETUP3:
    5996     /* start remaining child windows */
     5979    // start remaining child windows
    59975980    if (!fNoSaveState && fSaveState) {
    59985981      PCSZ pszStatename = PCSZ_SHUTDOWNSTATE;
    … …  
    61906173
    61916174    case IDM_WINDOWSMENU:
    6192       /*
     6175      /**
    61936176       * add child windows of client
    61946177       * and switchlist entries to end of pulldown menu
    … …  
    66416624
    66426625  case UM_SETDIR:
    6643     /* mp1 == name of directory to open */
     6626    // mp1 == name of directory to open
    66446627    if (mp1)
    66456628      return MRFROMLONG(OpenDirCnr((HWND) 0,
Note: See TracChangeset for help on using the changeset viewer.