Sets the initial, pop-up, and reshow durations for a tooltip control.

Syntax

To send this message, call the SendMessage function as follows.

        lResult = SendMessage(             // returns LRESULT in lResult
        (HWND) hWndControl,                // handle to destination control
        (UINT) TTM_SETDELAYTIME,           // message ID
        (WPARAM) wParam,                   // = (WPARAM) (DWORD) dwDuration
        (LPARAM) lParam                    // = (LPARAM) MAKELONG(iTime, 0)
        );
    

Parameters

dwDuration

Flag that specifies which time value to set. This parameter can be one of the following values

TTDT_AUTOPOP

Set the amount of time a tooltip window remains visible if the pointer is stationary within a tool's bounding rectangle. To return the autopop delay time to its default value, set iTime to -1.

TTDT_INITIAL

Set the amount of time a pointer must remain stationary within a tool's bounding rectangle before the tooltip window appears. To return the initial delay time to its default value, set iTime to -1.

TTDT_RESHOW

Set the amount of time it takes for subsequent tooltip windows to appear as the pointer moves from one tool to another. To return the reshow delay time to its default value, set iTime to -1.

TTDT_AUTOMATIC

Set all three delay times to default proportions. The autopop time will be ten times the initial time and the reshow time will be one fifth the initial time. If this flag is set, use a positive value of iTime to specify the initial time, in milliseconds. Set iTime to a negative value to return all three delay times to their default values.

iTime

Delay time, in milliseconds.

Return Value

The return value for this message is not used.

Remarks

The default delay times are based on the double-click time. For the default double-click time of 500 ms, the initial, autopop, and reshow delay times are 500ms, 5000ms, and 100ms respectively. The following code fragment uses the GetDoubleClickTime function to determine the three delay times for any system.

initial = GetDoubleClickTime();

autopop = GetDoubleClickTime() * 10;

reshow = GetDoubleClickTime() / 5;

Message Information

Header	commctrl.h
Minimum operating systems	Windows NT 3.51, Windows 95

See Also

TTM_GETDELAYTIME