# PositionCtrlRelativeToCtrl

int PositionCtrlRelativeToCtrl (int panel, int ctrl, int considerLabel, int ctrlToMove, int considerCtrlToMoveLabel, int gap, PositionCtrlSide whichSide, positionCtrlJustification justification);

## Purpose

This function moves one control relative to another on a panel.

## Parameters

Input
Name | Type | Description
panel | integer | The specifier for a particular panel that is currently in memory. This handle will have been returned by the LoadPanel, NewPanel, or DuplicatePanel function.
ctrl | integer | Pass the ID of the control which the other control will be moved relative to. This control is called the reference control. The ID is the defined constant (located in the UIR header file) which was assigned to the control in the User Interface Editor, or the ID returned by the NewCtrl or DuplicateCtrl function.
considerLabel | integer | Turn this option on if you want this function to include the label of the reference control when moving the other control.
ctrlToMove | integer | Pass the ID of the control to move relative to the other control. The ID is the defined constant (located in the UIR header file) which was assigned to the control in the User Interface Editor, or the ID returned by the NewCtrl or DuplicateCtrl function.
considerCtrlToMoveLabel | integer | Turn this option on if you also want to move the label of the control as well as the control itself.
gap | integer | The final distance in pixels between the two controls.
whichSide | PositionCtrlSide | The second control is moved to this side of the reference control.
justification | PositionCtrlJustification | Specify the justification of the moved control relative to the reference control.

## Return Value

Name | Type | Description
status | integer | Returns 0 if the function succeeded or a negative error code if the function failed. The possible negative error codes are:
–1 to –999 | A User Interface Library error code. (constants are available in userint.h)
A description of any of these error codes can be obtained using the GetGeneralErrorString function in the toolbox.fp instrument driver.