diff --git a/xml/System.Windows/Application.xml b/xml/System.Windows/Application.xml
index 4bfa99989ca..efdec80b3de 100644
--- a/xml/System.Windows/Application.xml
+++ b/xml/System.Windows/Application.xml
@@ -2476,9 +2476,28 @@ This example illustrates how to use XAML together with application-scope resourc
System.Windows.ThemeMode
- To be added.
+ Gets or sets the Fluent theme mode of the application.
To be added.
- To be added.
+
+ Setting this property controls if Fluent theme is loaded in Light, Dark or System mode.
+ It also controls the application of backdrop and darkmode on window.
+ The four values for the ThemeMode enum are :
+
+ - No Fluent theme is loaded.
+
+ - Fluent theme is loaded based on the system theme.
+
+ - Fluent theme is loaded in Light mode.
+
+ - Fluent theme is loaded in Dark mode.
+ These values are predefined in struct The default value is .
+
+ and are designed to be in sync with each other.
+ Syncing is done in order to avoid UI inconsistencies, where the window is in dark mode but the controls within are in light mode or vice versa.
+ Setting this property loads the Fluent theme dictionaries in the application resources.
+ So, if you set this property, it is preferrable to not include Fluent theme dictionaries in the application resources manually. If you do, the Fluent theme dictionaries added in the application resources will take precedence over the ones added by setting this property.
+ This property is experimental and may be removed in future versions.
+
diff --git a/xml/System.Windows/SystemColors.xml b/xml/System.Windows/SystemColors.xml
index eb776245a19..0a146adedab 100644
--- a/xml/System.Windows/SystemColors.xml
+++ b/xml/System.Windows/SystemColors.xml
@@ -50,7 +50,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the system accent color that's set by the user in OS settings.
To be added.
To be added.
@@ -71,9 +71,13 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+
+
+ is the system accent color that's set by the user in OS settings.
+ When is , this property returns .
+
@@ -92,7 +96,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -113,7 +117,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the dark shade of the system accent color.
To be added.
To be added.
@@ -134,9 +138,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -155,7 +159,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -176,7 +180,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -197,7 +201,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the darker shade of the system accent color.
To be added.
To be added.
@@ -218,9 +222,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -239,7 +243,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -260,7 +264,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -281,7 +285,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the darkest shade of the system accent color.
To be added.
To be added.
@@ -302,9 +306,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -323,7 +327,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -344,7 +348,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -365,7 +369,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -386,7 +390,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the light shade of the system accent color.
To be added.
To be added.
@@ -407,9 +411,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -428,7 +432,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -449,7 +453,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -470,7 +474,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the lighter shade of the system accent color.
To be added.
To be added.
@@ -491,9 +495,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -512,7 +516,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -533,7 +537,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -554,7 +558,7 @@
System.Windows.Media.Color
- To be added.
+ Gets the lightest shade of the system accent color.
To be added.
To be added.
@@ -575,9 +579,9 @@
System.Windows.Media.SolidColorBrush
- To be added.
+ Gets the brush corresponding to the color.
To be added.
- To be added.
+ When is , this property returns .
@@ -596,7 +600,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
@@ -617,7 +621,7 @@
System.Windows.ResourceKey
- To be added.
+ Gets the system resource key.
To be added.
To be added.
diff --git a/xml/System.Windows/ThemeMode.xml b/xml/System.Windows/ThemeMode.xml
index afae25cd0cf..45ff43cee8b 100644
--- a/xml/System.Windows/ThemeMode.xml
+++ b/xml/System.Windows/ThemeMode.xml
@@ -28,8 +28,11 @@
- To be added.
- To be added.
+ Describes the Fluent theme mode to apply to an application or window.
+
+ This is an experimental API and may be modified or removed in future releases.
+ Since this is an experimental API, rather than creating a new instance of ThemeMode, use the static properties Light, Dark, System, and None.
+
@@ -48,8 +51,8 @@
- To be added.
- To be added.
+ The name of the theme mode
+ Creates a new ThemeMode object with the specified value.
To be added.
@@ -69,9 +72,11 @@
System.Windows.ThemeMode
- To be added.
+ Gets the Dark predefined theme mode.
To be added.
- To be added.
+
+ Whenever this mode is set on or , Fluent Dark theme will be applied.
+
@@ -93,9 +98,10 @@
- To be added.
- To be added.
- To be added.
+ ThemeMode object to compare with.
+ Checks whether this instance is equal to another ThemeMode object.
+
+ if the ThemeMode objects are equal; otherwise.
To be added.
@@ -121,9 +127,10 @@
- To be added.
- To be added.
- To be added.
+ ThemeMode object to compare with
+ Checks whether this instance is equal to another ThemeMode object.
+
+ if the ThemeMode objects are equal; otherwise.
To be added.
@@ -144,8 +151,8 @@
- To be added.
- To be added.
+ Computes the hash code for this object.
+ A 32-bit signed integer hash code.
To be added.
@@ -165,9 +172,11 @@
System.Windows.ThemeMode
- To be added.
+ Gets the Light predefined theme mode.
To be added.
- To be added.
+
+ Whenever this mode is set on or , Fluent Light theme will be applied.
+
@@ -186,9 +195,14 @@
System.Windows.ThemeMode
- To be added.
+
+ Gets the None predefined theme mode.
+
To be added.
- To be added.
+
+ This is the default value for and and it means that Fluent theme will not be applied on the application or window.
+ In case, when is not set to None, even if is set to None, the Fluent theme will be applied on the window.
+
@@ -211,10 +225,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The first ThemeMode object to compare.
+ The second ThemeMode object to compare.
+ Checks whether two ThemeMode objects are equal.
+
+ if the ThemeMode objects are equal; otherwise.
To be added.
@@ -238,10 +253,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The first ThemeMode object to compare.
+ The second ThemeMode object to compare.
+ Checks whether two ThemeMode objects are not equal.
+
+ if the ThemeMode objects are not equal; otherwise.
To be added.
@@ -261,9 +277,11 @@
System.Windows.ThemeMode
- To be added.
+ Get the System predefined theme mode.
To be added.
- To be added.
+
+ Whenever this mode is set on or , Fluent theme will be applied based on the system theme.
+
@@ -283,8 +301,8 @@
- To be added.
- To be added.
+ Creates a string representation of the ThemeMode object.
+ A string representation of this object.
To be added.
@@ -304,7 +322,7 @@
System.String
- To be added.
+ Gets the value of the ThemeMode.
To be added.
To be added.
diff --git a/xml/System.Windows/ThemeModeConverter.xml b/xml/System.Windows/ThemeModeConverter.xml
index 7fe8ec90ab5..e81cc97521e 100644
--- a/xml/System.Windows/ThemeModeConverter.xml
+++ b/xml/System.Windows/ThemeModeConverter.xml
@@ -20,7 +20,7 @@
- To be added.
+ Converts instances of other types to and from ThemeMode instances.
To be added.
@@ -61,10 +61,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The ITypeDescriptorContext for this call.
+ The Type being queried for support.
+ Determines whether or not this class can convert from a given type.
+
+ if the converter can convert from the provided type; otherwise, .
To be added.
@@ -88,10 +89,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The ITypeDescriptorContext for this call.
+ The Type being queried for support.
+ Determines whether or not this class can convert to a given type.
+
+ if this converter can convert to the provided type; otherwise, .
To be added.
@@ -116,12 +118,13 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The ITypeDescriptorContext for this call.
+ The CultureInfo which is respected when converting.
+ The object to convert to a .
+ Attempts to convert to a from the specified object
+ The new instance.
To be added.
+ The example object is .
@@ -146,13 +149,17 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The ITypeDescriptorContext for this call.
+ The CultureInfo which is respected when converting.
+ The to convert.
+ The type to which to convert the ThemeMode instance.
+ Attempts to convert a object to the specified type.
+ The newly constructed object.
To be added.
+
+ is .
+
+ is or not a , or isn't a valid destination type.
diff --git a/xml/System.Windows/Window.xml b/xml/System.Windows/Window.xml
index b18daecd9d6..63cf03302a2 100644
--- a/xml/System.Windows/Window.xml
+++ b/xml/System.Windows/Window.xml
@@ -2597,9 +2597,28 @@ The following example shows a **File** > **Exit** menu being handled to explicit
System.Windows.ThemeMode
- To be added.
+ Gets or sets the Fluent theme mode of the window.
To be added.
- To be added.
+
+ Setting this property controls if Fluent theme is loaded in Light, Dark or System mode.
+ It also controls the application of backdrop and darkmode on window.
+ The four values for the ThemeMode enum are :
+
+ - No Fluent theme is loaded. However, if is not None, then the window will appear as defined in .
+
+ - Fluent theme is loaded based on the system theme.
+
+ - Fluent theme is loaded in Light mode.
+
+ - Fluent theme is loaded in Dark mode.
+ These values are predefined in struct The default value is .
+
+ and are designed to be in sync with each other.
+ Syncing is done in order to avoid UI inconsistencies, where the window is in dark mode but the controls within are in light mode or vice versa.
+ Setting this property loads the Fluent theme dictionaries in the window resources.
+ So, if you set this property, it is preferrable to not include Fluent theme dictionaries in the window resources manually. If you do, the Fluent theme dictionaries added in the window resources will take precedence over the ones added by setting this property.
+ This property is experimental and may be removed in future versions.
+