From 00e7703819773ece81c3cc0f6ae2d177a569e757 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 19 Dec 2024 16:54:01 -0600 Subject: [PATCH] StatusStrip breaking change (#44043) * StatusStrip breaking change * dates * Apply suggestions * more suggestion --- docs/core/compatibility/9.0.md | 23 ++++++------ docs/core/compatibility/toc.yml | 3 ++ .../windows-forms/9.0/statusstrip-renderer.md | 37 +++++++++++++++++++ 3 files changed, 52 insertions(+), 11 deletions(-) create mode 100644 docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md diff --git a/docs/core/compatibility/9.0.md b/docs/core/compatibility/9.0.md index 9761602e51bbe..00b52cf876fa6 100644 --- a/docs/core/compatibility/9.0.md +++ b/docs/core/compatibility/9.0.md @@ -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 @@ -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 diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index 69ec5b8149d1e..904c4d7cf4799 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -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" @@ -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 diff --git a/docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md b/docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md new file mode 100644 index 0000000000000..44493a7002283 --- /dev/null +++ b/docs/core/compatibility/windows-forms/9.0/statusstrip-renderer.md @@ -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 + + has been updated to use the default renderer. + +## Version introduced + +.NET 9 + +## Previous behavior + +Previously, the `StatusStrip`'s `RenderMode` property was set to by default. + +## New behavior + + 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 . + +## Affected APIs + +- +-