Vcl.Controls.TControl.CanAutoSize
Delphi
function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; virtual;
C++
virtual bool __fastcall CanAutoSize(int &NewWidth, int &NewHeight);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TControl |
説明
コントロールが中身に合わせてサイズを自動的に変更できるかどうかを示します。
CanAutoSize メソッドは，AutoSize プロパティが true の場合にコントロールをサイズ変更しようとしたときに自動的に呼び出されます。このメソッドにより，コントロールは OnCanResize イベントと OnConstrainedResize イベントで始まり OnResize イベントで終わるサイズ変更シーケンスの前に，AutoSize プロパティを実装できます。
CanAutoSize メソッドが呼び出されると，NewWidth パラメータと NewHeight パラメータでコントロールの新しい寸法が示されます。CanAutoSize はそれらの値を調整して，コントロールのサイズがその内容に合わせて調整されるようにします。調整の結果，NewWidth および NewHeight の値がコントロールの現在の高さおよび幅と異なる場合，CanAutoSize は true を返し，サイズ変更シーケンスが処理されることを示します。調整の後で，NewWidth および NewHeight が Width および Height に等しい場合，CanAutoSize は true を返し，サイズ変更シーケンスは中止されます。
TControl での CanAutoSize は，NewWidth または NewHeight を変更することなく，常に true を返します。CanAutoSize をオーバーライドすると，特定のコントロールクラスの内容の AutoSize プロパティを実装できます。