From RAD Studio API Documentation
Jump to: navigation, search


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


virtual bool __fastcall CustomAlignInsertBefore(TControl* C1, TControl* C2);


Type Visibility Source Unit Parent
function protected
Vcl.Controls TWinControl


Returns placement order of custom-aligned child control.

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.

See Also