Update Appearance.md

Author: Jason Stephen

specs/Appearance.md

@@ -1,11 +1,11 @@
-DefaultTheme API
+Theme API
 ===
 
 # Background
-This API's main use is to set the overall appearance for WebView2. The options are similar to Edge: match the system default theme, change to light theme, or change to dark theme. 
+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.
+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. 
 
 ![Alt text](./media/EdgeSettingsAppearance.png "a title")
@@ -15,15 +15,15 @@ For reference, in the screenshot below, this API is meant to expose the Overall
 
 ```cpp
 
-void ViewComponent::SetDefaultTheme(COREWEBVIEW2_DEFAULTCOLORTHEME_KIND value)
+void ViewComponent::SetTheme(COREWEBVIEW2_THEME_KIND value)
 {
 
     wil::com_ptr<ICoreWebView2Controller4> webViewController4;
 
     m_appWindow->GetWebViewController()->QueryInterface(IID_PPV_ARGS(&webViewController4));
     if (webViewController4)
     {
-        CHECK_FAILURE(webViewController4->put_DefaultTheme(value));
+        CHECK_FAILURE(webViewController4->put_Theme(value));
     }
 }
 
@@ -34,9 +34,9 @@ void ViewComponent::SetDefaultTheme(COREWEBVIEW2_DEFAULTCOLORTHEME_KIND value)
 
 private WebView2 m_webview;
 
-void SetDefaultTheme(COREWEBVIEW2_DEFAULT_THEME_KIND value)
+void SetTheme(COREWEBVIEW2_THEME_KIND value)
 {
-    m_webview.CoreWebView2Controller.DefaultTheme = value;
+    m_webview.CoreWebView2Controller.Theme = value;
 }
     
 ```
@@ -47,38 +47,38 @@ void SetDefaultTheme(COREWEBVIEW2_DEFAULT_THEME_KIND value)
 [uuid(5f817cce-5d36-4cd0-a1d5-aaaf95c8685f), object, pointer_default(unique)]
 interface ICoreWebView2Controller4 : ICoreWebView2Controller3 {
 
-  /// The DefaultTheme property sets the overall theme of the webview2 instance. 
-  /// The input parameter is either COREWEBVIEW2_DEFAULT_THEME_KIND_SYSTEM, 
-  /// COREWEBVIEW2_DEFAULT_THEME_KIND_LIGHT, or COREWEBVIEW2_DEFAULT_THEME_KIND_DARK.
-  /// Note that this API applies appearance to WebView2 pages, dialogs, menus,
+  /// 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 `DefaultTheme` property.
-  [propget] HRESULT DefaultTheme(
-  [out, retval] COREWEBVIEW2_DEFAULT_THEME_KIND* value);
+  /// Returns the value of the `Theme` property.
+  [propget] HRESULT Theme(
+  [out, retval] COREWEBVIEW2_THEME_KIND* value);
 
-  /// Sets the `DefaultTheme` property.
-  [propput] HRESULT DefaultTheme(
-    [in] COREWEBVIEW2_DEFAULT_THEME_KIND value);
+  /// Sets the `Theme` property.
+  [propput] HRESULT Theme(
+    [in] COREWEBVIEW2_THEME_KIND value);
 
 }
 ```
 ```
-/// An enum to represent the options for WebView2 DefaultTheme: system, light, or dark.
+/// An enum to represent the options for WebView2 Theme: system, light, or dark.
 
 [v1_enum]
-typedef enum COREWEBVIEW2_DEFAULT_THEME_KIND {
+typedef enum COREWEBVIEW2_THEME_KIND {
 
   /// System theme
-  COREWEBVIEW2_DEFAULT_THEME_KIND_SYSTEM,
+  COREWEBVIEW2_THEME_KIND_SYSTEM,
 
   /// Light theme
-  COREWEBVIEW2_DEFAULT_THEME_KIND_LIGHT,
+  COREWEBVIEW2_THEME_KIND_LIGHT,
 
   /// Dark theme
-  COREWEBVIEW2_DEFAULT_THEME_KIND_DARK
+  COREWEBVIEW2_THEME_KIND_DARK
 
-} COREWEBVIEW2_DEFAULT_THEME_KIND;
+} COREWEBVIEW2_THEME_KIND;
 
 ```
 
@@ -87,7 +87,7 @@ typedef enum COREWEBVIEW2_DEFAULT_THEME_KIND {
 [interface_name("Microsoft.Web.WebView2.Core.ICoreWebView2Controller4")]
 {
     // ICoreWebView2Controller4 members
-    CoreWebView2DefaultThemeKind DefaultTheme { get; set; };
+    CoreWebView2ThemeKind Theme { get; set; };
 
 }
 ```