ContainerControl.CurrentAutoScaleDimensions Property
Definition
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
A SizeF containing the current dots per inch (DPI) or Font size of the screen.
- Attributes
Exceptions
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.