ReturnCode PutText( 
   string text,
   int row,
   int column,
   int length
)

'Declaration
 
Overloads Function PutText( _
   ByVal text As String, _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal length As Integer _
) As ReturnCode

'Usage
 
Dim instance As IIbmScreen
Dim text As String
Dim row As Integer
Dim column As Integer
Dim length As Integer
Dim value As ReturnCode
 
value = instance.PutText(text, row, column, length)

Parameters

text

Text to put on screen.

row

Row position on which to put the text.

column

Column position on which to put the text.

length

Number of byte positions available for the text. If the text string is longer than "length", the text is truncated. Text can span more than one field.

Return Value

The following examples show the differences between the using the Mask and LinearStream modes on the following screen.

Using PutText methods in Mask mode

This example shows how PutText pastes text into a screen when PutTextMaskProtectedField is set to mask.

....

IFrame frame = (IFrame)app.GetObject("Frame");
frame.CreateView(terminal);

string str = "This is a test to see if any memo text is being cut off unexpectedly and sent in full";

IIbmScreen screen = terminal.Screen;
screen.PutTextMaskProtectedField = PutTextModeOption.Mask;
screen.PutText(str, 5, 10, 85);

....

The protected fields are masked. The parts of the text string that coincide with the protected fields are skipped and are not placed on the screen.

Using PutText methods in LinearStream mode

This example shows how the PutText method pastes text into a screen when PutTextMaskProtectedField is set to LinearStream.

....

IFrame frame = (IFrame)app.GetObject("Frame");
frame.CreateView(terminal);

string str = "This is a test to see if any memo text is being cut off unexpectedly and sent in full";

IIbmScreen screen = terminal.Screen;
screen.PutTextMaskProtectedField = PutTextModeOption.LinearStream;
screen.PutText(str, 5, 10, 85);

....

The protected fields are ignored and the text is pasted into the next unprotected field (In this example, the "unexpectedly an" part of the string is put into hidden fields PWD1 and PWD2). All of the text is placed on the screen.

Reference

IIbmScreen Interface
IIbmScreen Members
Overload List