Edit

Share via


AutoScaleMode Enum

Definition

Specifies the different types of automatic scaling modes supported by Windows Forms.

public enum class AutoScaleMode
public enum AutoScaleMode
type AutoScaleMode = 
Public Enum AutoScaleMode
Inheritance
AutoScaleMode

Fields

Name Value Description
None 0

Automatic scaling is disabled.

Font 1

Controls scale relative to the dimensions of the font the classes are using, which is typically the system font.

Dpi 2

Controls scale relative to the display resolution. Common resolutions are 96 and 120 DPI.

Inherit 3

Controls scale according to the classes' parent's scaling mode. If there is no parent, automatic scaling is disabled.

Remarks

The ContainerControl class and classes derived from it, such as Form, can automatically resize themselves and their contents according to either the current system font or the resolution of the display, measured in dots per inch (DPI). The AutoScaleMode enumeration defines the automatic scaling modes supported by these classes and their derived types. A control's current mode can be accessed through its ContainerControl.AutoScaleMode property.

Most business applications should use the Font automatic scaling mode. The Dpi scaling mode is useful for graphics-based applications and is compatible with the default scaling used by the .NET Compact Framework.

Important

In the .NET Framework versions 1.0 and 1.1, automatic scaling was supported using a simpler mechanism that always relied on the current system font. This mechanism is now obsolete but still supported for backward compatibility. You can obtain the older scaling behavior by setting the AutoScale property of the containing Form to true, which will also implicitly set the ContainerControl.AutoScaleMode property to None. Conversely, setting the ContainerControl.AutoScaleMode property of a form will set AutoScale to false, enabling the newer scaling mechanism introduced with the .NET Framework version 2.0.

Note that for Smartphone applications, this enumeration requires Windows Mobile Version 5.0 software for Smartphones.

Applies to

See also