System.Windows.Forms.Control.GetPreferredSize Method

Retrieves the size of a rectangular area into which a control can be fitted.

Syntax

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)]
public virtual System.Drawing.Size GetPreferredSize (System.Drawing.Size proposedSize)

Parameters

proposedSize
The custom-sized area for a control.

Returns

An ordered pair of type System.Drawing.Size representing the width and height of a rectangle.

Remarks

The behavior of Control.GetPreferredSize(System.Drawing.Size) differs by control. The Control.LayoutEngine might be unable to assign the returned size to the control. You can return a size larger than the constraints indicated in the proposedSize parameter, but proposedSize should decrease as the constraint decreases. For example, GetPreferredSize(new Size(100, 0)) should not be wider than GetPreferredSize(new Size(200, 0)). The exception is a proposedSize of 0 or Size.Empty, which are defined as unconstrained.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0