ToolTip.ShowAlways Propriedade

  • Referência

Definição

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

Obtém ou define um valor que indica se uma janela Dica de ferramenta é exibida, mesmo quando seu controle pai não está ativo.

public:
 property bool ShowAlways { bool get(); void set(bool value); };
public bool ShowAlways { get; set; }
member this.ShowAlways : bool with get, set
Public Property ShowAlways As Boolean

Valor da propriedade

Boolean

true se a Dica de ferramenta sempre é exibida, caso contrário, false. O padrão é false.

Exemplos

O exemplo de código a ToolTip seguir cria uma instância da 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, um Button e um CheckBox. O exemplo de código requer que o método definido no exemplo esteja localizado dentro de um Form Button controle nomeado button1 e um CheckBox controle nomeado checkBox1e 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

Comentários

Com a ShowAlways propriedade, você pode exibir uma janela dica de ferramenta mesmo quando o contêiner do ToolTip não está ativo. Você pode usar esse recurso em um aplicativo de janela de modelagem para permitir que janelas de Dica de Ferramenta sejam exibidas independentemente de qual janela de modelagem esteja ativa. Esse recurso também é útil quando você deseja criar um controle usando o UserControl, que contém uma série de controles dentro dele que exibem janelas de Dica de Ferramenta. Como geralmente UserControl não é a janela ativa em um formulário, definir essa propriedade para true habilitar os controles dentro das janelas de Dica de Ferramenta a UserControl qualquer momento.

Aplica-se a

Confira também