Set the value of an unprotected field-- will not throw an exception if the attribute is actually protected based on the context of the active data on the screen.

 

 

Arguments

 

HostScreen

 Required. HostScreen object.

 

Offset

 Required. The offset position on the host screen.

 

length

Required - will force padding of the field using the active paddingChar and without use of bounding attributes to determine the length of text to set.

 

rightAdjust

Required - when true, 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.  If the field is not writable, no action is taken and no exception is thrown.

 

The following c# example sets two fields by row and column to their respective parameter values, then sets a system name if available.

 

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

 {

         oScreen.setText(10, 56, userID);

         oScreen.setText(11, 56, pw);

         oScreen.trySetText(1020, "SYS212", 8, false);

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

 }

 

Requirements

 

Flynet Viewer

 

See Also

 

mappedSet | putKeys | putCommand | paddingMode | paddingChar | setText

 

Applies To: HostScreen object