style fixes

Author: schuylergleaves

specs/Appearance.md

@@ -2,77 +2,76 @@ Theme API
 ===
 
 # Background
-This API's main use is to set the overall appearance/theme for WebView2. The options are similar to Edge: match the system default theme, change to light theme, or change to dark theme. 
-This API has 2 main changes relevant to the end users. First, it sets appearance for WebView2 UI like dialogs, prompts, context menu, etc. And second, this API sets the ['prefers-color-scheme'](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme) [media feature](https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries#media_features). Websites typically media query for this setting in order to set CSS themes for light/dark. 
+This API's main use is to set the overall appearance/theme for WebView2. The options are similar to Edge: match the system default theme, change to light theme, or change to dark theme.
+This API has 2 main changes relevant to the end users. First, it sets appearance for WebView2 UI like dialogs, prompts, context menu, etc. And second, this API sets the ['prefers-color-scheme'](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme) [media feature](https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries#media_features). Websites typically media query for this setting in order to set CSS themes for light/dark.
 
 Please note this API will only set the overall appearance, but not theme as defined in the Edge browser.
-For reference, in the screenshot below, this API is meant to expose the Overall Appearance section as a WebView2 API. 
+For reference, in the screenshot below, this API is meant to expose the Overall Appearance section as a WebView2 API.
 
 ![Alt text](./media/EdgeSettingsAppearance.png "a title")
 # Examples
 
-### C++
+## C++
 
 ```cpp
+wil::com_ptr<ICoreWebView2Controller> m_controller;
 
 void ViewComponent::SetTheme(COREWEBVIEW2_THEME_KIND value)
 {
-    
-    wil::com_ptr<ICoreWebView2Controller4> webViewController4;
+    wil::com_ptr<ICoreWebView2Controller4> m_controller;
 
-    m_appWindow->GetWebViewController()->QueryInterface(IID_PPV_ARGS(&webViewController4));
+    CHECK_FAILURE(m_controller->QueryInterface(IID_PPV_ARGS(&webViewController4)));
     if (webViewController4)
     {
         CHECK_FAILURE(webViewController4->put_Theme(value));
     }
 }
-    
 ```
-### C#
+
+## C#
 
 ```c#
 
 private CoreWebView2Controller m_controller;
 
 void SetTheme(CoreWebView2ThemeKind value)
 {
+    // Check for runtime support
     try
     {
         m_controller.Theme = value;
     }
-    catch (Exception)
+    catch (NotImplementedException exception)
     {
-    // if theme api isnt supported in CoreWebView2Controller ignore the call.
+        MessageBox.Show(this, "Set Theme Failed: " + exception.Message,
+                        "Set Theme");
     }
 }
-    
+
 ```
 
 # API Details
-
+## C++
 ```
 [uuid(5f817cce-5d36-4cd0-a1d5-aaaf95c8685f), object, pointer_default(unique)]
 interface ICoreWebView2Controller4 : ICoreWebView2Controller3 {
-
-  /// The Theme property sets the overall theme of the webview2 instance. 
-  /// The input parameter is either COREWEBVIEW2_THEME_KIND_SYSTEM, 
+  /// The Theme property sets the overall theme of the WebView2 instance.
+  /// The input parameter is either COREWEBVIEW2_THEME_KIND_SYSTEM,
   /// COREWEBVIEW2_THEME_KIND_LIGHT, or COREWEBVIEW2_THEME_KIND_DARK.
   /// Note that this API applies theme to WebView2 pages, dialogs, menus,
-  /// and sets the media feature `prefers-color-scheme` for websites to respond to. 
-  
-  /// Returns the value of the `Theme` property.
+  /// and sets the media feature `prefers-color-scheme` for websites to respond to.
+  ///
+  /// \snippet ViewComponents.cpp SetAppearance
+  /// Returns the value of the `Appearance` property.
   [propget] HRESULT Theme(
-  [out, retval] COREWEBVIEW2_THEME_KIND* value);
+    [out, retval] COREWEBVIEW2_THEME_KIND* value);
 
   /// Sets the `Theme` property.
   [propput] HRESULT Theme(
     [in] COREWEBVIEW2_THEME_KIND value);
-
 }
-```
-```
-/// An enum to represent the options for WebView2 Theme: system, light, or dark.
 
+/// An enum to represent the options for WebView2 Theme: system, light, or dark.
 [v1_enum]
 typedef enum COREWEBVIEW2_THEME_KIND {
 
@@ -86,28 +85,31 @@ typedef enum COREWEBVIEW2_THEME_KIND {
   COREWEBVIEW2_THEME_KIND_DARK
 
 } COREWEBVIEW2_THEME_KIND;
-
 ```
 
-### WinRT
+### C#
 ```
 namespace Microsoft.Web.WebView2.Core
 {
+    [doc_string("An enum to represent the options for WebView2 Theme: system, light, or dark.")]
     enum CoreWebView2ThemeKind
     {
+        [doc_string("System theme.")]
         System = 0,
+        [doc_string("Light theme.")]
         Light = 1,
+        [doc_string("Dark theme.")]
         Dark = 2,
     };
-    
+
     unsealed runtimeclass CoreWebView2Controller
     {
-    //... 
+        // ...
+
         [interface_name("Microsoft.Web.WebView2.Core.ICoreWebView2Controller4")]
         {
             // ICoreWebView2Controller4 members
             CoreWebView2ThemeKind Theme { get; set; };
-
         }
     }
 }