ToolTip.Popup Event

Definition

在工具提示最初显示之前发生。Occurs before a ToolTip is initially displayed. 这是 ToolTip 类的默认事件。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 

Examples

下面的代码示例演示如何使用此成员。The following code example demonstrates the use of this member. 在此示例中,事件处理程序报告 Popup 事件的发生。In the example, an event handler reports on the occurrence of the Popup event. 此报表可帮助你了解何时发生事件,并可帮助你进行调试。This report helps you to learn when the event occurs and can assist you in debugging. 若要报告多个事件或频繁发生的事件,请考虑将 MessageBox.Show 替换为 Console.WriteLine 或将消息附加到多行 TextBox中。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.

若要运行示例代码,请将其粘贴到包含名为 ToolTip1ToolTip 类型实例的项目中。To run the example code, paste it into a project that contains an instance of type ToolTip named ToolTip1. 然后,确保事件处理程序与 Popup 事件关联。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

Remarks

在显示工具提示时,无论是通过显式调用某个 Show 方法还是在 ToolTip 类隐式显示工具提示时,都会引发 Popup 事件。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. 可以取消此事件。This event can be canceled.

在此事件中调用会导致重新创建基础窗口句柄的属性(如 IsBalloon)将导致引发异常。Calling properties in this event that cause the underlying window handle to be recreated, such as IsBalloon, will result in an exception being thrown.

Applies to

See also