[Sytem.Windows*] Add table headers for accessibility (#10777)

dotnet · Dec 20, 2024 · d09267e · d09267e
1 parent 7c9c5f9
commit d09267e
Show file tree

Hide file tree

Showing 352 changed files with 51,242 additions and 51,255 deletions.
diff --git a/xml/Microsoft.Windows.Themes/BulletChrome.xml b/xml/Microsoft.Windows.Themes/BulletChrome.xml
@@ -52,25 +52,25 @@
   <Docs>
     <summary>Creates the theme-specific look for Windows Presentation Foundation (WPF) <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> elements. A <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> defines the appearance of <see cref="T:System.Windows.Controls.CheckBox" /> and <see cref="T:System.Windows.Controls.RadioButton" /> elements.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The actual appearance of the <xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> is dependent on which theme is active on the user's system. The properties of this class allow WPF to set the appearance based on the current theme.  
-  
- In XAML usage, a <xref:Microsoft.Windows.Themes.BulletChrome> object element can also have child content, which can be a single <xref:System.Windows.UIElement> that sets the <xref:System.Windows.Controls.Decorator.Child%2A> property.  
-  
-<a name="xamlObjectElementUsage_BulletChrome"></a>   
-## XAML Object Element Usage  
-  
-```  
-<theme:BulletChrome .../>  
-```  
-  
-<a name="xamlValues_BulletChrome"></a>   
-## XAML Values  
- `theme:`  
- An xmlns prefix for the <xref:Microsoft.Windows.Themes> CLR namespace. Typically, xmlns prefixes and mappings are defined in a XAML root element (not shown).  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The actual appearance of the <xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> is dependent on which theme is active on the user's system. The properties of this class allow WPF to set the appearance based on the current theme.
+
+ In XAML usage, a <xref:Microsoft.Windows.Themes.BulletChrome> object element can also have child content, which can be a single <xref:System.Windows.UIElement> that sets the <xref:System.Windows.Controls.Decorator.Child%2A> property.
+
+<a name="xamlObjectElementUsage_BulletChrome"></a>
+## XAML Object Element Usage
+
+```
+<theme:BulletChrome .../>
+```
+
+<a name="xamlValues_BulletChrome"></a>
+## XAML Values
+ `theme:`
+ An xmlns prefix for the <xref:Microsoft.Windows.Themes> CLR namespace. Typically, xmlns prefixes and mappings are defined in a XAML root element (not shown).
+
  ]]></format>
     </remarks>
   </Docs>
@@ -187,18 +187,18 @@
         <summary>Gets or sets the brush used to fill the background of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</summary>
         <value>The brush used to fill the background of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-<a name="dependencyPropertyInfo_Background"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BackgroundProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<a name="dependencyPropertyInfo_Background"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BackgroundProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|
+
  ]]></format>
         </remarks>
       </Docs>
@@ -312,18 +312,18 @@
         <summary>Gets or sets the brush used to draw the outer border of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</summary>
         <value>The brush used to draw the outer border of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-<a name="dependencyPropertyInfo_BorderBrush"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BorderBrushProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<a name="dependencyPropertyInfo_BorderBrush"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BorderBrushProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|
+
  ]]></format>
         </remarks>
       </Docs>
@@ -418,19 +418,19 @@
         <summary>Gets or sets the thickness used to draw the outer border of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</summary>
         <value>The thickness used to draw the border of the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This property is not available in the Windows Aero theme.  
-  
-<a name="dependencyPropertyInfo_BorderThickness"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BorderThicknessProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A>, <xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This property is not available in the Windows Aero theme.
+
+<a name="dependencyPropertyInfo_BorderThickness"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.BorderThicknessProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A>, <xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|
+
  ]]></format>
         </remarks>
       </Docs>
@@ -526,33 +526,33 @@
         <value>
           <see langword="true" /> if the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> is checked; <see langword="false" /> if the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> is not checked; otherwise, <see langword="null" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This property only applies when the <xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> is a <xref:System.Windows.Controls.RadioButton> or <xref:System.Windows.Controls.CheckBox>.  
