PutLabelOnLeft

int PutLabelOnLeft (int panel, int ctrl, int labelToCtrlGap);

Purpose

This function places a control's label to the left of the control, centering it vertically with respect to the control.

Since many controls are created with their labels on top, this function can be useful when positioning controls for panels that are created programmatically.

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 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.
labelToCtrlGap integer Specifies the gap in pixels between the right edge of the label and the left edge of the 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.