Notification.ResponseSubmitted Event

Article
12/12/2007

Occurs when the user clicks a button or link in the message balloon.

Namespace: Microsoft.WindowsCE.Forms
Assembly: Microsoft.WindowsCE.Forms (in microsoft.windowsce.forms.dll)

Syntax

'Declaration
Public Event ResponseSubmitted As ResponseSubmittedEventHandler
'Usage
Dim instance As Notification
Dim handler As ResponseSubmittedEventHandler

AddHandler instance.ResponseSubmitted, handler

public event ResponseSubmittedEventHandler ResponseSubmitted

public:
event ResponseSubmittedEventHandler^ ResponseSubmitted {
    void add (ResponseSubmittedEventHandler^ value);
    void remove (ResponseSubmittedEventHandler^ value);
}

/** @event */
public void add_ResponseSubmitted (ResponseSubmittedEventHandler value)

/** @event */
public void remove_ResponseSubmitted (ResponseSubmittedEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.

Not applicable.

Remarks

This event occurs when the message balloon is dismissed by user input, but not when the InitialDuration time elapses.

This event is not raised if the Response property contains the name of a button or element in the format of "cmd:n", where n is any integer. These are special identifiers on the Pocket PC.

For more information about handling events, see Consuming Events.

Example

The following code demonstrates using this event to process user interaction with the message balloon. This code example is part of a larger example provided for the Notification class.

' When a ResponseSubmitted event occurs, this event handler
' parses the response to determine values in the HTML form.
Private Sub OnResponseSubmitted(obj As Object, _ 
   resevent As ResponseSubmittedEventArgs) Handles Notification1.ResponseSubmitted
   
   ' Use a StringBuilder to create a log of the response.
   Dim LogResponse As New StringBuilder()
   
   
   ' If the response contains the name specified for the action value
   ' of the HTML form, in this case "notify," get the value of the
   ' selected option from the SELECT list. An example of the
   ' response string would be notify?lstbx=0.
   If resevent.Response.Substring(0, 6) = "notify" Then
      Dim choice As Integer = Convert.ToInt32(resevent.Response.Substring(13, 1))
      Select Case choice
         Case 0
            LogResponse.Equals("submit")
         Case 1
            LogResponse.Equals("opt 1")
         Case 2
            LogResponse.Equals("opt 2")
         Case 3
            LogResponse.Equals("opt 3")
         Case 4
            LogResponse.Equals("opt 4")
      End Select
      ' If the checkbox in the form is checked, the response
      ' string could be as follows: notify?lstbx=0chkbx=on
      ' You can determine whether the check box is selected
      ' by checking whether the response ends with "on".
      If resevent.Response.EndsWith("on") Then
         LogResponse.Equals("checkbox")
      End If
   
   ' If the user clicked the settings link,
   ' log the response. This example could display
   ' a dialog box by activating another form.
   ElseIf resevent.Response = "settings" Then
      ' Display a settings dialog by activating
      ' a form named 'Settings':
      ' Settings.Activate
      LogResponse.Equals("Postponed by clicking link")
      
      ' The user needs to respond to the notification
      ' after checking the settings, so set the
      ' InitialDuration and Visible properties so
      ' that the icon appears in the title bar.
      Notification1.InitialDuration = 0
      Notification1.Visible = True
   End If
   
   ' Display the response on the status bar.
   StatusBar1.Text = LogResponse.ToString() + " HTML: " + resevent.Response.ToString()
End Sub

// When a ResponseSubmitted event occurs, this event handler
// parses the response to determine values in the HTML form.
private void OnResponseSubmitted(object obj, ResponseSubmittedEventArgs resevent)
{

    // Use a StringBuilder to create a log of the response.
    StringBuilder LogResponse = new StringBuilder();


    // If the response contains the name specified for the action value
    // of the HTML form, in this case "notify," get the value of the
    // selected option from the SELECT list. An example of the
    // response string would be notify?lstbx=0.

    if (resevent.Response.Substring(0, 6) == "notify")
    {
        int choice = Convert.ToInt32(resevent.Response.Substring(13, 1));
        switch (choice)
        {
            case 0:
                LogResponse.Equals("submit");
                break;
            case 1:
                LogResponse.Equals("opt 1");
                break;
            case 2:
                LogResponse.Equals("opt 2");
                break;
            case 3:
                LogResponse.Equals("opt 3");
                break;
            case 4:
                LogResponse.Equals("opt 4");
                break;
        }
        // If the checkbox in the form is checked, the response
        // string could be as follows: notify?lstbx=0chkbx=on
        // You can determine whether the check box is selected
        // by checking whether the response ends with "on".
        if (resevent.Response.EndsWith("on"))
            LogResponse.Equals("checkbox");
    }

    // If the user clicked the settings link,
    // log the response. This example could display
    // a dialog box by activating another form.
    else if (resevent.Response == "settings")
    {
        // Display a settings dialog by activating
        // a form named 'Settings':
        // Settings.Activate
        LogResponse.Equals("Postponed by clicking link");

        // The user needs to respond to the notification
        // after checking the settings, so set the
        // InitialDuration and Visible properties so
        // that the icon appears in the title bar.
        notification1.InitialDuration = 0;
        notification1.Visible = true;
    }

    // Display the response on the status bar.
    statusBar1.Text = LogResponse.ToString() + " HTML: " + resevent.Response.ToString();
}

Platforms

Windows Mobile for Pocket PC

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Compact Framework

Supported in: 2.0

Share via