Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 2 commits into from
Dec 20, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
230 changes: 115 additions & 115 deletions xml/Microsoft.Windows.Themes/BulletChrome.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down
32 changes: 16 additions & 16 deletions xml/Microsoft.Windows.Themes/ButtonChrome.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>|

Expand Down Expand Up @@ -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>|

Expand Down Expand Up @@ -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>|

Expand Down Expand Up @@ -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)|

Expand Down Expand Up @@ -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)|

Expand Down Expand Up @@ -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)|

Expand Down Expand Up @@ -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>|

Expand Down Expand Up @@ -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>|

Expand Down
Loading
Loading