Control.GetPreferredSize(Size) メソッド

定義

コントロールが収まる四角形の領域のサイズを取得します。Retrieves the size of a rectangular area into which a control can be fitted.

public:
 virtual System::Drawing::Size GetPreferredSize(System::Drawing::Size proposedSize);
public virtual System.Drawing.Size GetPreferredSize (System.Drawing.Size proposedSize);
abstract member GetPreferredSize : System.Drawing.Size -> System.Drawing.Size
override this.GetPreferredSize : System.Drawing.Size -> System.Drawing.Size
Public Overridable Function GetPreferredSize (proposedSize As Size) As Size

パラメーター

proposedSize
Size

コントロールのカスタム サイズ領域。The custom-sized area for a control.

戻り値

四角形の幅と高さを表す、順序を付与した Size 型のペア。An ordered pair of type Size representing the width and height of a rectangle.

実装

System.Windows.Forms.Layout.IArrangedElement.GetPreferredSize(System.Drawing.Size)

注釈

GetPreferredSize の動作は、コントロールによって異なります。The behavior of GetPreferredSize differs by control. LayoutEngine が、返されたサイズをコントロールに割り当てることができない可能性があります。The LayoutEngine might be unable to assign the returned size to the control. proposedSize パラメーターに示されている制約よりも大きいサイズを返すことができますが、制約が減少すると proposedSize が減少します。You can return a size larger than the constraints indicated in the proposedSize parameter, but proposedSize should decrease as the constraint decreases. たとえば、GetPreferredSize(new Size(100, 0))GetPreferredSize(new Size(200, 0)) よりも大きくすることはできません。For example, GetPreferredSize(new Size(100, 0)) should not be wider than GetPreferredSize(new Size(200, 0)). この例外は、無制限として定義されている0または Size.EmptyproposedSize です。The exception is a proposedSize of 0 or Size.Empty, which are defined as unconstrained.

適用対象