Vcl.Controls.TControl.SetBounds

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TControl

Beschreibung

Ändert in einem Schritt die Eigenschaften Left, Top, Width und Height.

Mit SetBounds lassen sich alle Begrenzungseigenschaften der Komponente auf einmal festlegen. Sie können dazu auch die Eigenschaften Left, Top, Width und Height einzeln setzen. Jedoch ist durch SetBounds sichergestellt, dass das Steuerelement nicht nach jeder Wertzuweisung neu gezeichnet werden muss.

Die Werte für die Eigenschaften Left, Top, Width und Height werden in den Parametern ALeft, ATop, AWidth und AHeight übergeben.

Der Aufruf von SetBounds führt nicht zwangsläufig zu einer Änderung der Eigenschaften Left, Top, Width und Height, Die neuen Werte können vor der Zuweisung durch AutoSize oder Constraints eingeschränkt und durch eine Ereignisbehandlungsroutine für OnCanResize (oder OnConstrainedResize) angepasst werden. Nachdem die Eigenschaften Left, Top, Width und Height des Steuerelements geändert wurden, generiert SetBounds ein OnResize-Ereignis.

Anmerkung:  Beim Entwickeln eigener Komponenten können Left, Top, Width und Height auch geändert werden, ohne dass Größenänderungen, Beschränkungen und die automatische Größenanpassung berücksichtigt werden. Verwenden Sie in diesem Fall die Methode UpdateBoundsRect.

Siehe auch

Codebeispiele