Vcl.Controls.TWinControl.CustomAlignPosition

From RAD Studio API Documentation
Jump to: navigation, search

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