Vcl.Controls.TControl.SendToBack

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SendToBack;

C++

void __fastcall SendToBack(void);

Eigenschaften

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

Beschreibung

Bringt ein fensterorientiertes Steuerelement hinter alle anderen fensterorientierten Steuerelemente oder bringt ein nicht fensterorientiertes Steuerelement hinter alle anderen nicht fensterorientierten Steuerelemente.

Mit SendToBack können Sie die Anordnung der überlappenden Steuerelemente oder Formulare ändern.

Die Reihenfolge, in der die Steuerelemente übereinander gestapelt werden (die so genannte Z-Reihenfolge), hängt von der Reihenfolge ab, in der die Steuerelemente in das Formular eingefügt wurden. Wenn Sie beispielsweise eine Beschriftung und eine Grafik in ein Formular einfügen, befindet sich das zuerst platzierte Objekt im Hintergrund. Da Beschriftungen und Grafiken nicht fensterorientierte sind, werden sie normal gestapelt. Rufen Sie die Methode SendToBack des oberen Objekts auf, wenn dieses unter dem anderen Objekt platziert werden soll.

Die Stapelreihenfolge für zwei fensterorientierte Steuerelemente ist identisch mit derjenigen für zwei nicht fensterorientierte Steuerelemente. Wenn Sie beispielsweise ein Memofeld in ein Formular einfügen und dann ein Kontrollfeld darüberlegen, bleibt das Kontrollfeld oben. Wenn Sie SendToBack für das Kontrollfeld aufrufen, wird das Memofeld im Vordergrund angezeigt.

Fensterorientierte und nicht fensterorientierte Steuerelemente werden getrennt gestapelt. Wenn Sie beispielsweise ein Memofeld (ein fensterorientiertes Steuerelement) und danach eine Beschriftung (ein nicht fensterorientiertes Steuerelement) in ein Formular einfügen, wird die Beschriftung vom Memofeld verdeckt. Fensterorientierte Steuerelemente befinden sich immer über den nicht fensterorientierten Steuerelementen. In diesem Beispiel bewirkt der Aufruf der Methode SendToBack nichts. Die Beschriftung bleibt unter dem Memofeld verborgen.

Wenn das Steuerelement beim Aufruf von SendToBack aktiv ist, verliert es den Eingabefokus.

Siehe auch