Control.GetPreferredSize メソッド

.NET Framework クラス ライブラリ リファレンス

Control.GetPreferredSize メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コントロールが適合する四角形領域のサイズを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 GetPreferredSize ( _
    proposedSize As Size _
) As Size

Visual Basic (使用法)

Dim instance As Control
Dim proposedSize As Size
Dim returnValue As Size

returnValue = instance.GetPreferredSize(proposedSize)

C#

public virtual Size GetPreferredSize (
    Size proposedSize
)

C++

public:
virtual Size GetPreferredSize (
    Size proposedSize
)

J#

public Size GetPreferredSize (
    Size proposedSize
)

JScript

public function GetPreferredSize (
    proposedSize : Size
) : Size

パラメータ

proposedSize

コントロールのカスタム サイズ領域。

戻り値
四角形の幅と高さを表す、順序を付与した System.Drawing.Size 型のペア。

解説

GetPreferredSize の動作は、コントロールによって異なります。LayoutEngine は、返されたサイズをコントロールに割り当てることができない場合があります。proposedSize パラメータで示される制約よりも大きいサイズを返すことができますが、制約が小さくなるのに合わせて proposedSize を小さくする必要があります。たとえば、GetPreferredSize(new Size(100, 0)) を GetPreferredSize(new Size(200, 0)) より大きくしないでください。例外は、0 の proposedSize または Size.Empty です。これらは制約なしとして定義されています。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間