Merge branch 'api-status-bar-activity-draft' of github.com:MicrosoftEdge/WebView2Feedback into api-status-bar-activity-draft

Made changes to reflect feedback on PR

Author: Tochibee

specs/StatusBarActivity.md

@@ -27,10 +27,11 @@ Developers will be able to:
 CHECK_FAILURE(m_webView->add_StatusBarShowing(
     Callback<ICoreWebView2StatusBarShowingEventHandler>(
         [this](ICoreWebView2* sender, ICoreWebView2StatusBarShowingEventArgs* args) -> HRESULT {
-            std::string message;
-            CHECK_FAILURE(args->get_message(&message));
+
+            LPWSTR value;
+            CHECK_FAILURE(args->get_value(&value));
             
-            // Handle status bar text in message
+            // Handle status bar text in value
 
             return S_OK;
         }
@@ -50,15 +51,15 @@ CHECK_FAILURE(m_webView->add_StatusBarHiding(
     ).Get(),
 &m_statusBarHiding));
 ```
-## C#/ .Net/ WinRT Registering a listener for status bar showing
+## .NET / WinRT Registering a listener for status bar showing
 ```
 webView.CoreWebView2.StatusBarShowing += (object sender, CoreWebView2StatusBarShowingEventArgs arg) =>
 {
-    string message = args.message;
-    // Handle status bar text in message
+    string value = args.value;
+    // Handle status bar text in value
 };
 ```
-## C#/ .Net/ WinRT Registering a listener for status bar hiding
+## .Net/ WinRT Registering a listener for status bar hiding
 ```
 webView.CoreWebView2.StatusBarHiding += (object sender) =>
 {
@@ -70,10 +71,17 @@ See [API Details](#api-details) Section below for API reference
 # API Details
 ## Win32 C++
 ```
+/*
+    Interface for the statusbar showing event args
+    The value property contains the status bar text
+*/
+[uuid(56acdbb8-ceac-11eb-b8bc-0242ac130003), object, pointer_default(unique)]
 interface ICoreWebView2StatusBarShowingEventArgs : IUnknown {
-    [propget] HRESULT Message([out, retval] LPWSTR* value);
+    [propget] HRESULT Value([out, retval] LPWSTR* value);
 }   
-   
+
+// Interface for the status bar showing event handler
+[uuid(85c8b75a-ceac-11eb-b8bc-0242ac130003), object, pointer_default(unique)]
 interface ICoreWebView2StatusBarShowingEventHandler : IUnknown {
   /// Called to provide the implementer with the event args for the
   /// corresponding event.
@@ -82,31 +90,62 @@ interface ICoreWebView2StatusBarShowingEventHandler : IUnknown {
       [in] ICoreWebView2StatusBarShowingEventArgs* args);
 }
 
+// Interface for the status bar hiding event handler
+[uuid(96880fd2-ceac-11eb-b8bc-0242ac130003), object, pointer_default(unique)]
 interface ICoreWebView2StatusBarHidingEventHandler : IUnknown {
   /// Called to provide the implementer with the event args for the
   /// corresponding event.
   HRESULT Invoke(
       [in] ICoreWebView2* sender);
 }
+
+[uuid(b2c01782-ceaf-11eb-b8bc-0242ac130003), object, pointer_default(unique)]
+interface ICoreWebView2_5 : ICoreWebView2_4 {
+   /// Add an event handler for the `StatusBarShowing` event.
+  /// `StatusBarShowing` runs when the WebView is showing a message in the
+  /// status bar
+  HRESULT add_StatusBarShowing(
+        [in] ICoreWebView2StatusBarShowingEventHandler* eventHandler,
+        [out] EventRegistrationToken* token);
+
+   /// Add an event handler for the `StatusBarHiding` event.
+  /// `StatusBarHiding` runs when the WebView is hiding the status bar
+  HRESULT add_StatusBarHiding(
+        [in] ICoreWebView2StatusBarHidingEventHandler* eventHandler,
+        [out] EventRegistrationToken* token);
+
+  /// Removing the event handler for `StatusBarShowing` event
+  HRESULT remove_StatusBarShowing(
+      [in] EventRegistrationToken token);
+
+  /// Removing the event handler for `StatusBarHiding` event
+  HRESULT remove_StatusBarHiding(
+      [in] EventRegistrationToken token);
+       
+}
 ```
 ## .Net/ WinRT
 ```
 namespace Microsoft.Web.WebView2.Core {
+/*
+    Interface for the statusbar showing event args
+    The value property contains the status bar text
+*/
     runtimeclass CoreWebView2StatusBarShowingEventArgs {
-        string message {get;};
+        string value {get;};
     }
 
+// Interface for the status bar showing event handler
     runtimeclass CoreWebView2 {
         event Windows.Foundation.TypedEventHandler<CoreWebView2, CoreWebView2StatusBarShowingEventArgs> StatusBarShowingEvent;
     }
 
+// Interface for the status bar hiding event handler
     runtimeclass CoreWebView2 {
         event Windows.Foundation.TypedEventHandler<CoreWebView2> StatusBarHidingEvent;
     }
 }
 ```
-
-
 # Appendix
 <!-- TEMPLATE
     Anything else that you want to write down for posterity, but