dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
725 stars 1.56k forks source link

AutoScaleMode with Font is described that it shrinks/grows, but font size is absolute #10401

Open gh-andre opened 1 month ago

gh-andre commented 1 month ago

Type of issue

Other (describe below)

Description

In this paragraph:

Scaling by Font is useful if you want to have a control or form stretch or shrink according to the size of the fonts in the operating system

, the text describes that controls will shrink/grow depending on font availability in the system, but forms are designed with a specific font type and absolute size, such as 10pt, which means they cannot shrink/grow based on font availability.

If this intends to describe font substitutions, it should say so, but only when the primary intention of this setting is described. If this intends to describe font size changes according to accessibility (Ease of Use), then again, it should describe the primary use and then add that the font size will grow/shrink according to accessibility settings in Windows.

Outside of these contexts, font size should be absolute and should compute to 1/72 of an inch on the screen, regardless of anything else.

Lastly, if Windows interprets pixels in the way that CSS does (arm's length, etc - not actual pixels), that should fall into the DPI settings description, but in case it affects the Font setting as well by changing that dot (pixel) size, this page should call this out explicitly.

Confusion in this area is incredibly widespread and many good apps are illegible because they are designed on different displays, so developers use 8pt fonts that come out as tiniest text possible to 4K displays. Describing this functionality in an unambiguous way will be really helpful.

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.containercontrol.autoscalemode?view=windowsdesktop-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Windows.Forms/ContainerControl.xml

Document Version Independent Id

d3ddf0cc-eca8-4a6f-fcc4-ab6885666d17

Article author

@dotnet-bot