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
// 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