ToolTip Classe

Definição

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Herança

Object

MarshalByRefObject

Component

ToolTip

Implementações

IExtenderProvider

Exemplos

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

Com a ToolTip classe , você pode fornecer dicas a um usuário quando o usuário coloca o ponteiro em um controle. Normalmente ToolTip , a classe é usada para alertar os usuários sobre o uso pretendido de um controle. Por exemplo, você pode especificar o texto tooltip para um TextBox controle que aceita um nome, especificando o formato do nome a ser digitado no controle. Além de fornecer dicas, você também pode usar a ToolTip classe para fornecer informações de status de tempo de execução. Por exemplo, você pode usar a ToolTip classe para exibir dados de velocidade de conexão e qualidade de linha quando o usuário move o ponteiro para um PictureBox controle que exibe o status da conexão com a Internet.

A ToolTip classe pode ser usada em qualquer contêiner. Para especificar explicitamente um contêiner, use o ToolTip(IContainer) construtor . Normalmente, um único ToolTip componente é usado para criar Dicas de Ferramenta para vários controles em um único formulário. Depois de criar um ToolTip, use uma chamada separada ao método para associar o SetToolTip texto de exibição tooltip a um controle individual. Em seguida, quando o usuário move o ponteiro em um controle, a Dica de Ferramenta com seu texto é exibida. Você pode chamar SetToolTip mais de uma vez para que o mesmo controle altere o texto associado ao controle. Para obter o texto associado a um controle, use o GetToolTip método . Para remover todas as associações de texto tooltip com uma instância da ToolTip classe , use o RemoveAll método .

A ToolTip classe fornece as seguintes propriedades e métodos para modificar o comportamento padrão e a aparência de uma Dica de Ferramenta.

Se você quiser desabilitar todo o texto da Dica de Ferramenta para que ele não possa ser exibido em seu aplicativo, você poderá usar a Active propriedade . Normalmente, a Dica de Ferramenta é desenhada pelo sistema operacional, mas para personalizar a aparência do ToolTip, você pode definir a OwnerDraw propriedade como true e manipular o Draw evento.

A ToolTipTitle classe implementa a System.ComponentModel.IExtenderProvider interface , que tem um único método, CanExtend. As Dicas de Ferramenta estendem os controles no mesmo formulário em tempo de design, adicionando uma ToolTip propriedade. Para obter mais informações sobre provedores de extensor, consulte Provedores de extensor.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• ToolTipIcon
• HelpProvider
• Provedores de extensores
• Componente ToolTip (Windows Forms)