[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
DEVOUTPICT()
Write a value to the current device using a picture clause
------------------------------------------------------------------------------
Syntax
DEVOUTPICT(<exp>, <cPicture>, [<cColorString>])
--> NIL
Arguments
<exp> is the value to display.
<cPicture> defines the formatting control for the display of <exp>.
The picture specified here is the same as one used with @...SAY or
TRANSFORM and can include both templates and functions.
<cColorString> is an optional argument that defines the display
color of <exp>. If the current DEVICE is SCREEN, output displays in the
specified color.
If not specified, <exp> displays as the standard color of the current
system color as defined by SETCOLOR(). <cColorString> is a character
expression containing the standard color setting. If you want to
specify a literal color setting, it must be enclosed in quote marks.
Returns
DEVOUTPICT() always returns NIL.
Description
DEVOUTPICT() is a full-screen display function that writes the value of
a single expression to the current device at the current cursor or
printhead position. DEVOUTPICT() is used in combination with DEVPOS()
in Std.ch to implement the @...SAY command used with a PICTURE clause.
Examples
. This example shows the relationship between the DEVOUTPICT()
function and the @...SAY command:
DEVPOS(10, 10)
DEVOUTPICT("Hello there", "@!", "BG+/B"))
//
@ 10, 10 SAY "Hello there" PICTURE "@!" COLOR "BG+/B"
Files Library is CLIPPER.LIB.
See Also:
@...SAY
COL()
DEVOUT()
DEVPOS()
QOUT()
ROW()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson