GetData

Returns an array of data specified by the plane. For VT emulation, only FlexPlane.Text is supported and all others are returned as zero.


Syntax

FlexScreen.GetData(StartPos, EndPos, FlexPlane)


Parameters


StartPos

Integer, input



Integer value of the zero based starting screen position, which may be obtained by using the FlexScreen.Position method.


EndPos

Integer, input



Integer value of the zero based ending screen position, which may be obtained by using the FlexScreen.Position method.


FlexPlane

Integer, input



Determines the plane of data to return for the specified field.


Remarks

The planes available for use with the GetData method are:

FlexPlane.Text
Text displayed at the specified field location.

FlexPlane.Color
Color of the text displayed at the specified field location.

FlexPlane.Field
Field attributes (a sparse array containing field attributes) at the specified field location; non-field locations will contain the character set (0 = default, 1 = APL)

FlexPlane.Extended
Field extended attributes (a sparse array containing extended attributes) at the specified field location.


Example

Sub Main()

Data = FlexScreen.GetData(FlexScreen.Position(2,47), FlexScreen.Position(2,56), FlexPlane.Text)

Text = ""

For i=0 To 9

Text = Text + Chr(Data(i))

Next

MsgBox Text

End Sub