Export (0) Print
Expand All

ContainerControl.CurrentAutoScaleDimensions Property

Gets the current run-time dimensions of the screen.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public SizeF CurrentAutoScaleDimensions { get; }

Property Value

Type: System.Drawing.SizeF
A SizeF containing the current dots per inch (DPI) or Font size of the screen.

ExceptionCondition
Win32Exception

A Win32 device context could not be created for the current screen.

The CurrentAutoScaleDimensions property represents the reference dimensions on the current screen. In contrast, the AutoScaleDimensions property represents the design-time reference dimensions of the design environment for the current control, while the AutoScaleFactor property is the ratio of the two.

The interpretation of the dimension value depends on the AutoScaleMode property in the following ways:

  • If the mode is Dpi, this property represents the resolution of the screen, in dots per inch.

  • If the mode is Font, this property represents the average font character size in pixels.

If the AutoScaleMode property is set to None, CurrentAutoScaleDimensions is set equal to AutoScaleDimensions.

For more information about automatic scaling, see Automatic Scaling in Windows Forms.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft