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 seguinte cria uma instância da ToolTip classe e associa a instância à Form que a instância é criada. O código inicializa então as propriedades AutoPopDelayde atraso , InitialDelay, e ReshowDelay. Além disso, a instância da ToolTip classe define a ShowAlways propriedade para true permitir que o texto ToolTip seja sempre exibido, independentemente de o formulário estar ativo ou não. Finalmente, o exemplo associa o texto ToolTip a dois controlos num formulário, a Button e um CheckBox. O exemplo de código exige que o método definido no exemplo esteja localizado dentro de um Form que contenha um Button controlo nomeado button1 e um CheckBox controlo nomeado checkBox1, e que o método seja 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

Observações

Com a ToolTip classe, podes dar dicas a um utilizador quando este coloca o ponteiro num controlo. A ToolTip classe é normalmente usada para alertar os utilizadores sobre a utilização pretendida de um controlo. Por exemplo, pode especificar texto ToolTip para um TextBox controlo que aceite um nome, especificando o formato do nome a ser digitado no controlo. Para além de fornecer dicas, também pode usar a ToolTip classe para fornecer informações sobre o estado em tempo de execução. Por exemplo, pode usar a ToolTip classe para mostrar dados de velocidade de ligação e qualidade de linha quando o utilizador move o ponteiro para um PictureBox controlo que mostra o estado da ligação à Internet.

A ToolTip classe pode ser usada em qualquer contentor. Para especificar explicitamente um contentor, use o ToolTip(IContainer) construtor. Um único ToolTip componente é tipicamente usado para criar ToolTips para múltiplos controlos num único formulário. Depois de criar um ToolTip, use uma chamada separada ao SetToolTip método para associar texto de exibição do ToolTip a um controlo individual. Depois, quando o utilizador move o ponteiro num controlo, a ToolTip com o seu texto é exibida. Pode chamar SetToolTip mais do que uma vez para que o mesmo controlo altere o texto associado ao controlo. Para obter o texto associado a um controlo, use o GetToolTip método. Para remover todas as associações de texto do 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 e a aparência padrão de uma ToolTip.

Se quiser desativar todo o texto da dica de ferramenta para que não possa ser exibido na sua aplicação, pode usar a Active propriedade. Normalmente, a ToolTip é desenhada pelo sistema operativo, mas para personalizar a aparência do ToolTip, pode definir a OwnerDraw propriedade para true e gerir o Draw evento.

A ToolTipTitle classe implementa a System.ComponentModel.IExtenderProvider interface, que tem um único método, CanExtend. ToolTips estendem os controlos no mesmo formulário no momento do design, adicionando uma ToolTip propriedade. Para mais informações sobre fornecedores de extensores, consulte Fornecedores de Extensores.

Ver também

• ToolTipIcon
• HelpProvider
• Fornecedores Extensores
• ToolTip Componente (Windows Forms)