-  
- If the object used for the bullet supports an `IsThreeState` property, and the value of that property is `true`, then a value of `null` is potentially user-settable. Otherwise, the value of <xref:Microsoft.Windows.Themes.BulletChrome.IsChecked%2A> cannot be set to `null` by user action, but it can be set that way in markup or code.  
-  
-<a name="dependencyPropertyInfo_IsChecked"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.IsCheckedProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|  
-  
-<a name="xamlAttributeUsage_IsChecked"></a>   
-## XAML Attribute Usage  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This property only applies when the <xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> is a <xref:System.Windows.Controls.RadioButton> or <xref:System.Windows.Controls.CheckBox>.
+
+ If the object used for the bullet supports an `IsThreeState` property, and the value of that property is `true`, then a value of `null` is potentially user-settable. Otherwise, the value of <xref:Microsoft.Windows.Themes.BulletChrome.IsChecked%2A> cannot be set to `null` by user action, but it can be set that way in markup or code.
+
+<a name="dependencyPropertyInfo_IsChecked"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.IsCheckedProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
+
+<a name="xamlAttributeUsage_IsChecked"></a>
+## XAML Attribute Usage
+
 ```xaml
-<object IsChecked="bool"/>  
+<object IsChecked="bool"/>
 ```
 
--or- 
+-or-
 
 ```xaml
-<object IsChecked="x:Null"/>  
-```  
+<object IsChecked="x:Null"/>
+```
 
  ]]></format>
         </remarks>
@@ -668,19 +668,19 @@
         <value>
           <see langword="true" /> if the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> has round corners; otherwise <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When set to `false`, the corners are square.  
-  
-<a name="dependencyPropertyInfo_IsRound"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.IsRoundProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When set to `false`, the corners are square.
+
+<a name="dependencyPropertyInfo_IsRound"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.IsRoundProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|
+
  ]]></format>
         </remarks>
       </Docs>
@@ -914,18 +914,18 @@
         <value>
           <see langword="true" /> if the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> appears as if the mouse is over it; otherwise <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-<a name="dependencyPropertyInfo_RenderMouseOver"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.RenderMouseOverProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<a name="dependencyPropertyInfo_RenderMouseOver"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.RenderMouseOverProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
+
  ]]></format>
         </remarks>
       </Docs>
@@ -1040,18 +1040,18 @@
         <value>
           <see langword="true" /> if the <see cref="P:System.Windows.Controls.Primitives.BulletDecorator.Bullet" /> appears pressed; otherwise <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-<a name="dependencyPropertyInfo_RenderPressed"></a>   
-## Dependency Property Information  
-  
-|||  
-|-|-|  
-|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.RenderPressedProperty>|  
-|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<a name="dependencyPropertyInfo_RenderPressed"></a>
+## Dependency Property Information
+
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
+|Identifier field|<xref:Microsoft.Windows.Themes.BulletChrome.RenderPressedProperty>|
+|Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
+
  ]]></format>
         </remarks>
       </Docs>

diff --git a/xml/Microsoft.Windows.Themes/ButtonChrome.xml b/xml/Microsoft.Windows.Themes/ButtonChrome.xml
@@ -234,8 +234,8 @@
 <a name="dependencyPropertyInfo_Background"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.BackgroundProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|
 
@@ -339,8 +339,8 @@
 <a name="dependencyPropertyInfo_BorderBrush"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.BorderBrushProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|
 
@@ -446,8 +446,8 @@
 <a name="dependencyPropertyInfo_Fill"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.FillProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>, <xref:System.Windows.FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender%2A>|
 
@@ -673,8 +673,8 @@
 <a name="dependencyPropertyInfo_RenderDefaulted"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.RenderDefaultedProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
 
@@ -799,8 +799,8 @@
 <a name="dependencyPropertyInfo_RenderMouseOver"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.RenderMouseOverProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
 
@@ -925,8 +925,8 @@
 <a name="dependencyPropertyInfo_RenderPressed"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.RenderPressedProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A> (however, this property might not be set in all themes)|
 
@@ -1032,8 +1032,8 @@
 <a name="dependencyPropertyInfo_RoundCorners"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.RoundCornersProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|
 
@@ -1109,8 +1109,8 @@
 <a name="dependencyPropertyInfo_ThemeColor"></a>
 ## Dependency Property Information
 
-|||
-|-|-|
+| Item             | Value                                                    |
+|------------------|----------------------------------------------------------|
 |Identifier field|<xref:Microsoft.Windows.Themes.ButtonChrome.ThemeColorProperty>|
 |Metadata properties set to `true`|<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>|