Error getting tags :
error 404Error getting tags :
error 404 revPrintField | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
revPrintField
Basics
Expander triangle
Type
Command
Syntax
revPrintField fieldDescriptor
Introduced
1.0
Environment
Desktop,Web
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
Printing
Summary
Prints the contents of a field.
Examples

revPrintField the name of field "Comments"
revPrintField the long ID of the mouseControl
revPrintField ("field" && 5) -- prints field 5

Additional Comments
Expander triangle

Use the revPrintField command to print the formatted contents of a field from within a handler.

Parameters:

The fieldDescriptor is any expression that evaluates to a field reference.

Important! The revPrintFieldcommand does not accept direct field references. For example, the following statement causes an error message:

revPrintField field "My Field" -- CAN'T USE THIS FORM

Instead, use a form that evaluates to a field reference, like this:

revPrintField the name of field "My Field" -- use this form instead

revPrintField ("field" && quote & "My Field" & quote) -- or this

Comments:

The revPrintField command is equivalent to selecting the field and choosing File menuPrint Field.

If the field contains any expressions of the form &expression%>, the expression is evaluated and replaced with the value before the field is printed. For example, if the field contains the text

Today's date is <%the long date%>

the printed text reads

Today's date is Friday, February 15, 2002

(This assumes, of course, that the revPrintField command is executed on that date). You can also use the special value <%pageNumber%> in the field: this value is replaced with the page number.

To show the standard print dialog box, use the revShowPrintDialog command before the revPrintField command.

Important! The revPrintFieldcommand is part of the Printing library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions section on the General screen of the Standalone Application Settings window, make sure that "Printing" is selected in the list of script libraries.

Note: When included in a standalone application, the Printing library is implemented as a hidden group and made available when the group receives its first openBackground message. During the first part of the application's startup process, before this message is sent, the revPrintFieldcommand is not yet available. This may affect attempts to use this command in startup, preOpenStack, openStack, or preOpenCardhandlers in the main stack. Once the application has finished starting up, the library is available and the revPrintFieldcommand can be used in any handler.

User Comments
Expander triangle