TTM_SETDELAYTIME
A version of this page is also available for
4/8/2010
This message sets the initial, pop-up, and reshow durations for a ToolTip control.
Syntax
TTM_SETDELAYTIME
wParam = (WPARAM)(DWORD) dwDuration;
lParam = (LPARAM)(INT) MAKELONG(iTime,0);
Parameters
dwDuration
DWORD that specifies the type of duration that you want to set. The following table shows the possible values.Value Description TTDT_AUTOMATIC
Sets all three delay times to default proportions, which sets the pop-up time to ten times the initial time and the reshow time to one-fifth the initial time. If you set this flag, use a positive value of iTime to specify the initial time, in milliseconds. Set iTime to a negative value to reset all three delay times to their default values.
TTDT_AUTOPOP
Sets the length of time the ToolTip window remains visible if the pointer is stationary within the bounding rectangle of a tool. To reset this delay time to its default value, set iTime to -1.
TTDT_INITIAL
Sets the length of time the pointer must remain stationary within the bounding rectangle of a tool before the ToolTip window appears. To reset this delay time to its default value, set iTime to -1.
TTDT_RESHOW
Sets the length of time that elapses before subsequent ToolTip windows appear when the pointer moves from one tool to another. To reset this delay time to its default value, set iTime to -1.
- iTime
Integer that specifies the length of the delay time, in milliseconds.
Return Value
None.
Remarks
The default delay times depend on the double-click time. For the default double-click time of 500 ms, the initial, pop-up, and reshow delay times are 500 ms, 5000 ms, and 100 ms, respectively. The following code example uses the GetDoubleClickTime function to determine the three delay times for any system.
initial = GetDoubleClickTime();
autopop = GetDoubleClickTime() * 10;
reshow = GetDoubleClickTime() / 5;
Requirements
| Header | commctrl.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |