ToolTip.AutoPopDelay Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ToolTip.cs

Získá nebo nastaví časové období, po který zůstane popisek viditelný, pokud je ukazatel na ovládacím prvku se zadaným textem popisu.

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

Hodnota vlastnosti

Int32

Časové období v milisekundách, které ToolTip zůstává viditelné, když je ukazatel na ovládacím prvku statický. Výchozí hodnota ve Windows 11 způsobí, že popisek zůstane trvale viditelný.

Příklady

Následující příklad kódu vytvoří instanci ToolTip třídy a přidruží instanci k Form instanci, ve které je instance vytvořena. Kód pak inicializuje vlastnosti AutoPopDelayzpoždění , InitialDelaya ReshowDelay. Kromě instance ToolTip třídy nastaví ShowAlways vlastnost povolit true toolTip text zobrazit bez ohledu na to, zda formulář je aktivní. A konečně příklad přidruží text popisu k dvěma ovládacím prvkům ve formuláři a Button a CheckBox. Příklad kódu vyžaduje, aby metoda definovaná v příkladu byla umístěna uvnitř Form , který obsahuje Button ovládací prvek pojmenovaný button1 a ovládací prvek pojmenovaný CheckBoxcheckBox1, a že metoda je volána z konstruktoru 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

Poznámky

Tato AutoPopDelay vlastnost umožňuje zkrátit nebo prodloužit dobu zobrazení ToolTip okna, když je ukazatel myši na ovládacím prvku. Pokud například v okně popisů zobrazíte rozsáhlou nápovědu, můžete zvýšit hodnotu této vlastnosti, abyste zajistili, že uživatel bude mít dostatek času na přečtení textu.

Pokud chcete mít konzistentní způsob zpoždění pro okna popisů AutomaticDelay tlačítek, můžete vlastnost nastavit. Vlastnost AutomaticDelay nastaví AutoPopDelayvlastnost , ReshowDelaya InitialDelay vlastnosti na počáteční hodnoty na základě jedné hodnoty. Při AutomaticDelay každém nastavení AutoPopDelay vlastnosti je vlastnost nastavena na 10krát AutomaticDelay hodnotu vlastnosti. AutomaticDelay Jakmile je vlastnost nastavena, můžete ji nezávisle nastavit AutoPopDelay a přepíše výchozí hodnotu.

Chování této vlastnosti se liší podle verze Systému Windows:

• Ve Windows 10 je maximální doba, po kterou můžete zpozdit místní okno, 5000 milisekund. Hodnoty větší než 5000 ms jsou upínací na 5 000 ms.
• Výchozí hodnota ve Windows 11 způsobí, že popisy tlačítek zůstanou trvale viditelné. Pokud je nastavená na vlastní hodnotu, neexistuje žádný limit 5000 ms a popis se zobrazí po zadanou dobu trvání.

Po delší dobu nebo přesnou kontrolu nad zobrazením popisu použijte metodu Show .

Viz také

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup