Changeset 20

Timestamp:

Jan 5, 2001, 11:15:28 PM (25 years ago)

Author:

umoeller

Message:

Updated tooltips.

Location:

trunk

Files:

• include/helpers/comctl.h (modified) (2 diffs)
• include/helpers/linklist.h (modified) (2 diffs)
• include/helpers/prfh.h (modified) (1 diff)
• src/helpers/cctl_tooltip.c (modified) (2 diffs)

trunk/include/helpers/comctl.h

@@ -480 +480 @@
         HWND    hwndToolOwner;
                     // in: handle to the window that contains the tool. If
-                    // lpszText includes the LPSTR_TEXTCALLBACK value, this
+                    // lpszText includes the PSZ_TEXTCALLBACK value, this
                     // member identifies the window that receives TTN_NEEDTEXT
                     // notification messages.
@@ -591 +591 @@
     /*
      *@@ TTN_NEEDTEXT:
-     *      control notification sent with the WM_NOTIFY (Win95)
-     *      and WM_CONTROL (OS/2) messages.
-     *
-     *      Parameters (OS/2, incompatible with Win95):
-     *      -- mp1 USHORT usID;
-     *             USHORT usNotifyCode == TTN_NEEDTEXT
+     *      notification code used with WM_CONTROL when a tooltip
+     *      needs a tooltip text for a tool.
+     *
+     *      Parameters:
+     *
+     *      -- SHORT1FROMMP(mp1) usID: ID of the tooltip control).
+     *
+     *      -- SHORT2FROMMP(mp1) usNotifyCode: TTN_NEEDTEXT.
+     *
      *      -- PTOOLTIPTEXT mp2: pointer to a TOOLTIPTEXT structure.
-     *              The hdr member identifies the tool for which text is needed. The
-     *              receiving window can specify the string by taking one of the
-     *              following actions:
-     *              -- Copying the text to the buffer specified by the szText member.
-     *              -- Copying the address of the buffer that contains the text to the
-     *                 lpszText member.
-     *              -- Copying the identifier of a string resource to the lpszText
-     *                 member and copying the handle of the instance that contains
-     *                 the resource to the hinst member.
+     *              hwndTool identifies the tool for which text is needed.
      *
      *      This notification message is sent to the window specified
-     *      in the hwnd member of the TOOLINFO structure for the tool.
-     *      This notification is sent only if the LPSTR_TEXTCALLBACK
+     *      in the hwndToolOwner member of the TOOLINFO structure for the tool.
+     *      This notification is sent only if the PSZ_TEXTCALLBACK
      *      value is specified when the tool is added to a tooltip control.
      *
-     *      Windows 95 only: When a TTN_NEEDTEXT notification is received,
-     *      the application can set or clear the TTF_RTLREADING value
-     *      in the uFlags member of the TOOLTIPTEXT structure pointed to
-     *      by lpttt as required. This is the only flag that can be changed
-     *      during the notification callback.
-     *
-     *      OS/2 only: Specifying LPSTR_TEXTCALLBACK in TOOLINFO.lpszText
-     *      with TTM_ADDTOOL is the only way under OS/2 to have strings
-     *      displayed which are longer than 256 characters, since string
-     *      resources are limited to 256 characters with OS/2. It is the
-     *      responsibility of the application to set the lpszText member
-     *      to a static string buffer which holds the string for the tool.
-     *      A common error would be to have that member point to some
-     *      variable which has only been allocated on the stack.
+     *      To specify the text, the target window (hwndToolOwner) must:
+     *
+     *      1.  Set TOOLTIPTEXT.ulFormat to one of the format flags.
+     *
+     *      2.  Fill the corresponding field(s) in TOOLTIPTEXT.
+     *
+     *      Specifying PSZ_TEXTCALLBACK in TOOLINFO.lpszText with
+     *      TTM_ADDTOOL is the only way under OS/2 to have strings
+     *      displayed which are longer than 256 characters, since
+     *      string resources are limited to 256 characters with OS/2.
+     *      It is the responsibility of the application to set the
+     *      pszText member to a _static_ string buffer which holds
+     *      the string for the tool. A common error would be to have
+     *      that member point to some variable which has only been
+     *      allocated on the stack... this will lead to problems.
      */
 

trunk/include/helpers/linklist.h

@@ -58 +58 @@
     /*
      *@@ LISTNODE:
-     *      new with V0.9.0. This now defines
-     *      one item in the list.
-     *      pItemData points to the actual data.
+     *      this defines one item in a LINKLIST.
+     *
+     *      pItemData points to the actual data,
+     *      whatever format this is in...
+     *
+     *      See linklist.c for more on how
+     *      to use these.
      *
      *@@added V0.9.0
@@ -74 +78 @@
     /*
      *@@ LINKLIST:
-     *      new with V0.9.0. This now defines
      *      the "root" of a linked list.
+     *
+     *      See linklist.c for more on how
+     *      to use these.
      *
      *@@added V0.9.0

trunk/include/helpers/prfh.h

@@ -77 +77 @@
      *@@ COUNTRYSETTINGS:
      *      structure used for returning country settings
-     *      with prfQueryCountrySettings.
+     *      with prfhQueryCountrySettings.
      */
 

trunk/src/helpers/cctl_tooltip.c

@@ -1276 +1276 @@
              *      Return value: 0 always.
              *
-             *      Additional note: On input, if TOOLINFO.lpszText == LPSTR_TEXTCALLBACK,
+             *      Additional note: On input, if TOOLINFO.lpszText == PSZ_TEXTCALLBACK,
              *      this sends the TTN_NEEDTEXT notification to TOOLINFO.hwnd.
              */
@@ -1289 +1289 @@
                     // compose values for that msg
                     TOOLTIPTEXT ttt = {0};
-                    _Pmpf(("TTM_GETTEXT: LPSTR_TEXTCALLBACK"));
+                    _Pmpf(("TTM_GETTEXT: PSZ_TEXTCALLBACK"));
                     ttt.hwndTooltip = hwndTooltip;
                     ttt.hwndTool = pti->hwndTool;