Controls.TControl.SetBounds

Informations Delphi

De Controls.pas

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

Unité : Controls

Type : méthode

Visibilité : public

Membre de : TControl

Informations C++

De Controls.hpp

	virtual void __fastcall SetBounds(int ALeft,
		int ATop,
		int AWidth,
		int AHeight);

Unité : Controls

Type : méthode

Visibilité : public

Membre de : 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.