RpPrinter & PtrDevice Class Overview > RpPrinter Class > RpPrinter:

Purpose

To draw a bitmap on the printer or print preview window using an already initialized DIBMP object.

Syntax

<oRpPrinter>:_DrawBmp([nY], [nX], oDIBMP, [nHeight], [nWidth], [nStartRow], [nStartCol], [lStretch])

Arguments

nY	Optional. The row to start printing the bitmap. The default is the current PROW setting.
nX	Optional. The column to start printing the bitmap. The default is the current PCOL setting.
oDIBMP	The DIBMP object which was previously initialized.
nHeight	Optional. The height of the bitmap. The default is the full height of the bitmap.
nWidth	Optional. The width of the bitmap. The default is the full width of the bitmap.
nStartRow	Optional. The first row of pixels in the bitmap to print. The default is the first row.
nStartCol	Optional. The first column of pixels in the bitmap to print. The default is the first column.
lStretch	Optional. Determines if the bitmap is stretched or clipped if nHeight and nWidth don't equal the full height and width.

Description

This low-level method prints a bitmap on the printer or print preview window. The DIBMP object, which contains the bitmap, must be initialized prior to calling this method. In general, you should use the RpPrinter:DrawBMP method as it automatically handles loading and unloading the bitmap from a file. This method is provided for when you wish to avoid the overhead of repeatedly loading the same bitmap over and over again or for when you want to load the bitmap from a resource or field. For more information on the DIBMP class, please see the discussion later in this manual.

Example

// Draw a bitmap from a DIBMP object

oRpPrinter:_DrawBmp(, , oDIBMP)