Control.GetScaledBounds Method (System.Windows.Forms)

.NET Framework Class Library

Control..::.GetScaledBounds Method

Retrieves the bounds within which the control is scaled.

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

Syntax

Visual Basic (Declaration)

Protected Overridable Function GetScaledBounds ( _
    bounds As Rectangle, _
    factor As SizeF, _
    specified As BoundsSpecified _
) As Rectangle

Visual Basic (Usage)

Dim bounds As Rectangle
Dim factor As SizeF
Dim specified As BoundsSpecified
Dim returnValue As Rectangle

returnValue = Me.GetScaledBounds(bounds, _
    factor, specified)

protected virtual Rectangle GetScaledBounds(
    Rectangle bounds,
    SizeF factor,
    BoundsSpecified specified
)

Visual C++

protected:
virtual Rectangle GetScaledBounds(
    Rectangle bounds, 
    SizeF factor, 
    BoundsSpecified specified
)

JScript

protected function GetScaledBounds(
    bounds : Rectangle, 
    factor : SizeF, 
    specified : BoundsSpecified
) : Rectangle

Parameters

bounds: Type: System.Drawing..::.Rectangle
A Rectangle that specifies the area for which to retrieve the display bounds.

factor: Type: System.Drawing..::.SizeF
The height and width of the control's bounds.

specified: Type: System.Windows.Forms..::.BoundsSpecified
One of the values of BoundsSpecified that specifies the bounds of the control to use when defining its size and position.

Return Value

Type: System.Drawing..::.Rectangle
A Rectangle representing the bounds within which the control is scaled.

Remarks

This is a helper method that is called by ScaleControl to retrieve the bounds within which the control is scaled. You can override this method to reuse the ScaleControl scaling logic, but you must supply your own bounds. The default implementation returns scaled bounds that take into account the specified bounds, whether the control is top level, whether the control is fixed width or auto size, and any adornments the control might have.

Platforms

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

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

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

.NET Compact Framework

Supported in: 3.5, 2.0

Reference

Control Class

Control Members

System.Windows.Forms Namespace

ScaleControl

Scale

ScaleChildren