ToolTip.Popup 事件

定義

發生於最初顯示工具提示之前。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 

事件類型

PopupEventHandler

範例

下列程式碼範例將示範如何使用這個成員。The following code example demonstrates the use of this member. 在此範例中,事件處理常式會報告事件的發生情況 PopupIn 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 或將訊息附加至多行 TextBoxTo 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.

若要執行範例程式碼,請將它貼到包含名為之類型實例的專案中 ToolTip ToolTip1To run the example code, paste it into a project that contains an instance of type ToolTip named ToolTip1. 然後確定事件處理常式與事件相關聯 PopupThen 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

備註

Popup每當顯示工具提示時(透過明確呼叫其中一個 Show 方法,或當 ToolTip 類別以隱含方式顯示工具提示時),就會引發此事件。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.

適用於

另請參閱