PrintDIBPage Method

The  PrintDIBPage function is obsolete, use PrintDIBPageExt2 function instead.

Description         Prints a device independent bitmap.

Syntax                 RetVal = [BIPrint.]PrintDIBPage Dib Scale CurPage xStart yStart

Returns               RetVal                    Integer             It is zero on success or error code on error.

Remarks             Dib                          LONGLONG Device independent bitmap to print.

                            Scale                       Long                MS Windows RECT data structure for scaling the image in X and Y direction. (Scale.left and Scale.right in X direction and Scale.top and Scale.bottom in Y direction). For example left=1 top=3, right=1, and bottom=1 increases the image by three times in both X and Y direction. You may pass these values in an array to the method (pass the first item of the array), filled in Left, Top, Right, Bottom order. If this parameter is set to 0, the method gets the scaling from the PrintingScaleLeft, PrintingScaleTop, PrintingScaleRight and PrintingScaleBottom properties.

                            CurPage                 Integer             The actual page number.

                            xStart                     Integer             The X starting position in a page.

                            yStart                     Integer             The Y starting position in a page.

Usage                  Using this method it is possible to print more than one DIB to a page. Use the xStart and yStart parameter to suit a DIB on the page. Use the EndPrint method to finish the printing procedure.

See Also              PrepareToPrint Method, EndPrint Method, PrintingScaleTop Property, PrintingScaleRight Property, PrintingScaleLeft Property, PrintingScaleBottom Property, PrintDIBPageEx Method