PrintDIB Method

The PrintDIB  function is obsolete, use PrintDIBExt function instead.

Description         Prints a device independent bitmap.

Syntax                 RetVal = [BIPrint.]PrintDIB  Wnd ImgName Dib Scale NumCopies Display CenterVertImg CenterHorizImg ScalePage ConvertCtoB StretchPage AllPage UseDPI NotDispCancel

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

Remarks             Wnd                       LONGLONG Window handle for the dialog boxes.

                            ImgName               String              A capture text to print.

                            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 reference of the array’s first item), filled in Left, Top, Right, Bottom order.

                            NumCopies            Integer             The number of copies to be printed.

                            Display                   Boolean           Display the Print dialog box.

                            CenterVertImg      Boolean           Center the image vertically on the printer.

                            CenterHorizImg    Boolean           Center the image horizontally on the printer.

                            ScalePage               Boolean           Scale image to fit proportionally.

                            ConvertCtoB         Boolean           Convert bitmap to monochrome.

                            StretchPage           Boolean           Stretch bitmap to fit in a page.

                            AllPage                   Boolean           Print all page of a tiff file.

                            UseDPI                   Boolean           Use DPI settings.

                            NotDispCancel      Boolean           Not to display the Cancel Printing dialog box.

Usage                  The PrintDIB method includes the PrepareToPrint, PrintDIBPage and EndPrint method calls.

See Also              PrepareToPrint Method, PrintDIBPage Method, EndPrint Method