Print Method

Applies To

Debug Object.

Description

Prints text in the Immediate pane of the Debug window.

Syntax

object.Print outputlist

The Print method syntax has the following object qualifier and part:

Part	Description
object	Optional. An object expression that evaluates to an object in the Applies To list.
outputlist	Optional. Expression or list of expressions to print. If omitted, a blank line is printed.

The outputlist argument has the following syntax and parts:

{Spc(n) | Tab(n)} expression charpos

Part	Description
Spc(n)	Optional. Used to insert space characters in the output, where n is the number of space characters to insert.
Tab(n)	Optional. Used to position the insertion point at an absolute column number where n is the column number. Use Tab with no argument to position the insertion point at the beginning of the next print zone.
expression	Optional. Numeric or string expressions to print.
charpos	Optional. Specifies the insertion point for the next character. Use a semicolon to position the insertion point immediately following the last character displayed. Use Tab(n) to position the insertion point at an absolute column number. Use Tab with no argument to position the insertion point at the beginning of the next print zone. If charpos is omitted, the next character is printed on the next line.

Remarks

Multiple expressions can be separated with either a space or a semicolon. A space has the same effect as a semicolon.

All data printed to the Immediate pane is internationally aware; that is, the data is properly formatted (using the appropriate decimal separator) and the keywords are output in the language appropriate for the international locale specified for your system.

For Boolean data, either True or False is printed. The True and False keywords are translated, as appropriate, according to the locale setting specified for your system.

Date data is written using the standard short date format recognized by your system. When either the date or the time component is missing or zero, only the data provided is written.

Nothing is written if outputlist data is Empty. However, if outputlist data is Null, Null is output. Again, the Null keyword is translated, as appropriate, when output.

For error data, the output is written as Error errorcode. The Error keyword is translated, as appropriate, when output.

Note Because the Print method normally prints with proportionally-spaced characters, it is important to remember that there is no correlation between the number of characters printed and the number of fixed-width columns those characters occupy. For example, a wide letter, such as a “W”, occupies more than one fixed-width column, whereas a narrow letter, such as an “i”, occupies less. To account for cases where wider than average characters are used, you must ensure that your tabular columns are positioned far enough apart. Alternatively, you can print using a fixed-pitch font (such as Courier) to ensure that each character uses only one column.

Example

Using the Print method, this example displays the value of the variable MyVar in the Immediate pane of the Debug window. Note that the Print method only applies to objects that can display text.