Vcl.Controls.TControl.SetBounds
Delphi
procedure SetBounds(ALeft, ATop, AWidth, AHeight: Integer); virtual;
C++
virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);
Inhaltsverzeichnis
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