ToolTip.ShowAlways Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 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
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.