Vcl.Controls.TControl.SetZOrder
Delphi
procedure SetZOrder(TopMost: Boolean); dynamic;
C++
DYNAMIC void __fastcall SetZOrder(bool TopMost);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TControl |
Beschreibung
Ändert die Position des Steuerelements in der Komponentenliste seines übergeordneten Objekts und damit auch seine Bildschirmposition.
Mit SetZOrder können Sie die Position des Steuerelements in der Z-Reihenfolge ändern. Wenn das Steuerelement zum obersten Element werden soll, übergeben Sie für TopMost den Wert true. Soll das Steuerelement zuunterst liegen, übergeben Sie false.
Nach dem Ändern der Reihenfolge macht SetZOrder das Steuerelement ungültig, um das Neuzeichnen unter Berücksichtigung der neuen Reihenfolge zu veranlassen.
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 SetZOrder nichts. Die Beschriftung bleibt unter dem Memofeld verborgen.