| |
Write data to virtual display.
Syntax
object.Write( Buffer, [Length] )
Parameters
- Buffer
- A buffer variable that contains the data to be written to the
display. If the variable is a String type, then then the data
will be written as a string of characters. This is the most
appropriate data type to use for text data that consists of
printable characters. This method will also accept a Byte
array of characters to be written to the virtual display.
- Length
- A numeric value which specifies the number of bytes to
write. Its maximum value is 231-1 = 2147483647. If a
value is specified for this argument and it is greater than the
actual size of the buffer, then the Length argument will be
ignored and the entire contents of the buffer will be written. If
the argument is omitted, then the maximum number of characters to write
is determined by the size of the buffer.
Return Value
This method returns the number of bytes actually written to the
display, or -1 if an error was encountered.
Remarks
The Write method copies the data in Buffer to the
virtual display at the current cursor location. If the data contains
control characters or escape sequences, they will be processed
according the Emulation property setting.
See Also
CodePage Property,
Emulation Property,
SelText Property
Text Property
|
|