GetCharacters Method (IbmScreen)

In This Topic

Gets ScreenCharacter objects from the specified location, each representing one character at a screen location.

Syntax

Visual Basic (Declaration)

expression.GetCharacters( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal length As Integer _
) As ScreenCharacter() object

where expression is a variable that represents a IbmScreen Object

Parameters

row: Row location.
column: Column location.
length: Characters length.

Return Value

Screen characters on the host screen. This is an array of ScreenCharacter Objects.

Exceptions

Exception	Description
ArgumentOutOfRangeException	This exception is thrown if the row or column parameters are outside the range of valid values: (1 to Rows) or (1 to Columns).

Remarks

The length argument specifies the number of screen bytes to get. In SBCS, the number of screen bytes is the same as that of ScreenCharacter objects. In DBCS, the two numbers can be different. If the last byte is only half of a DBCS character, the last byte is not returned.

Reference

IbmScreen Object
IbmScreen Members

Send Feedback