Attachmate Reflection 2014 .NET API Reference
GetCharacters Method (IIbmScreen)


The character row position.
The character column position.
The character length.
Gets ScreenCharacter objects from the specified screen location. Each object represents one character.
Syntax
'Declaration
 
Function GetCharacters( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal length As Integer _
) As ScreenCharacter()
'Usage
 
Dim instance As IIbmScreen
Dim row As Integer
Dim column As Integer
Dim length As Integer
Dim value() As ScreenCharacter
 
value = instance.GetCharacters(row, column, length)
ScreenCharacter[] GetCharacters( 
   int row,
   int column,
   int length
)

Parameters

row
The character row position.
column
The character column position.
length
The character length.

Return Value

ScreenCharacter object.
Exceptions
ExceptionDescription
System.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 equal to the number of ScreenCharacter objects. In DBCS, the two numbers may differ. If the last byte is half of a DBCS character, it is not returned.
Requirements

Target Platforms: Microsoft Windows 7, Microsoft Windows Vista, Microsoft Windows XP, Microsoft Windows Server 2003 Terminal Services, Microsoft Windows Server 2008 Terminal Services

See Also

Reference

IIbmScreen Interface
IIbmScreen Members

Send Feedback