TTM_SETDELAYTIME message

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

Parameters

wParam

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

Value Meaning
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 lParam 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 lParam 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 lParam 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 lParam to specify the initial time, in milliseconds. Set lParam to a negative value to return all three delay times to their default values.

lParam

The LOWORD specifies the delay time, in milliseconds. The HIWORD must be zero.

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;

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h

See also

TTM_GETDELAYTIME