Skip to content

Commit ce0c82a

Browse files
authored
Update ToolTip.AutoPopDelay documentation to reflect platform-specific behavior (#11863)
1 parent 4e583eb commit ce0c82a

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

xml/System.Windows.Forms/ToolTip.xml

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -320,7 +320,7 @@
320320
</ReturnValue>
321321
<Docs>
322322
<summary>Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.</summary>
323-
<value>The period of time, in milliseconds, that the <see cref="T:System.Windows.Forms.ToolTip" /> remains visible when the pointer is stationary on a control. The default value is 5000.</value>
323+
<value>The period of time, in milliseconds, that the <see cref="T:System.Windows.Forms.ToolTip" /> remains visible when the pointer is stationary on a control. On Windows 11, the default value causes the ToolTip to remain visible indefinitely.</value>
324324
<remarks>
325325
<format type="text/markdown"><![CDATA[
326326
@@ -329,7 +329,12 @@
329329
330330
If you want to have a consistent delay pattern for your ToolTip windows, you can set the <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> property. The <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> property sets the <xref:System.Windows.Forms.ToolTip.AutoPopDelay%2A>, <xref:System.Windows.Forms.ToolTip.ReshowDelay%2A>, and <xref:System.Windows.Forms.ToolTip.InitialDelay%2A> properties to initial values based on a single value. Every time the <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> property is set, the <xref:System.Windows.Forms.ToolTip.AutoPopDelay%2A> property is set to 10 times the <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> property value. Once the <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> property is set, you can independently set the <xref:System.Windows.Forms.ToolTip.AutoPopDelay%2A> property, overriding the default value.
331331
332-
The maximum time you can delay a popup is 5000 milliseconds. For longer durations, use the <xref:System.Windows.Forms.ToolTip.Show%2A> method to control the exact moment when the ToolTip is displayed.
332+
The behavior of this property varies by Windows version:
333+
334+
- On Windows 10, the maximum time you can delay a popup is 5000 milliseconds. Values greater than 5000 ms are clamped to 5000 ms.
335+
- On Windows 11, the default value causes tooltips to remain visible indefinitely. When set to a custom value, there's no 5000 ms limit, and the tooltip displays for the specified duration.
336+
337+
For longer durations or precise control over when the ToolTip is displayed, use the <xref:System.Windows.Forms.ToolTip.Show%2A> method.
333338
334339
335340

0 commit comments

Comments
 (0)