ToolTip.AutoPopDelay Egenskap

public:
 property int AutoPopDelay { int get(); void set(int value); };

public int AutoPopDelay { get; set; }

member this.AutoPopDelay : int with get, set

Public Property AutoPopDelay As Integer

Egenskapsvärde

Tidsperioden, i millisekunder, som ToolTip förblir synlig när pekaren står stilla på en kontroll. På Windows 11 gör standardvärdet att knappbeskrivningen förblir synlig på obestämd tid.

Exempel

I följande kodexempel skapas en instans av ToolTip klassen och instansen associeras med Form den som instansen skapas i. Koden initierar sedan fördröjningsegenskaperna AutoPopDelay, InitialDelayoch ReshowDelay. Dessutom anger ToolTip instansen ShowAlways av klassen egenskapen till true så att Knappbeskrivningstext kan visas oavsett om formuläret är aktivt. Slutligen associerar exemplet ToolTip-text med två kontroller i ett formulär, en Button och en CheckBox. Kodexemplet kräver att metoden som definieras i exemplet finns i en Form som innehåller en Button kontroll med namnet button1 och en CheckBox kontroll med namnet checkBox1, och att metoden anropas från konstruktorn i Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew ToolTip;
   
   // Set up the delays for the ToolTip.
   toolTip1->AutoPopDelay = 5000;
   toolTip1->InitialDelay = 1000;
   toolTip1->ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1->ShowAlways = true;
   
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1->SetToolTip( this->button1, "My button1" );
   toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As New ToolTip()
   
   ' Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
   ' Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = True
   
   ' Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Kommentarer

Med AutoPopDelay egenskapen kan du förkorta eller förlänga den tid som ToolTip fönstret visas när pekaren finns på en kontroll. Om du till exempel visar omfattande hjälp i ett knappbeskrivningsfönster kan du öka värdet för den här egenskapen för att säkerställa att användaren har tillräckligt med tid för att läsa texten.

Om du vill ha ett konsekvent fördröjningsmönster för knappbeskrivningsfönstren kan du ange egenskapen AutomaticDelay . Egenskapen AutomaticDelay anger AutoPopDelayegenskaperna , ReshowDelayoch InitialDelay till initiala värden baserat på ett enda värde. Varje gång egenskapen AutomaticDelay anges AutoPopDelay anges egenskapen till 10 gånger egenskapsvärdet AutomaticDelay . När egenskapen AutomaticDelay har angetts kan du oberoende ange AutoPopDelay egenskapen och åsidosätta standardvärdet.

Beteendet för den här egenskapen varierar beroende på Windows version:

• På Windows 10 är den maximala tiden du kan fördröja ett popup-fönster 5 000 millisekunder. Värden som är större än 5 000 ms är fastklämda till 5 000 ms.
• På Windows 11 gör standardvärdet att knappbeskrivningar förblir synliga på obestämd tid. När värdet är inställt på ett anpassat värde finns det ingen gräns på 5 000 ms och knappbeskrivningen visas under den angivna varaktigheten.

Använd metoden för längre varaktigheter eller exakt kontroll över när knappbeskrivningen visas Show .

Se även

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup