Compartilhar via

ToolTip.AutoPopDelay Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o período em que ToolTip permanecerá visível se o ponteiro estiver parado em um controle com o texto de ToolTip especificado.

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 da propriedade

Int32

O período, em milissegundos, em que o ToolTip permanece visível quando o ponteiro está parado em um controle. O valor padrão é 5.000.

Exemplos

O exemplo de código a seguir cria uma instância da ToolTip classe e associa a instância à Form qual a instância é criada. Em seguida, InitialDelayo código inicializa as propriedades AutoPopDelayde atraso e ReshowDelay. Além disso, a instância da ToolTip classe define a propriedade para true permitir que o ShowAlways texto da Dica de Ferramenta seja exibido independentemente de o formulário estar ativo. Por fim, o exemplo associa o texto tooltip a dois controles em um formulário, a Button e um CheckBox. O exemplo de código requer que o método definido no exemplo esteja localizado em um controle nomeado e um CheckBox controle nomeado checkBox1, e que o método seja chamado do construtor do Form.button1 Button 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

Comentários

A AutoPopDelay propriedade permite reduzir ou alongar o tempo que a ToolTip janela é exibida quando o ponteiro está em um controle. Por exemplo, se você exibir ajuda extensiva em uma janela dica de ferramenta, poderá aumentar o valor dessa propriedade para garantir que o usuário tenha tempo suficiente para ler o texto.

Se você quiser ter um padrão de atraso consistente para suas janelas de Dica de Ferramenta, poderá definir a AutomaticDelay propriedade. A AutomaticDelay propriedade define as propriedades e InitialDelay as AutoPopDelayReshowDelaypropriedades como valores iniciais com base em um único valor. Sempre que a AutomaticDelay propriedade é definida, a AutoPopDelay propriedade é definida como 10 vezes o valor da AutomaticDelay propriedade. Depois que a AutomaticDelay propriedade for definida, você poderá definir a AutoPopDelay propriedade de forma independente, substituindo o valor padrão.

O tempo máximo que você pode atrasar um pop-up é de 5.000 milissegundos. Para durações mais longas, use o Show método para controlar o momento exato em que a Dica de Ferramenta é exibida.

Aplica-se a

Confira também