ToolTip.Popup Ereignis

Definition

Tritt ein, bevor eine QuickInfo anfänglich angezeigt wird.Occurs before a ToolTip is initially displayed. Dies ist das Standardereignis für die ToolTip-Klasse.This is the default event for the ToolTip class.

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 

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht.The following code example demonstrates the use of this member. Im Beispiel meldet ein Ereignishandler das Vorkommen des Popup Ereignisses.In the example, an event handler reports on the occurrence of the Popup event. Mit diesem Bericht können Sie lernen, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können.This report helps you to learn when the event occurs and can assist you in debugging. Wenn Sie mehrere Ereignisse oder Ereignisse, die häufig auftreten, melden möchten, können Sie MessageBox.Show durch Console.WriteLine ersetzen oder die Nachricht an eine mehrzeilige TextBoxanhängen.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs ToolTip mit dem Namen ToolTip1enthält.To run the example code, paste it into a project that contains an instance of type ToolTip named ToolTip1. Stellen Sie dann sicher, dass der Ereignishandler dem Popup-Ereignis zugeordnet ist.Then ensure that the event handler is associated with the Popup event.

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

Hinweise

Das Popup-Ereignis wird immer dann ausgelöst, wenn eine QuickInfo angezeigt wird, entweder durch einen expliziten Aufruf einer der Show Methoden oder wenn die ToolTip Klasse implizit eine QuickInfo anzeigt.The Popup event is raised whenever a ToolTip is displayed, either through an explicit call to one of the Show methods or when the ToolTip class implicitly displays a ToolTip. Dieses Ereignis kann abgebrochen werden.This event can be canceled.

Das Aufrufen von Eigenschaften in diesem Ereignis, die bewirken, dass das zugrunde liegende Fenster Handle neu erstellt wird, z. b. IsBalloon, führt dazu, dass eine Ausnahme ausgelöst wird.Calling properties in this event that cause the underlying window handle to be recreated, such as IsBalloon, will result in an exception being thrown.

Gilt für:

Siehe auch