ContainerControl.CurrentAutoScaleDimensions Property

Gets the current run-time dimensions of the screen.

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

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

public function get CurrentAutoScaleDimensions () : SizeF

Not applicable.

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.

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 Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

.NET Compact Framework

Supported in: 2.0

Community Additions