ToolTip.AutoPopDelay ToolTip.AutoPopDelay ToolTip.AutoPopDelay ToolTip.AutoPopDelay Property

Definición

Obtiene o establece el período de tiempo que la información sobre herramientas estará visible si el puntero se detiene sobre un control que tenga el texto de información sobre herramientas especificado.Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

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

Valor de propiedad

Período de tiempo, en milisegundos, que permanecerá visible ToolTip cuando el puntero se detenga sobre un control.The period of time, in milliseconds, that the ToolTip remains visible when the pointer is stationary on a control. El valor predeterminado es 5000.The default value is 5000.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la ToolTip clase y la asocia con el Form que se creó la instancia.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. El código, a continuación, inicializa las propiedades de retraso AutoPopDelay, InitialDelay, y ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Además la instancia de la ToolTip clase conjuntos el ShowAlways propiedad true para habilitar el texto de información sobre herramientas que se mostrará, independientemente de si el formulario está activo.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to be displayed regardless of whether the form is active. Por último, en el ejemplo se asocia el texto de información sobre herramientas a dos controles en un formulario, un Button y un CheckBox.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. El ejemplo de código requiere que el método definido en el ejemplo se encuentra en un Form que contiene un Button control denominado button1 y un CheckBox control denominado checkBox1, y que se llama al método desde el constructor de el Form.The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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

Comentarios

El AutoPopDelay propiedad le permite aumentar o disminuir el tiempo que el ToolTip ventana se muestra cuando el puntero está en un control.The AutoPopDelay property enables you to shorten or lengthen the time that the ToolTip window is displayed when the pointer is on a control. Por ejemplo, si se muestra una completa ayuda en una ventana de información sobre herramientas, puede aumentar el valor de esta propiedad para asegurarse de que el usuario tiene suficiente tiempo para leer el texto.For example, if you display extensive Help in a ToolTip window, you can increase the value of this property to ensure that the user has sufficient time to read the text.

Si desea que el retraso coherente para las ventanas de información sobre herramientas, puede establecer el AutomaticDelay propiedad.If you want to have a consistent delay pattern for your ToolTip windows, you can set the AutomaticDelay property. El AutomaticDelay conjuntos de propiedades el AutoPopDelay, ReshowDelay, y InitialDelay propiedades en sus valores iniciales en función de un solo valor.The AutomaticDelay property sets the AutoPopDelay, ReshowDelay, and InitialDelay properties to initial values based on a single value. Cada vez que el AutomaticDelay propiedad está establecida, el AutoPopDelay propiedad se establece en 10 veces el AutomaticDelay valor de propiedad.Every time the AutomaticDelay property is set, the AutoPopDelay property is set to 10 times the AutomaticDelay property value. Una vez el AutomaticDelay propiedad está establecida, puede establecer de forma independiente el AutoPopDelay propiedad, reemplazar el valor predeterminado.Once the AutomaticDelay property is set, you can independently set the AutoPopDelay property, overriding the default value.

El tiempo máximo que puede retrasar un elemento emergente es 5000 milisegundos.The maximum time you can delay a popup is 5000 milliseconds. Para mayor duración, use el Show método para controlar el momento exacto cuando se muestre la información sobre herramientas.For longer durations, use the Show method to control the exact moment when the ToolTip is displayed.

Se aplica a

Consulte también: