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

SystemParameters.xml: corrects MenuDropAlignment #6780

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

NReilingh
Copy link

Summary

I believe this to be a documentation bug related to incorrect default values shipped in Windows Server at least versions 2012-2016. (Basically, if you took a fresh Windows Server install in a typical US localization and set up Remote Desktop Services, the menus inside RDS would all be right-aligned, which is opposite to how consumer systems typically ship in the US.)

This is a one-word change which is confirmed by observed behavior when setting the HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows\MenuDropAlignment key to 0 (false, left-aligned) vs 1 (true, right-aligned).

This is also supported by the SystemParametersInfo documentation linked in Remarks:

https://github.com/MicrosoftDocs/sdk-api/blame/92b6682a0c74356473c471312bc114b2af8b3ff3/sdk-api-src/content/winuser/nf-winuser-systemparametersinfoa.md#L1619-L1629

https://github.com/MicrosoftDocs/sdk-api/blame/92b6682a0c74356473c471312bc114b2af8b3ff3/sdk-api-src/content/winuser/nf-winuser-systemparametersinfoa.md#L1652-L1662

Visual example for what it means to be left- or right-aligned relative to the current menu item:

<summary>Gets a value indicating whether pop-up menus are left-aligned or right-aligned, relative to the corresponding menu item.</summary>

Left-aligned, standard in US/western locales using left-to-right text
leftalign

Right-aligned, available as an accessibility setting in Windows and from the above-referenced registry setting being set to 1.
rightalign

I believe this to be a documentation bug related to incorrect default values shipped in Windows Server at least versions 2012-2016. (Basically, if you took a fresh Windows Server install in a typical US localization and set up Remote Desktop Services, the menus inside RDS would all be right-aligned, which is opposite to how consumer systems typically ship in the US.)

This is a one-word change which is confirmed by observed behavior when setting the HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows\MenuDropAlignment key to 0 (false, left-aligned) vs 1 (true, right-aligned).

This is also supported by the SystemParametersInfo documentation linked in Remarks.
@dotnet-issue-labeler dotnet-issue-labeler bot added the area-WPF Issues or PRs that relate to WPF or XAML. label May 30, 2021
@opbld30
Copy link

opbld30 commented May 30, 2021

Docs Build status updates of commit 9303a4c:

✅ Validation status: passed

File Status Preview URL Details
xml/System.Windows/SystemParameters.xml ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@gewarren gewarren requested a review from a team October 14, 2021 20:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-WPF Issues or PRs that relate to WPF or XAML.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants