RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomActionMainMenuBar.CustomAlignPosition Method

Returns aligned position of custom-aligned child control.

Pascal
procedure CustomAlignPosition(Control: TControl; var NewLeft: Integer; var NewTop: Integer; var NewWidth: Integer; var NewHeight: Integer; var AlignRect: TRect; AlignInfo: TAlignInfo); override;
C++
virtual __fastcall CustomAlignPosition(TControl * Control, int NewLeft, int NewTop, int NewWidth, int NewHeight, TRect AlignRect, TAlignInfo AlignInfo);

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.  
 

 

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