API:Vcl.Controls.TWinControl.SetBounds
Delphi
procedure SetBounds(ALeft, ATop, AWidth, AHeight: Integer); override;
C++
virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TWinControl |
Description
Définit en une seule fois les propriétés Left, Top, Width et Height.
Vcl.Controls.TWinControl.SetBounds hérite de Vcl.Controls.TControl.SetBounds. Tout le contenu en-dessous de cette ligne se réfère à Vcl.Controls.TControl.SetBounds.
Définit en une seule fois les propriétés Left, Top, Width et Height.
Utilisez SetBounds pour changer, en une seule fois, toutes les propriétés de délimitation du composant. Il est possible d'obtenir le même résultat en affectant séparément des valeurs aux propriétés Left, Top, Width et Height. Mais SetBounds modifie les quatre propriétés en une seule fois, évitant ainsi que le contrôle ne se redessine entre les modifications.
Spécifiez les nouvelles valeurs de Left, Top, Width et Height comme valeurs respectives des paramètres ALeft, ATop, AWidth et AHeight.
L'appel de SetBounds ne changera pas obligatoirement les valeurs spécifiées des propriétés Left, Top, Width et Height. Avant que les propriétés puissent être modifiées, la propriété AutoSize ou Constraints peut limiter les modifications et un gestionnaire d'événement OnCanResize (ou OnConstrainedResize) peut changer les nouvelles valeurs. Après que les propriétés Left, Top, Width et Height du contrôle aient été modifiées, SetBounds génère un événement OnResize.
Remarque : Les écrivains de composant peuvent modifier les propriétés Left, Top, Width, et Height tout en remplaçant tous les événements de redimensionnement et les contraintes ou la logique d'autodimensionnement en utilisant plutôt la méthode UpdateBoundsRect.