Vcl.Controls.TControl.CanAutoSize
Delphi
function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; virtual;
C++
virtual bool __fastcall CanAutoSize(int &NewWidth, int &NewHeight);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TControl |
Description
Indique si le contrôle peut se redimensionner automatiquement pour s'adapter à son contenu.
CanAutoSize est appelée automatiquement quand la propriété AutoSize vaut true et qu'une tentative de redimensionnement du contrôle est effectuée. Elle permet aux contrôles d'implémenter la propriété AutoSize avant que la séquence de redimensionnement commence par les événements OnCanResize et OnConstrainedResize et se termine par l'événement OnResize.
Quand CanAutoSize est appelée, les paramètres NewWidth et NewHeight indiquent les nouvelles dimensions proposées du contrôle. CanAutoSize ajuste ces valeurs afin que la taille des contrôles s'adapte à leur contenu. Si l'ajustement a pour résultat des valeurs de NewWidth et de NewHeight différentes de la largeur et de la hauteur actuelles du contrôle, CanAutoSize renvoie true, indiquant que la séquence de redimensionnement doit avoir lieu. Si, après ajustement, les valeurs de NewWidth et NewHeight sont équivalentes à Width et Height, CanAutoSize renvoie true, et la séquence de redimensionnement est abandonnée.
Telle qu'implémentée dans TControl, CanAutoSize renvoie toujours true sans changer NewWidth ni NewHeight. Redéfinissez CanAutoSize afin d'implémenter la propriété AutoSize pour un contenu de classe contrôle particulier.