TImageEnMIO.PreviewPrintImages

Declaration

procedure PreviewPrintImages(DestBitmap: TIEBitmap; MaxBitmapWidth, MaxBitmapHeight: integer; PrinterObj: TPrinter;
                             ColCount: integer; RowCount: integer; HorzSpace: double = 0.5; VertSpace: double = 0.5; PrintSelected: boolean = False;
                             MarginLeft: double = 1.0; MarginTop: double = 1.0; MarginRight: double = 1.0; MarginBottom: double = 1.0;
                             CellBorder: boolean = False; ShowText: boolean = True; DropShadow: boolean = True; BorderColor: TColor = clBlack;
                             const Heading: string = ''; HeadingHeight: Integer = 5; HeadingColor: TColor = clBlack;
                             PageNo: Integer = 0; ImageBorder: boolean = False; ClipImages: Boolean = False); overload;
procedure PreviewPrintImages(DestBitmap: TBitmap; MaxBitmapWidth, MaxBitmapHeight: integer; PrinterObj: TPrinter;
                             ColCount: integer; RowCount: integer; HorzSpace: double = 0.5; VertSpace: double = 0.5; PrintSelected: boolean = False;
                             MarginLeft: double = 1.0; MarginTop: double = 1.0; MarginRight: double = 1.0; MarginBottom: double = 1.0;
                             CellBorder: boolean = False; ShowText: boolean = True; DropShadow: boolean = True; BorderColor: TColor = clBlack;
                             const Heading: string = ''; HeadingHeight: Integer = 5; HeadingColor: TColor = clBlack;
                             PageNo: Integer = 0; ImageBorder: boolean = False; ClipImages: Boolean = False); overload;

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 to output 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
ColCount	Specifies the number of columns of images across the page
RowCount	Specifies the number of rows of images down the page
HorzSpace	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
PageNo	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)
ClipImages	Set to display images cropped to the ratio of the output (i.e. left/right or top/bottom of the image will be discarded to avoid space around the thumbnail

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

Demo

Demos\ImageEditing\EveryMethod\EveryMethod.dpr

Example

Also see: Automated Samples

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

TImageEnMIO.PreviewPrintImages