ToolTip.AutoPopDelay Eigenschap

Definitie

Hiermee haalt of stelt u de periode in waarop de knopinfo zichtbaar blijft als de aanwijzer op een besturingselement met de opgegeven knopinfotekst wordt geplaatst.

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

Waarde van eigenschap

De periode, in milliseconden, dat de ToolTip aanwijzer zichtbaar blijft wanneer de aanwijzer op een besturingselement is gestationeerd. In Windows 11 zorgt de standaardwaarde ervoor dat de knopinfo voor onbepaalde tijd zichtbaar blijft.

Voorbeelden

In het volgende codevoorbeeld wordt een exemplaar van de ToolTip klasse gemaakt en wordt het exemplaar gekoppeld aan het Form exemplaar dat binnen is gemaakt. De code initialiseert vervolgens de vertragingseigenschappen AutoPopDelay, InitialDelayen ReshowDelay. Daarnaast stelt het exemplaar van de ToolTip klasse de ShowAlways eigenschap in om true in te schakelen dat knopinfotekst wordt weergegeven, ongeacht of het formulier actief is. Ten slotte koppelt het voorbeeld knopinfotekst aan twee besturingselementen in een formulier, a Button en a CheckBox. Het codevoorbeeld vereist dat de methode die in het voorbeeld is gedefinieerd zich bevindt in een Form besturingselement met een Button benoemd button1 besturingselement en een CheckBox benoemd checkBox1, besturingselement en dat de methode wordt aangeroepen vanuit de constructor van de 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

Opmerkingen

Met AutoPopDelay de eigenschap kunt u de tijd verkorten of verkorten waarop het ToolTip venster wordt weergegeven wanneer de aanwijzer zich op een besturingselement bevindt. Als u bijvoorbeeld uitgebreide Help weergeeft in een knopinfovenster, kunt u de waarde van deze eigenschap verhogen om ervoor te zorgen dat de gebruiker voldoende tijd heeft om de tekst te lezen.

Als u een consistent vertragingspatroon voor de vensters voor knopinfo wilt hebben, kunt u de AutomaticDelay eigenschap instellen. De AutomaticDelay eigenschap stelt de AutoPopDelay, ReshowDelayen InitialDelay eigenschappen in op initiële waarden op basis van één waarde. Telkens wanneer de AutomaticDelay eigenschap wordt ingesteld, wordt de AutoPopDelay eigenschap ingesteld op 10 keer de AutomaticDelay eigenschapswaarde. Zodra de AutomaticDelay eigenschap is ingesteld, kunt u de AutoPopDelay eigenschap onafhankelijk instellen, waardoor de standaardwaarde wordt overschreven.

Het gedrag van deze eigenschap verschilt per Windows versie:

  • Op Windows 10 kunt u een pop-up maximaal 5000 milliseconden uitstellen. Waarden groter dan 5000 ms worden vastgezet tot 5000 ms.
  • Op Windows 11 zorgt de standaardwaarde ervoor dat knopinfo voor onbepaalde tijd zichtbaar blijft. Als deze waarde is ingesteld op een aangepaste waarde, is er geen limiet van 5000 ms en wordt de knopinfo weergegeven voor de opgegeven duur.

Gebruik de Show methode voor langere duur of nauwkeurige controle over wanneer de knopinfo wordt weergegeven.

Van toepassing op

Zie ook