add docs for rc1 experimental apis

Author: lonitra

xml/System.Windows.Forms/Application.xml

@@ -252,9 +252,14 @@
         <ReturnType>System.Windows.Forms.SystemColorMode</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the default color mode (dark mode) for the application.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <para>
+            This is the <see cref="P:System.Windows.Forms.Application.SystemColorMode" />; which either has been set by <see cref="M:System.Windows.Forms.Application.SetColorMode(System.Windows.Forms.SystemColorMode)" /> or its default value <see cref="F:System.Windows.Forms.SystemColorMode.Classic" />. 
+            If it has been set to <see cref="F:System.Windows.Forms.SystemColorMode.System" />, then the actual color mode is determined by the system settings (which can be retrieved by the static (shared in VB) <see cref="P:System.Windows.Forms.Application.SystemColorMode" /> property.
+          </para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CommonAppDataPath">
@@ -982,9 +987,11 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+          Gets a value indicating whether the application is running in a dark system color context.
+        </summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>In a high contrast mode, this will always return <see langword="false" /></remarks>
       </Docs>
     </Member>
     <Member MemberName="LeaveThreadModal">
@@ -1811,9 +1818,25 @@
         <Parameter Name="systemColorMode" Type="System.Windows.Forms.SystemColorMode" Index="0" FrameworkAlternate="windowsdesktop-9.0" />
       </Parameters>
       <Docs>
-        <param name="systemColorMode">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="systemColorMode">The application's default color mode (dark mode) to set.</param>
+        <summary>Sets the default color mode (dark mode) for the application.</summary>
+        <remarks>
+          <para>
+            You should use this method to set the default color mode (dark mode) for the application. Set it, before creating any UI elements, to ensure that the correct color mode 
+            is used. You can set it to dark mode (<see cref="F:System.Windows.Forms.SystemColorMode.Dark" />), light mode (<see cref="F:System.Windows.Forms.SystemColorMode.Classic" />) 
+            or to the system setting (<see cref="F:System.Windows.Forms.SystemColorMode.System" />).
+          </para>
+          <para>
+            If you set it to <see cref="F:System.Windows.Forms.SystemColorMode.System" />, the actual color mode is determined by the Windows system settings. If the system setting is changed, 
+            the application will not automatically adapt to the new setting.
+          </para>
+          <para>
+            Note that the dark color mode is only available from Windows 11 on or later versions. If the system is set to a high contrast mode, the dark mode is not available.
+          </para>
+          <para>
+            <b>Note for Visual Basic:</b> If you are using the Visual Basic Application Framework, you should set the color mode by handling the Application Events (see "WindowsFormsApplicationBase.ApplyApplicationDefaults").
+          </para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetCompatibleTextRenderingDefault">
@@ -2226,9 +2249,16 @@ The high DPI mode is set once per process. For more information about setting th
         <ReturnType>System.Windows.Forms.SystemColorMode</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the system color mode setting of the OS system environment.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <para>
+            The color setting is determined based on the operating system version and its system settings. It returns <see cref="F:System.Windows.Forms.SystemColorMode.Dark" /> if the dark mode is enabled in the system settings, 
+            <see cref="F:System.Windows.Forms.SystemColorMode.Classic" /> if the color mode equals the light, standard color setting.
+          </para>
+          <para>SystemColorMode is supported on Windows 11 or later versions.</para>
+          <para>SystemColorModes is not supported, if the Windows OS <c>High Contrast Mode</c> has been enabled in the system settings.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ThreadException">

xml/System.Windows.Forms/ButtonBase.xml

@@ -1040,6 +1040,7 @@ For example, consider a button control whose <xref:System.Windows.Forms.ImageLis
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="value" /> is less than -1.</exception>
         <altmember cref="T:System.Windows.Forms.ImageList" />
+        <inheritdoc cref="P:System.Windows.Forms.ButtonBase.ImageKey" />
       </Docs>
     </Member>
     <Member MemberName="ImageKey">

xml/System.Windows.Forms/ButtonRenderer.xml

@@ -110,6 +110,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">
@@ -154,6 +155,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">
@@ -202,6 +204,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">
@@ -277,6 +280,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">
@@ -341,6 +345,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">
@@ -414,6 +419,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawButton(System.Drawing.Graphics,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawButton">

xml/System.Windows.Forms/CheckBoxRenderer.xml

@@ -110,6 +110,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox(System.Drawing.Graphics,System.Drawing.Point,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.CheckBoxState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawCheckBox">
@@ -178,6 +179,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox(System.Drawing.Graphics,System.Drawing.Point,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.CheckBoxState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawCheckBox">
@@ -253,6 +255,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox(System.Drawing.Graphics,System.Drawing.Point,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.CheckBoxState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawCheckBox">
@@ -328,6 +331,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox(System.Drawing.Graphics,System.Drawing.Point,System.Drawing.Rectangle,System.String,System.Drawing.Font,System.Windows.Forms.TextFormatFlags,System.Drawing.Image,System.Drawing.Rectangle,System.Boolean,System.Windows.Forms.VisualStyles.CheckBoxState)" />
       </Docs>
     </Member>
     <Member MemberName="DrawCheckBox">
@@ -433,6 +437,7 @@
         <param name="childControl">The control whose parent's background will be drawn.</param>
         <summary>Draws the background of a control's parent in the specified area.</summary>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.DrawParentBackground(System.Drawing.Graphics,System.Drawing.Rectangle,System.Windows.Forms.Control)" />
       </Docs>
     </Member>
     <Member MemberName="GetGlyphSize">
@@ -514,6 +519,7 @@
         <returns>
           <see langword="true" /> if the background of the check box has semitransparent or alpha-blended pieces; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:System.Windows.Forms.ButtonRenderer.IsBackgroundPartiallyTransparent(System.Windows.Forms.VisualStyles.PushButtonState)" />
       </Docs>
     </Member>
     <Member MemberName="RenderMatchingApplicationState">
@@ -559,6 +565,7 @@
   
  ]]></format>
         </remarks>
+        <inheritdoc cref="P:System.Windows.Forms.ButtonRenderer.RenderMatchingApplicationState" />
       </Docs>
     </Member>
   </Members>