Skip to content

Commit

Permalink
StatusStrip breaking change (#44043)
Browse files Browse the repository at this point in the history
* StatusStrip breaking change

* dates

* Apply suggestions

* more suggestion
  • Loading branch information
CamSoper authored Dec 19, 2024
1 parent 3a32e42 commit 00e7703
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 11 deletions.
23 changes: 12 additions & 11 deletions docs/core/compatibility/9.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Breaking changes in .NET 9
titleSuffix: ""
description: Navigate to the breaking changes in .NET 9.
ms.date: 08/05/2024
ms.date: 12/19/2024
no-loc: [Blazor, Razor, Kestrel]
---
# Breaking changes in .NET 9
Expand Down Expand Up @@ -117,16 +117,17 @@ If you're migrating an app to .NET 9, the breaking changes listed here might aff

## Windows Forms

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

## WPF

Expand Down
3 changes: 3 additions & 0 deletions docs/core/compatibility/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,8 @@ items:
href: windows-forms/9.0/datagridviewheadercell-nre.md
- name: PictureBox raises HttpClient exceptions
href: windows-forms/9.0/httpclient-exceptions.md
- name: StatusStrip uses different default renderer
href: windows-forms/9.0/statusstrip-renderer.md
- name: WPF
items:
- name: "'GetXmlNamespaceMaps' type change"
Expand Down Expand Up @@ -2040,6 +2042,7 @@ items:
href: windows-forms/9.0/datagridviewheadercell-nre.md
- name: PictureBox raises HttpClient exceptions
href: windows-forms/9.0/httpclient-exceptions.md
- name: StatusStrip uses different default renderer
- name: .NET 8
items:
- name: Anchor layout changes
Expand Down
37 changes: 37 additions & 0 deletions docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: "Breaking change: System.Windows.Forms.StatusStrip uses a different default renderer"
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.
ms.date: 12/19/2024
---
# System.Windows.Forms.StatusStrip uses a different default renderer

<xref:System.Windows.Forms.StatusStrip?displayProperty=nameWithType> has been updated to use the default renderer.

## Version introduced

.NET 9

## Previous behavior

Previously, the `StatusStrip`'s `RenderMode` property was set to <xref:System.Windows.Forms.ToolStripRenderMode.System?displayProperty=nameWithType> by default.

## New behavior

<xref:System.Windows.Forms.StatusStrip?displayProperty=nameWithType> uses the default renderer. You might observe minor changes to the appearance of the `StatusStrip`.

## Change category

This change is a [*behavioral change*](../../categories.md#behavioral-change).

## Reason for change

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.

## Recommended action

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>.

## Affected APIs

- <xref:System.Windows.Forms.StatusStrip?displayProperty=fullName>
- <xref:System.Windows.Forms.ToolStripManager.RenderMode?displayProperty=fullName>

0 comments on commit 00e7703

Please sign in to comment.