TTM_SETDELAYTIME (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

ToolTips Messages
GetDoubleClickTime
TTM_GETDELAYTIME