Write Method  

Write data to virtual display.


object.Write( Buffer, [Length] )


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.
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.


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