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.