[Breaking change]: ToolTip.AutoPopDelay documentation does not match Win11 behavior #47960
Description
Description
The official documentation for ToolTip.AutoPopDelay states that the maximum value is 5000 milliseconds. However, in practice, this limit only applies to Windows 10. On Windows 11, the default value causes tooltips to remain visible indefinitely, and if set to a custom value, there is no 5000 ms restriction—the tooltip displays for the specified duration. This discrepancy between documentation and actual behavior can cause confusion for developers. The documentation should be updated to clarify the maximum value and describe the different behaviors on Windows 10 and Windows 11.
Version
.NET 8
Previous behavior
On Windows 10, the default value for ToolTip.AutoPopDelay causes the tooltip to disappear after a set duration (not infinite).
The maximum value for ToolTip.AutoPopDelay is limited to 5000 milliseconds. Setting a value greater than 5000 ms will have no effect; the tooltip will disappear after 5000 ms.
New behavior
On Windows 11, the default value for ToolTip.AutoPopDelay causes tooltips to remain visible indefinitely (infinite tooltip).
When ToolTip.AutoPopDelay is set to a non-default value, the tooltip displays for the specified duration, and this value is not limited to 5000 ms.
Type of breaking change
- Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
- Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
- Behavioral change: Existing binaries might behave differently at run time.
Reason for change
The official documentation incorrectly states that the maximum value for ToolTip.AutoPopDelay is 5000 milliseconds. However, actual behavior differs between Windows 10 and Windows 11, and there is no 5000 ms limit enforced in all cases. The documentation needs to be updated to accurately reflect the real behavior and platform differences.
Recommended action
Update the documentation for ToolTip.AutoPopDelay to accurately describe the maximum value limits and platform-specific behavior:
- Clearly state that on Windows 10, the maximum value is 5000 milliseconds.
- Clarify that on Windows 11, the default value can result in infinite tooltips, and custom values are not limited to 5000 ms.
- Remove or revise any statements that incorrectly generalize the 5000 ms maximum.
- Add remarks section to explain the difference in behavior between Windows 10 and Windows 11.
Feature area
Windows Forms
Affected APIs
No response