Changeset 19 for trunk/src/helpers/cctl_tooltip.c

Timestamp:

Jan 3, 2001, 10:05:57 PM (25 years ago)

Author:

umoeller

Message:

Reworked tooltip.

File:

• trunk/src/helpers/cctl_tooltip.c (modified) (24 diffs)

trunk/src/helpers/cctl_tooltip.c

@@ -182 +182 @@
             qmsg.mp1 = mp1;
             qmsg.mp2 = mp2;
-            /* WinQueryMsgPos(pst->hab,
-                           &qmsg.ptl);
-            qmsg.time = WinQueryMsgTime(pst->hab); */
-            // _Pmpf(("ctl_fnwpSubclassedTool: sending TTM_RELAYEVENT"));
+            _Pmpf((__FUNCTION__ ": sending TTM_RELAYEVENT"));
             WinSendMsg(pst->hwndTooltip,
                        TTM_RELAYEVENT,
@@ -194 +191 @@
 
         case WM_DESTROY:
-            mrc = (pst->pfnwpOrig)(hwndTool, msg, mp1, mp2);
             lstRemoveItem(G_pllSubclassedTools, pst);         // this frees the item
             if (lstCountItems(G_pllSubclassedTools) == 0)
@@ -201 +197 @@
                 lstFree(G_pllSubclassedTools);
                 G_pllSubclassedTools = NULL;
+                _Pmpf((__FUNCTION__ ": removed hwnd 0x%lX", hwndTool));
             }
+            mrc = (pst->pfnwpOrig)(hwndTool, msg, mp1, mp2);
         break;
 
@@ -240 +238 @@
 
             lstAppendItem(G_pllSubclassedTools, pst);
+            _Pmpf((__FUNCTION__ ": subclassed hwnd 0x%lX", hwndTool));
         }
     }
@@ -284 +283 @@
     BOOL        fIsVisible;         // TRUE if tooltip is visible
 
-    CHAR        szTextBuf[256];     // static buffer for copying/loading strings
+    // CHAR        szTextBuf[256];     // static buffer for copying/loading strings
 } TOOLTIPDATA, *PTOOLTIPDATA;
 
@@ -435 +434 @@
                     BOOL fShow)  // if TRUE: show, else: HIDE
 {
+    _Pmpf((__FUNCTION__ ": fShow %d", fShow));
     if (fShow)
     {
@@ -458 +458 @@
            )
         {
-            pttd->pszPaintText = NULL;
             // mouse not moved since timer was started:
             // find the current TOOLINFO
+            _Pmpf((__FUNCTION__ ": mouse not moved... pttd->ptiMouseOver 0x%lX", pttd->ptiMouseOver));
             if (pttd->ptiMouseOver)
             {
@@ -470 +470 @@
                            (MPARAM)0,
                            (MPARAM)&tiTemp);
-                if (tiTemp.lpszText)
-                    pttd->pszPaintText = strdup(tiTemp.lpszText);
+                if (tiTemp.pszText)
+                    pttd->pszPaintText = strdup(tiTemp.pszText);
                 else
                     pttd->pszPaintText = NULL;
             }
+
+            _Pmpf((__FUNCTION__ ": pttd->pszPaintText %s",
+                    (pttd->pszPaintText) ? pttd->pszPaintText : "NULL"));
 
             if (pttd->pszPaintText)
@@ -499 +502 @@
 
                 // calc x and y pos of tooltip
-                if (pttd->ptiMouseOver->uFlags & TTF_CENTERTIP)
+                if (    (pttd->ptiMouseOver->ulFlags & TTF_CENTERBELOW)
+                     || (pttd->ptiMouseOver->ulFlags & TTF_CENTERABOVE)
+                   )
                 {
                     // center below control:
-                    if (pttd->ptiMouseOver->uFlags & TTF_IDISHWND)
-                    {
-                        SWP swpTool;
-                        WinQueryWindowPos(pttd->ptiMouseOver->uId, &swpTool);
-                        ptlTooltip.x = swpTool.x;
-                        ptlTooltip.y = swpTool.y;
-                        // convert x, y to desktop points
-                        WinMapWindowPoints(WinQueryWindow(pttd->ptiMouseOver->uId,
-                                                          QW_PARENT), // hwndFrom
-                                           HWND_DESKTOP,            // hwndTo
-                                           &ptlTooltip,
-                                           1);
-                        ptlTooltip.x += ((swpTool.cx - cx) / 2L);
+                    SWP swpTool;
+                    WinQueryWindowPos(pttd->ptiMouseOver->hwndTool, &swpTool);
+                    ptlTooltip.x = swpTool.x;
+                    ptlTooltip.y = swpTool.y;
+                    // convert x, y to desktop points
+                    WinMapWindowPoints(WinQueryWindow(pttd->ptiMouseOver->hwndTool,
+                                                      QW_PARENT), // hwndFrom
+                                       HWND_DESKTOP,            // hwndTo
+                                       &ptlTooltip,
+                                       1);
+                    ptlTooltip.x += ((swpTool.cx - cx) / 2L);
+                    if (pttd->ptiMouseOver->ulFlags & TTF_CENTERBELOW)
                         ptlTooltip.y -= cy;
-                    }
-                    // else xxx rectangle def
+                    else
+                        ptlTooltip.y += swpTool.cy;
                 }
                 else
@@ -594 +598 @@
                                                      TOOLTIP_ID_TIMER_AUTOPOP,
                                                      pttd->ulTimeoutAutopop);
