ImageEn, unit iemio

TImageEnMIO.PreviewPrintImages

TImageEnMIO.PreviewPrintImages


Declaration

procedure PreviewPrintImages(DestBitmap: TBitmap; MaxBitmapWidth, MaxBitmapHeight: integer; PrinterObj: TPrinter; Columns: integer; Rows: integer; HorizSpace: double; VertSpace: double; PrintSelected: boolean; MarginLeft: double; MarginTop: double; MarginRight: double; MarginBottom: double; CellBorder: boolean; ShowText: boolean; DropShadow: boolean; BorderColor: TColor = clBlack; const Heading: string = ''; HeadingHeight: Integer = 5; HeadingColor: TColor = clBlack; iPageNo : Integer = 0; ImageBorder: boolean = False);


Description

Display a preview of printing of images (all or just selected) in the attached TImageEnMView or TIEMultiBitmap as rows and columns of thumbnails.

Parameter Description
DestBitmap Destination bitmap where to paint the preview. Resizes DestBitmap as needed
MaxBitmapWidth Maximum destination bitmap width (in pixels). Preview will be stretched to match this size
MaxBitmapHeight Maximum destination bitmap height (in pixels). Preview will be stretched to match this size
Printer This is the Printer object. PreviewPrintImage needs it for such printer settings as orientation or page sizes
Columns Specifies the number of columns of images across the page
Rows Specifies the number of rows of images down the page
HorizSpace The horizontal space in inches between images
VertSpace The vertical space in inches between images
PrintSelected Set to true to print only selected images
MarginLeft Page left margin in inches. By specifying all zero values, no margins are used
MarginTop Page top margin in inches. By specifying all zero values, no margins are used
MarginRight Page right margin in inches. By specifying all zero values, no margins are used
MarginBottom Page bottom margin in inches. By specifying all zero values, no margins are used
CellBorder Set to true to draw a box around the each image cell (space containing the area of the image and its text)
ShowText Set to true to draw text associated with every image. Note: The font of the text will be used, e.g. BottomTextFont
DropShadow Set to true to draw a shadow around the image
BorderColor Specifies the color of the box around the image or cell (i.e. when CellBorder or ImageBorder is True)
Heading Specifies the heading to print at the top of the page. If you append### (e.g. 'Thumbnails ###') it will append "Page x" to printed pages after the first one
HeadingHeight The height of the heading, as a PERCENTAGE of the overall page height, e.g. 5 will make the heading 5% of the page height
HeadingColor Specifies the color of the heading text
iPageNo The page of thumbnails to preview. 0 shows the first page, 1 the second, etc.
ImageBorder Set to true to draw a box around each thumbnail (edge of image)

Note:
 The images will maintain their aspect ratio when stretched
 Use the OnPrintPage or OnPrintPage event to customize the heading of the printed page


Example

// Paint and display the preview of thumbnails of the ImageEnMView using a TImageEnView component
ImageEnMView1.MIO.PreviewPrintImages(ImageEnView2.IEBitmap.VclBitmap, ImageEnView2.Width, ImageEnView2.Height, Printer, 6, 4, ...);


See Also

 DoPrintPreviewDialog
 PrintImages
 PrintImagesToBitmap
 PrintImagesToFile
 OnPrintPage