Skip to content

Commit 00e7703

Browse files
author
Cam Soper
authored
StatusStrip breaking change (#44043)
* StatusStrip breaking change * dates * Apply suggestions * more suggestion
1 parent 3a32e42 commit 00e7703

File tree

3 files changed

+52
-11
lines changed

3 files changed

+52
-11
lines changed

‎docs/core/compatibility/9.0.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Breaking changes in .NET 9
33
titleSuffix: ""
44
description: Navigate to the breaking changes in .NET 9.
5-
ms.date: 08/05/2024
5+
ms.date: 12/19/2024
66
no-loc: [Blazor, Razor, Kestrel]
77
---
88
# Breaking changes in .NET 9
@@ -117,16 +117,17 @@ If you're migrating an app to .NET 9, the breaking changes listed here might aff
117117

118118
## Windows Forms
119119

120-
| Title | Type of change | Introduced version |
121-
|-----------------------------------------------------------------------------------------|---------------------|--------------------|
122-
| [BindingSource.SortDescriptions doesn't return null](windows-forms/9.0/sortdescriptions-return-value.md) | Behavioral change | Preview 1 |
123-
| [Changes to nullability annotations](windows-forms/9.0/nullability-changes.md) | Source incompatible | Preview 1 |
124-
| [ComponentDesigner.Initialize throws ArgumentNullException](windows-forms/9.0/componentdesigner-initialize.md) | Behavioral change | Preview 1 |
125-
| [DataGridViewRowAccessibleObject.Name starting row index](windows-forms/9.0/datagridviewrowaccessibleobject-name-row.md) | Behavioral change | Preview 1 |
126-
| [IMsoComponent support is opt-in](windows-forms/9.0/imsocomponent-support.md) | Behavioral change | Preview 2 |
127-
| [New security analyzers](windows-forms/9.0/security-analyzers.md) | Source incompatible | RC 1 |
128-
| [No exception if DataGridView is null](windows-forms/9.0/datagridviewheadercell-nre.md) | Behavioral change | Preview 1 |
129-
| [PictureBox raises HttpClient exceptions](windows-forms/9.0/httpclient-exceptions.md) | Behavioral change | Preview 6 |
120+
| Title | Type of change | Introduced version |
121+
|--------------------------------------------------------------------------------------------------------------------------|---------------------|--------------------|
122+
| [BindingSource.SortDescriptions doesn't return null](windows-forms/9.0/sortdescriptions-return-value.md) | Behavioral change | Preview 1 |
123+
| [Changes to nullability annotations](windows-forms/9.0/nullability-changes.md) | Source incompatible | Preview 1 |
124+
| [ComponentDesigner.Initialize throws ArgumentNullException](windows-forms/9.0/componentdesigner-initialize.md) | Behavioral change | Preview 1 |
125+
| [DataGridViewRowAccessibleObject.Name starting row index](windows-forms/9.0/datagridviewrowaccessibleobject-name-row.md) | Behavioral change | Preview 1 |
126+
| [IMsoComponent support is opt-in](windows-forms/9.0/imsocomponent-support.md) | Behavioral change | Preview 2 |
127+
| [New security analyzers](windows-forms/9.0/security-analyzers.md) | Source incompatible | RC 1 |
128+
| [No exception if DataGridView is null](windows-forms/9.0/datagridviewheadercell-nre.md) | Behavioral change | Preview 1 |
129+
| [PictureBox raises HttpClient exceptions](windows-forms/9.0/httpclient-exceptions.md) | Behavioral change | Preview 6 |
130+
| [StatusStrip uses a different default renderer](windows-forms/9.0/statusstrip-renderer.md) | Behavioral change | GA |
130131

131132
## WPF
132133

‎docs/core/compatibility/toc.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,8 @@ items:
142142
href: windows-forms/9.0/datagridviewheadercell-nre.md
143143
- name: PictureBox raises HttpClient exceptions
144144
href: windows-forms/9.0/httpclient-exceptions.md
145+
- name: StatusStrip uses different default renderer
146+
href: windows-forms/9.0/statusstrip-renderer.md
145147
- name: WPF
146148
items:
147149
- name: "'GetXmlNamespaceMaps' type change"
@@ -2040,6 +2042,7 @@ items:
20402042
href: windows-forms/9.0/datagridviewheadercell-nre.md
20412043
- name: PictureBox raises HttpClient exceptions
20422044
href: windows-forms/9.0/httpclient-exceptions.md
2045+
- name: StatusStrip uses different default renderer
20432046
- name: .NET 8
20442047
items:
20452048
- name: Anchor layout changes

‎docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: "Breaking change: System.Windows.Forms.StatusStrip uses a different default renderer"
3+
description: Learn about the breaking change in .NET 9 for Windows Forms where System.Windows.Forms.StatusStrip uses a different default value for the RenderMode property.
4+
ms.date: 12/19/2024
5+
---
6+
# System.Windows.Forms.StatusStrip uses a different default renderer
7+
8+
<xref:System.Windows.Forms.StatusStrip?displayProperty=nameWithType> has been updated to use the default renderer.
9+
10+
## Version introduced
11+
12+
.NET 9
13+
14+
## Previous behavior
15+
16+
Previously, the `StatusStrip`'s `RenderMode` property was set to <xref:System.Windows.Forms.ToolStripRenderMode.System?displayProperty=nameWithType> by default.
17+
18+
## New behavior
19+
20+
<xref:System.Windows.Forms.StatusStrip?displayProperty=nameWithType> uses the default renderer. You might observe minor changes to the appearance of the `StatusStrip`.
21+
22+
## Change category
23+
24+
This change is a [*behavioral change*](../../categories.md#behavioral-change).
25+
26+
## Reason for change
27+
28+
The previous default behavior didn't meet accessibility standards. The focus indicator over the `ToolStripSplitButton` was difficult to see due to the lack of contrast.
29+
30+
## Recommended action
31+
32+
The new behavior is recommended for accessibility reasons. If you want to revert to the previous behavior, set the `RenderMode` property to <xref:System.Windows.Forms.ToolStripRenderMode.System?displayProperty=nameWithType>.
33+
34+
## Affected APIs
35+
36+
- <xref:System.Windows.Forms.StatusStrip?displayProperty=fullName>
37+
- <xref:System.Windows.Forms.ToolStripManager.RenderMode?displayProperty=fullName>

0 commit comments

Comments
 (0)