Admin Production ni-theme
Current Publication

PutLabelOnLeft

LabWindows/CVI

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 int 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 int 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 int 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 int 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.

Additional Information

Library: Programmer's Toolbox

Include file: toolbox\toolbox.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later