Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
2 changes: 2 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 a different default renderer
href: windows-forms/9.0/statusstrip-renderer.md
- name: WPF
items:
- name: "'GetXmlNamespaceMaps' type change"
Expand Down
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. Minor changes to the appearance of the `StatusStrip` may be observed.

## Change category

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

## Reason for change

The previous default behavior didn't meet accessibility standards.

## 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>
Loading