ContainerControl.CurrentAutoScaleDimensions Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: ContainerControl.cs

Source:: ContainerControl.cs

Source:: ContainerControl.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the current run-time dimensions of the screen.

public:
 property System::Drawing::SizeF CurrentAutoScaleDimensions { System::Drawing::SizeF get(); };

[System.ComponentModel.Browsable(false)]
public System.Drawing.SizeF CurrentAutoScaleDimensions { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CurrentAutoScaleDimensions : System.Drawing.SizeF

Public ReadOnly Property CurrentAutoScaleDimensions As SizeF

Property Value

SizeF

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

Attributes: BrowsableAttribute

Exceptions

Win32Exception

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

Remarks

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.

Applies to

Del via