@@ -21,12 +21,12 @@ namespace System.Windows.Forms;
2121public sealed partial class Application
2222{
2323 /// <summary>
24- /// Hash table for our event list
24+ /// Hash table for our event list.
2525 /// </summary>
2626 private static EventHandlerList ? s_eventHandlers ;
2727 private static Font ? s_defaultFont ;
2828 /// <summary>
29- /// Scaled version of non system <see cref="s_defaultFont"/>.
29+ /// Scaled version of non- system <see cref="s_defaultFont"/>.
3030 /// </summary>
3131 private static Font ? s_defaultFontScaled ;
3232 private static string ? s_startupPath ;
@@ -50,7 +50,7 @@ public sealed partial class Application
5050 private const int SystemDarkModeDisabled = 1 ;
5151
5252 /// <summary>
53- /// Events the user can hook into
53+ /// Events the user can hook into.
5454 /// </summary>
5555 private static readonly object s_eventApplicationExit = new ( ) ;
5656 private static readonly object s_eventThreadExit = new ( ) ;
@@ -65,16 +65,16 @@ public sealed partial class Application
6565 private static bool s_parkingWindowCreated ;
6666
6767 /// <summary>
68- /// This class is static, there is no need to ever create it.
68+ /// This class is static; there is no need to ever create it.
6969 /// </summary>
7070 private Application ( )
7171 {
7272 }
7373
7474 /// <summary>
7575 /// Determines if the caller should be allowed to quit the application. This will return false,
76- /// for example, if being called from a windows forms control being hosted within a web browser. The
77- /// windows forms control should not attempt to quit the application.
76+ /// for example, if being called from a Windows Forms control being hosted within a web browser. The
77+ /// Windows Forms control should not attempt to quit the application.
7878 /// </summary>
7979 public static bool AllowQuit => ThreadContext . GetAllowQuit ( ) ;
8080
@@ -271,8 +271,8 @@ internal static bool CustomThreadExceptionHandlerAttached
271271 /// to apply the new system setting.
272272 /// </para>
273273 /// <para>
274- /// Note that Dark Mode is only available on Windows 11 and later. If Windows is set to High Contrast mode,
275- /// that mode always takes precedence over other settings .
274+ /// Note that the dark color mode is only available from Windows 11 on or later versions . If the system
275+ /// is set to a accessibility contrast theme, the dark mode is not available .
276276 /// </para>
277277 /// <para>
278278 /// <b>Note for Visual Basic:</b> If you are using the Visual Basic Application Framework, set the color mode
@@ -389,14 +389,15 @@ static void NotifySystemEventsOfColorChange()
389389 /// <remarks>
390390 /// <para>
391391 /// The color setting is determined based on the operating system version and its system settings.
392- /// It returns <see cref="SystemColorMode.Dark"/> if the dark mode is enabled in the system settings,
393- /// <see cref="SystemColorMode.Classic"/> if the color mode equals the light, standard color setting.
392+ /// It returns <see cref="SystemColorMode.Dark"/> if dark mode is enabled in the system settings,
393+ /// or <see cref="SystemColorMode.Classic"/> if the color mode is set to the light, standard color setting.
394394 /// </para>
395395 /// <para>
396- /// SystemColorMode is supported on Windows 11 or later versions.
396+ /// <see cref=" SystemColorMode"/> is supported on Windows 11 or later versions.
397397 /// </para>
398398 /// <para>
399- /// SystemColorModes is not supported, if the Windows OS <c>High Contrast Mode</c> has been enabled in the system settings.
399+ /// <see cref="SystemColorMode"/> is not supported if a Windows OS high contrast theme has been
400+ /// enabled in the system settings.
400401 /// </para>
401402 /// </remarks>
402403 public static SystemColorMode SystemColorMode =>
@@ -434,7 +435,7 @@ private static int GetSystemColorModeInternal()
434435
435436 /// <summary>
436437 /// Gets a value indicating whether the application is running in a dark system color context.
437- /// Note: In a high contrast mode , this will always return <see langword="false"/>.
438+ /// Note: With a accessibility contrast theme selected in the OS , this will always return <see langword="false"/>.
438439 /// </summary>
439440 public static bool IsDarkModeEnabled =>
440441 ! SystemInformation . HighContrast
@@ -949,7 +950,7 @@ internal static void DoEventsModal()
949950
950951 /// <summary>
951952 /// Enables visual styles for all subsequent <see cref="Run()"/> and <see cref="Control.CreateHandle"/> calls.
952- /// Uses the default theming manifest file shipped with the redist .
953+ /// Uses the default theming manifest file shipped with the redistributable package .
953954 /// </summary>
954955 [ UnconditionalSuppressMessage ( "SingleFile" , "IL3002" , Justification = "Single-file case is handled" ) ]
955956 public static void EnableVisualStyles ( )
@@ -1363,6 +1364,10 @@ internal static void RunDialog(Form form)
13631364 /// This switch determines the default text rendering engine to use by some controls that support
13641365 /// switching rendering engine.
13651366 /// </summary>
1367+ /// <param name="defaultValue">The default value to use for compatible text rendering.</param>
1368+ /// <exception cref="InvalidOperationException">
1369+ /// Thrown if any window handle has already been created in the application.
1370+ /// </exception>
13661371 public static void SetCompatibleTextRenderingDefault ( bool defaultValue )
13671372 {
13681373 if ( NativeWindow . AnyHandleCreated )
@@ -1374,7 +1379,7 @@ public static void SetCompatibleTextRenderingDefault(bool defaultValue)
13741379 }
13751380
13761381 /// <summary>
1377- /// Sets the default <see cref="Font"/> for process.
1382+ /// Sets the default <see cref="Font"/> for the process.
13781383 /// </summary>
13791384 /// <param name="font">The font to be used as a default across the application.</param>
13801385 /// <exception cref="ArgumentNullException"><paramref name="font"/> is <see langword="null"/>.</exception>
@@ -1383,11 +1388,11 @@ public static void SetCompatibleTextRenderingDefault(bool defaultValue)
13831388 /// </exception>
13841389 /// <remarks>
13851390 /// <para>
1386- /// The system text scale factor will be applied to the font, i.e. if the default font is set to "Calibri, 11f"
1387- /// and the text scale factor is set to 150% the resulting default font will be set to "Calibri, 16.5f".
1391+ /// The system text scale factor will be applied to the font. For example, if the default font is set to "Calibri, 11f"
1392+ /// and the text scale factor is set to 150%, the resulting default font will be set to "Calibri, 16.5f".
13881393 /// </para>
13891394 /// <para>
1390- /// Users can adjust text scale with the Make text bigger slider on the Settings -> Ease of Access -> Vision/ Display screen.
1395+ /// Users can adjust text scale with the " Make text bigger" slider on the Settings → Accessibility → Display screen.
13911396 /// </para>
13921397 /// </remarks>
13931398 /// <seealso href="https://docs.microsoft.com/windows/uwp/design/input/text-scaling">Windows Text scaling</seealso>
@@ -1403,7 +1408,7 @@ public static void SetDefaultFont(Font font)
14031408 }
14041409
14051410 /// <summary>
1406- /// Scale <see cref="s_defaultFont"/> or <see cref="s_defaultFontScaled"/> if needed.
1411+ /// Scales <see cref="s_defaultFont"/> or <see cref="s_defaultFontScaled"/> if needed.
14071412 /// </summary>
14081413 internal static void ScaleDefaultFont ( )
14091414 {
0 commit comments