Programming with Text Box Controls

Use SetCtrlVal to append text to a text box control. SetCtrlVal then scrolls the text box to display the appended text. Use ResetTextBox to replace the text in a text box with new text. Use GetNumTextBoxLines to determine the number of lines of text in a text box. InsertTextBoxLine, ReplaceTextBoxLine, GetTextBoxLine and DeleteTextBoxLine operate on individual lines of text.

Use GetCtrlVal to obtain the current text of a text box control. Use GetCtrlAttribute with the ATTR_STRING_TEXT_LENGTH attribute to determine the size of the buffer to pass to GetCtrlVal. Keep in mind that GetCtrlVal appends a NULL byte to the end of the text string, so you must make the buffer 1 byte larger than the value returned by GetCtrlAttribute.

Data Binding

Linux Data binding is not supported on Linux.

You can bind text box controls to a DataSocket source. Controls can have only one DataSocket connection. You must specify whether the access mode is READ mode or WRITE mode:

Use DSBindCtrlDSBindCtrl to bind a text box control to a DataSocket source. Use DSUnbindDSUnbind to disconnect the text box control from the DataSocket source.

The DataSocket source must hold text data.

You must enable the DataSocket option in the Edit Installer dialog box Drivers & ComponentsDrivers & Components tab if your applications use data binding.