ContainerControl.CurrentAutoScaleDimensions Property

Note: This property is new in the .NET Framework version 2.0.

Gets the current run-time dimensions of the screen.

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

public SizeF CurrentAutoScaleDimensions { get; }
/** @property */
public SizeF get_CurrentAutoScaleDimensions ()

public function get CurrentAutoScaleDimensions () : SizeF

Property Value

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

Exception typeCondition


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. For more information about font dimensions, see the System.Drawing.GDI.WindowsGraphics.GetTextMetrics method.

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.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0