RAD Studio VCL Reference
TCustomActionBar.CustomAlignInsertBefore Method

Returns placement order of custom-aligned child control.

function CustomAlignInsertBefore(C1: TControl; C2: TControl): Boolean; override;
virtual __fastcall Boolean CustomAlignInsertBefore(TControl * C1, TControl * C2);

CustomAlignInsertBefore determines the order in which custom-aligned child controls are placed. The control calls CustomAlignInsertBefore once for each pair of child controls with an Align property of alCustom. CustomAlignInsertBefore returns true if C2 should be presented before C1, and false otherwise. 

Once the custom-aligned child controls are sorted, their specific positions are determined by calls to CustomAlignPosition.  

CustomAlignInsertBefore triggers the OnAlignInsertBefore event. If this event is defined, CustomAlignInsertBefore returns the value returned by OnAlignInsertBefore. Defining this event allows users to define the order of control alignment without overriding CustomAlignInsertBefore. 

As implemented in TWinControl, CustomAlignInsertBefore returns false if OnAlignInsertBefore is not implemented, so the controls are placed in the order they appear in the Controls property. 


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!