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

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

注釈

の動作は、 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)). 例外は、 proposedSize Size.Empty 制約なしとして定義されている0またはのです。The exception is a proposedSize of 0 or Size.Empty, which are defined as unconstrained.

適用対象