setText

Set the value of an unprotected field.

void setText(int row, int column, String value);

void setText(int offset, String value);

void setText(int row, int column, String value, int length);

void setText(int row, int column, String value, int length, bool rightAdjust);

Arguments

HostScreen

Required. HostScreen object.

Offset

Required. The offset position on the host screen.

row

Required if not offset form. The row number on the host screen.

column

Required if not offset form. The column number on the host screen.

length

Optional - if included, will force padding of the field using the active paddingChar and without use of bounding attributes to determine the length of text to set. If length is omitted, the attributes bounding the row/column/offset will be used to determine the length, and the value of the paddingMode will be used to determine if padding is performed.

rightAdjust

Optional - if included, will right-adjust the data within the length provided. Use this for right-adjust fields, in conjunction with the length value.

Value

Required. The text string to put into the field.

Remarks

If the offset (or row, col position) is not at the beginning of the field, the text will start at the beginning of the field. The field will be cleared before entering the value. Note that for a field that may have its attribute set to protected depending on context that this method will throw an exception. If you want to write to fields that may not be writable at execution time and not have any error occur, use the trySetText method.

The following c# example sets two fields by row and column to their respective parameter values

bool Signon(HostScreen oScreen, string userID, string pw)

{

oScreen.setText(10, 56, userID);

oScreen.setText(11, 56, pw);

return oScreen.putCommand("[enter]", 30000); // wait up to 30 seconds

}

Requirements

Flynet Viewer

setText Method
setText Method