ToolTip.AutoPopDelay Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el período de tiempo que la información sobre herramientas estará visible si el puntero se detiene sobre un control para el que se haya especificado esa información.

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

Int32

Período de tiempo, en milisegundos, que permanecerá visible ToolTip cuando el puntero se detenga sobre un control. El valor predeterminado es 5 000.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la ToolTip clase y se asocia la instancia a la Form que se crea la instancia. A continuación, el código inicializa las propiedades AutoPopDelayde retraso , InitialDelayy ReshowDelay. Además, la instancia de la ToolTip clase establece la ShowAlways propiedad en true para permitir que el texto de información sobre herramientas se muestre independientemente de si el formulario está activo. Por último, en el ejemplo se asocia texto de información sobre herramientas a dos controles de un formulario, y Button .CheckBox El ejemplo de código requiere que el método definido en el ejemplo se encuentre dentro de un Form objeto que contiene un Button control denominado button1 y un CheckBox control denominado checkBox1, y que se llama al método desde el constructor 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

Comentarios

La AutoPopDelay propiedad permite acortar o prolongar el tiempo que se muestra la ToolTip ventana cuando el puntero está en un control. Por ejemplo, si muestra ayuda extensa en una ventana de información sobre herramientas, puede aumentar el valor de esta propiedad para asegurarse de que el usuario tiene tiempo suficiente para leer el texto.

Si desea tener un patrón de retraso coherente para las ventanas de información sobre herramientas, puede establecer la AutomaticDelay propiedad . La AutomaticDelay propiedad establece las AutoPopDelaypropiedades , ReshowDelayy InitialDelay en valores iniciales basados en un valor único. Cada vez que se establece la AutomaticDelay propiedad, la AutoPopDelay propiedad se establece en 10 veces el valor de la AutomaticDelay propiedad. Una vez establecida la AutomaticDelay propiedad, puede establecer la AutoPopDelay propiedad independientemente, reemplazando el valor predeterminado.

El tiempo máximo que puede retrasar un elemento emergente es de 5000 milisegundos. Durante más tiempo, use el Show método para controlar el momento exacto en que se muestra la información sobre herramientas.

Se aplica a

Compartir vía