ToolTip.InitialDelay Propiedad

Definición

Obtiene o establece el tiempo que transcurre hasta que aparece la información sobre herramientas.Gets or sets the time that passes before the ToolTip appears.

public:
 property int InitialDelay { int get(); void set(int value); };
public int InitialDelay { get; set; }
member this.InitialDelay : int with get, set
Public Property InitialDelay As Integer

Valor de propiedad

Período de tiempo, en milisegundos, que debe permanecer el puntero sobre un control antes de que se muestre la ventana de información sobre herramientas.The period of time, in milliseconds, that the pointer must remain stationary on a control before the ToolTip window is displayed.

Ejemplos

En el ejemplo de código siguiente se crea una ToolTip instancia de la clase y se asocia Form la instancia con la clase en la que se crea 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. A continuación, el código inicializa las propiedades AutoPopDelayde InitialDelayretraso, ReshowDelayy.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Además, la instancia de la ToolTip clase establece la ShowAlways propiedad en true para permitir que se muestre el texto de información sobre herramientas sin tener en consideración 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 con Button dos controles CheckBoxen un formulario, un y un.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 encuentre dentro Form de un que Button contiene un button1 control denominado CheckBox y un checkBox1, control denominado 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

Con la InitialDelay propiedad, puede acortar o alargar el tiempo ToolTip que espera antes de mostrar una ventana de información sobre herramientas.With the InitialDelay property, you can shorten or lengthen the time that the ToolTip waits before displaying a ToolTip window. Si el valor de la InitialDelay propiedad se establece en un valor demasiado largo, es posible que el usuario de la aplicación no sepa que la aplicación proporciona ayuda para la información sobre herramientas.If the value of the InitialDelay property is set to a value that is too long in duration, the user of your application might not know that your application provides ToolTip Help. Puede usar esta propiedad para asegurarse de que el usuario tiene información sobre herramientas mostrada rápidamente acortando el tiempo especificado.You can use this property to ensure that the user has ToolTips displayed quickly by shortening the time specified.

El valor de esta propiedad no puede ser superior a 32767.The value for this property cannot exceed 32767.

Si desea tener un modelo de retraso coherente para las ventanas de información sobre herramientas, puede establecer AutomaticDelay la propiedad.If you want to have a consistent delay pattern for your ToolTip windows, you can set the AutomaticDelay property. La AutomaticDelay propiedad establece las AutoPopDelaypropiedades ReshowDelay, y InitialDelay en los valores iniciales en función de un valor de hora única.The AutomaticDelay property sets the AutoPopDelay, ReshowDelay, and InitialDelay properties to initial values based on a single time value. Cada vez que AutomaticDelay se establece la propiedad, InitialDelay la propiedad se establece en el mismo valor que AutomaticDelay la propiedad.Every time the AutomaticDelay property is set, the InitialDelay property is set to the same value as the AutomaticDelay property. Una vez AutomaticDelay establecida la propiedad, puede establecer de forma independiente InitialDelay la propiedad, invalidando el valor predeterminado.Once the AutomaticDelay property is set, you can independently set the InitialDelay property, overriding the default value.

Se aplica a

Consulte también: