GetCtrlValStringLength

int GetCtrlValStringLength (int panelHandle, int controlID, int *numberOfCharacters);

Purpose

Returns the number of bytes (excluding the ASCII NUL byte) in the text value for the control.

Parameters

Input
Name Type Description
panelHandle integer The specifier for a particular panel that is currently in memory.

You obtain the handle by calling the LoadPanel, NewPanel, or DuplicatePanel function.
controlID integer The defined constant (located in the UIR header file) that you assign to the control in the User Interface Editor, or the ID that you obtain by calling the NewCtrl or DuplicateCtrl function.
Output
Name Type Description
numberOfCharacters integer * Returns the number of bytes (excluding the ASCII NUL byte) in the text value for the control.

Return Value

Name Type Description
status integer Returns a negative error code if an error occurs.