Vcl.Controls.TWinControl.CustomAlignPosition

• Up to Parent: TWinControl

Delphi

procedure CustomAlignPosition(Control: TControl; var NewLeft, NewTop, NewWidth,  NewHeight: Integer; var AlignRect: TRect; AlignInfo: TAlignInfo); virtual;

C++

virtual void __fastcall CustomAlignPosition(TControl* Control, int &NewLeft, int &NewTop, int &NewWidth, int &NewHeight, System::Types::TRect &AlignRect, const TAlignInfo &AlignInfo);

Properties

Type	Visibility	Source	Unit	Parent
procedure function	protected	Vcl.Controls.pas Vcl.Controls.hpp	Vcl.Controls	TWinControl

Description

Returns aligned position of custom-aligned child control.

CustomAlignPosition determines the specific position of custom-aligned child controls. CustomAlignPosition is called once for each child control with an Align property of alCustom, in an order previously determined by calls to CustomAlignInsertBefore.

CustomAlignPosition triggers the OnAlignPosition event. If this event is defined, CustomAlignPosition uses the alignment parameters it obtains from OnAlignPosition. Defining this event allows users to set the alignment parameters without overriding CustomAlignPosition.

These are the parameters:

Control	The child control being placed.
NewLeft | NewTop | NewWidth | NewHeight	Location and size of child control, as determined by container's size and the Anchors TControl_Anchors constraints for the control. CustomAlignPosition can modify these values to reposition the control.
AlignRect	The client area in which the control is aligned. CustomAlignPosition can modify this value.
AlignInfo	Alignment information in a TAlignInfo.
As implemented in TWinControl, CustomAlignPosition does nothing.

See Also

• CustomAlignInsertBefore

• Align

• OnAlignPosition

• TAlignInfo