ToolTip.Popup Evento
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.
Ocorre antes que uma dica de ferramenta seja exibida inicialmente. Trata-se do evento padrão para a classe ToolTip.
public:
event System::Windows::Forms::PopupEventHandler ^ Popup;
public event System.Windows.Forms.PopupEventHandler Popup;
public event System.Windows.Forms.PopupEventHandler? Popup;
member this.Popup : System.Windows.Forms.PopupEventHandler
Public Custom Event Popup As PopupEventHandler
Tipo de evento
Exemplos
O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do Popup evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo ToolTip chamada ToolTip1
. Em seguida, verifique se o manipulador de eventos está associado ao Popup evento.
private void ToolTip1_Popup(Object sender, PopupEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "AssociatedWindow", e.AssociatedWindow );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "AssociatedControl", e.AssociatedControl );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "IsBalloon", e.IsBalloon );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ToolTipSize", e.ToolTipSize );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Popup Event" );
}
Private Sub ToolTip1_Popup(sender as Object, e as PopupEventArgs) _
Handles ToolTip1.Popup
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "AssociatedWindow", e.AssociatedWindow)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "AssociatedControl", e.AssociatedControl)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "IsBalloon", e.IsBalloon)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ToolTipSize", e.ToolTipSize)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"Popup Event")
End Sub
Comentários
O Popup evento é gerado sempre que uma Dica de Ferramenta é exibida, seja por meio de uma chamada explícita para um dos Show métodos ou quando a ToolTip classe exibe implicitamente uma Dica de Ferramenta. Esse evento pode ser cancelado.
Chamar propriedades nesse evento que fazem com que o identificador de janela subjacente seja recriado, como IsBalloon, resultará na geração de uma exceção.