Vcl.Controls.TControl.SetBounds

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure SetBounds(ALeft, ATop, AWidth, AHeight: Integer); virtual;

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 TControl

Description

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.

Voir aussi