-            }
-        }
+            } // end if (pttd->pszPaintText)
+        } // end if (    (ptlPointer.x == pttd->ptlPointerLast.x)...
     } // end if (mp1)
     else
@@ -847 +851 @@
                     case TOOLTIP_ID_TIMER_INITIAL:
                         // _Pmpf(("WM_TIMER: Stopping initial timer: %d", usTimer));
+                        _Pmpf((__FUNCTION__ ": TOOLTIP_ID_TIMER_INITIAL"));
                         WinStopTimer(pttd->hab,
                                      hwndTooltip,
@@ -944 +949 @@
              *      the address of a TOOLINFO structure, which provides
              *      information the tooltip control needs to display text
-             *      for the tool. The cbSize member is required and must
-             *      specify the size of the structure.
+             *      for the tool.
              *
              *      A tooltip control supports tools implemented as windows
@@ -952 +956 @@
              *
              *      --  When you add a tool implemented as a rectangular area, the
-             *          "hwnd" member of TOOLINFO must specify the handle of the
-             *          window that contains the area, and the "rect" member must
+             *          "hwndToolOwner" member of TOOLINFO must specify the handle
+             *          of the window that contains the area, and the "rect" member must
              *          specify the client coordinates of the area's bounding
-             *          rectangle. In addition, the "uId" member must specify the
-             *          application-defined identifier for the tool.
-             *
-             *      --  When you add a tool implemented as a window, the "uId"
+             *          rectangle. ### not implemented yet
+             *
+             *      --  When you add a tool implemented as a window, the "hwndTool"
              *          member of TOOLINFO must contain the window handle of the
-             *          tool. Also, the "uFlags" member must specify the TTF_IDISHWND
-             *          value, which tells the tooltip control to interpret the "uId"
-             *          member as a window handle.
-             *
-             *      When you add a tool to a tooltip control, the "lpszText"
-             *      member of the TOOLINFO structure must specify the address
-             *      of the string to display for the tool. You can change the
-             *      text any time after adding the tool by using the
-             *      TTM_UPDATETIPTEXT message.
-             *
-             *      If the high-order word of lpszText is zero, the low-order
-             *      word must be the identifier of a string resource. When
-             *      the tooltip control needs the text, the system loads
-             *      the specified string resource from the application instance
-             *      identified by the "hinst" member of TOOLINFO.
-             *
-             *      If you specify the LPSTR_TEXTCALLBACK value in the lpszText
-             *      member, the tooltip control notifies the window specified
-             *      in the hwnd member of TOOLINFO whenever the tooltip control
-             *      needs to display text for the tool. The tooltip control
-             *      sends the TTN_NEEDTEXT notification message to the window.
+             *          tool. hwndToolOwner should be the owner of the tool.
+             *
+             *      When you add a tool to a tooltip control, the "pszText"
+             *      member of the TOOLINFO structure must specify the string
+             *      to display for the tool. You can change the text any time
+             *      after adding the tool by using the TTM_UPDATETIPTEXT message.
+             *
+             *      If you specify the PSZ_TEXTCALLBACK value in the pszText
+             *      member, whenever the tooltip control needs the text for the
+             *      tool, it sends a WM_CONTROL message to hwndToolOwner with
+             *      the TTN_NEEDTEXT notification code.
+             *
              *      The message includes the address of a TOOLTIPTEXT structure,
-             *      which contains the window handle as well as the
-             *      application-defined identifier for the tool. The window
-             *      examines the structure to determine the tool for which text
-             *      is needed, and it fills the appropriate structure members
-             *      with information that the tooltip control needs to display
-             *      the string.
-             *
-             *      Many applications create toolbars containing tools that
-             *      correspond to menu commands. For such tools, it is convenient
-             *      for the tooltip control to display the same text as the
-             *      corresponding menu item. Windows automatically strips the
-             *      ampersand (&) accelerator characters from all strings passed
-             *      to a tooltip control, unless the control has the TTS_NOPREFIX style.
-             *
-             *      OS/2 note: This implementation does this too, but will not
-             *      strip the ampersand, but the tilde (~) character.
+             *      which contains the window handle of the tool. You can then
+             *      fill the TOOLTIPTEXT structure with the tool text.
              *
              *      To retrieve the text for a tool, use the TTM_GETTEXT message.
@@ -1010 +990 @@
                     if (ptiNew)
                     {
-                        memcpy(ptiNew, ptiPassed, ptiPassed->cbSize);
+                        memcpy(ptiNew, ptiPassed, sizeof(TOOLINFO));
                         lstAppendItem(&pttd->llTools,
                                       ptiNew);
 
-                        if (ptiPassed->uFlags & TTF_IDISHWND)
-                            if (ptiPassed->uFlags & TTF_SUBCLASS)
-                                SubclassToolForToolinfo(hwndTooltip,
-                                                        ptiPassed->uId);
+                        if (ptiPassed->ulFlags & TTF_SUBCLASS)
+                            SubclassToolForToolinfo(hwndTooltip,
+                                                    ptiPassed->hwndTool);
 
                         mrc = (MPARAM)TRUE;
@@ -1046 +1025 @@
                     {
                         PTOOLINFO ptiThis = (PTOOLINFO)pToolNode->pItemData;
-                        if (    (ptiThis->hwnd == ptiSearch->hwnd)
-                             && (ptiThis->uId == ptiSearch->uId)
+                        if (    (ptiThis->hwndToolOwner == ptiSearch->hwndToolOwner)
+                             && (ptiThis->hwndTool == ptiSearch->hwndTool)
                            )
                         {
@@ -1178 +1157 @@
                     {
                         PTOOLINFO pti = (PTOOLINFO)pToolNode->pItemData;
-                        if (    (pti->uFlags &TTF_IDISHWND)
-                             && (pti->uId == pqmsg->hwnd)
-                           )
+                        if (pti->hwndTool == pqmsg->hwnd)
                         {
+                            _Pmpf((__FUNCTION__ ": found tool"));
                             pttd->ptiMouseOver = pti;
                             break;
@@ -1196 +1174 @@
                     {
                         // mouse pos changed:
+                        // hide tooltip
                         WinPostMsg(hwndTooltip,
                                    TTM_SHOWTOOLTIPNOW,
@@ -1202 +1181 @@
                         memcpy(&pttd->ptlPointerLast, &ptlPointer, sizeof(POINTL));
 
+                        _Pmpf((__FUNCTION__ ": pttd->ptiMouseOver: 0x%lX", pttd->ptiMouseOver));
+                        _Pmpf((__FUNCTION__ ": pttd->fIsActive: 0x%lX", pttd->fIsActive));
                         if (    (pttd->ptiMouseOver)
                              && (pttd->fIsActive)
@@ -1303 +1284 @@
                 PTOOLINFO pti = (PTOOLINFO)mp2;
 
-                if (pti->lpszText == LPSTR_TEXTCALLBACK)
+                if (pti->pszText == PSZ_TEXTCALLBACK)
                 {
                     // TTN_NEEDTEXT notification desired:
                     // compose values for that msg
-                    TOOLTIPTEXT     ttt;
-                    memset(&ttt, 0, sizeof(ttt));
-                    ttt.hdr.hwndFrom = hwndTooltip;
-
-                    if (pti->uFlags & TTF_IDISHWND)
-                        // HWND mode:
-                        ttt.uFlags = TTF_IDISHWND;
-                    ttt.hdr.idFrom = pti->uId;      // HWND or app-def'd ID
-                    ttt.hdr.code = TTN_NEEDTEXT;
-                    WinSendMsg(pti->hwnd,
+                    TOOLTIPTEXT ttt = {0};
+                    _Pmpf(("TTM_GETTEXT: LPSTR_TEXTCALLBACK"));
+                    ttt.hwndTooltip = hwndTooltip;
+                    ttt.hwndTool = pti->hwndTool;
+                    WinSendMsg(pti->hwndTool,
                                WM_CONTROL,
                                MPFROM2SHORT(pttd->ulTooltipID,  // tooltip control wnd ID
@@ -1324 +1300 @@
                     // in case of error: set lpszText to NULL; this
                     // is not specified in the docs however.
-                    pti->lpszText = NULL;
-
-                    if (ttt.szText[0] != 0)
+                    pti->pszText = NULL;
+
+                    switch (ttt.ulFormat)
                     {
-                        // owner copied string to ttt.szText:
-                        // copy that to our buffer in the window words
-                        // to make it static
-                        strcpy(pttd->szTextBuf, ttt.szText);    // maxlen is 80 chars
-                        pti->lpszText = pttd->szTextBuf;
-                    }
-                    else if (   (ttt.lpszText != 0)
-                             && (((ULONG)ttt.lpszText & 0xFFFF0000) != 0)
-                            )
-                        // owner specified pointer to static buffer somewhere:
-                        pti->lpszText = ttt.lpszText;
-                    else if ((ULONG)ttt.lpszText & 0xFFFF)
-                    {
-                        if (WinLoadString(pttd->hab,
-                                          ttt.hinst,
-                                          (ULONG)ttt.lpszText,
-                                          sizeof(pttd->szTextBuf),  // 256 chars
-                                          pttd->szTextBuf))
-                            pti->lpszText = pttd->szTextBuf;
+                        case TTFMT_PSZ:
+                            if (ttt.pszText)
+                                pti->pszText = ttt.pszText;
+                        break;
+
+                        case TTFMT_STRINGRES:
+                            // ### not supported yet
+                        break;
                     }
                 }
@@ -1440 +1405 @@
                     if (ptiFound)
                     {
-                        memcpy(ptiTarget, ptiFound, ptiTarget->cbSize);
+                        memcpy(ptiTarget, ptiFound, sizeof(TOOLINFO));
                         mrc = (MRESULT)TRUE;
                     }
@@ -1468 +1433 @@
                     if (pttd->ptiMouseOver)
                     {
-                        memcpy(ptiTarget, pttd->ptiMouseOver, ptiTarget->cbSize);
+                        memcpy(ptiTarget, pttd->ptiMouseOver, sizeof(TOOLINFO));
                         mrc = (MPARAM)TRUE;
                     }
@@ -1512 +1477 @@
                     {
                         PTOOLINFO ptiThis = (PTOOLINFO)pToolNode->pItemData;
-                        if (    (ptiThis->hwnd == ptiSearch->hwnd)
-                             && (ptiThis->uId == ptiSearch->uId)
+                        if (    (ptiThis->hwndToolOwner == ptiSearch->hwndToolOwner)
+                             && (ptiThis->hwndTool == ptiSearch->hwndTool)
                            )
                         {
                             // found:
-                            memcpy(ptiSearch, ptiThis, ptiSearch->cbSize);
+                            memcpy(ptiSearch, ptiThis, sizeof(TOOLINFO));
                             mrc = (MPARAM)TRUE;
                             break;
@@ -1555 +1520 @@
 
             case TTM_SHOWTOOLTIPNOW:
+                _Pmpf((__FUNCTION__ ": TTM_SHOWTOOLTIPNOW %d", mp1));
                 TtmShowTooltip(hwndTooltip, pttd, (BOOL)mp1);
             break;