PrintImage()

<< Click to Display Table of Contents >>

Navigation:  Available Functions >

PrintImage()

Syntax

PrintImage( <cPathAndFileName> )

 

Purpose

To print the contents of an image (picture) file at a specific position on a report.

 

Parameters

<cPathAndFileName> is a character value containing the path and name of the image file to print. Currently, only .bmp (bitmap) files are supported.

 

Returns

True if image file is read ok, False if not.

 

Usage

This convenient function may be used in custom reports which require bitmaps (picture files) to be printed somewhere in the body of the report. For example, your organization's letterhead logo and other artwork could be printed at the top of the annual tax receipts DonorQuest can print for each donor. Likewise, a digital signature line (from a separate file) could be printed at the bottom of each receipt.

 

Example

The following example usage would read and print the bitmap stored in the file "ABC Organization Logo.bmp" at the current page position on a report as it is printing.

 

CALL

RESULT

PrintImage( "ABC Organization Logo.bmp" )

<image printed>