Printer.PrintBitmap Methods
Prints a map on a printer, by first rendering it to a bitmap and then printing the bitmap.
Overload List
| Name | Description | |
|---|---|---|
 Public method | PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Boolean printerDialog) | Prints a full-page map on a printer, possibly with a printer dialog. |
| Public method | PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Int64 handle) | Prints a full-page map as part of an existing print job. |
| Public method | PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Int64 handle, Rectangle pageArea) | Prints a map as part of an existing print job. |
| Public method | PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Boolean printerDialog, Rectangle pageArea) | Prints a map on a printer, possibly with a printer dialog. |
PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Boolean printerDialog)
Prints a full-page map on a printer, possibly with a printer dialog.Syntax
public static Rectangle PrintBitmap (
View view,
PrintAreaMode areaMode,
System.Int32 resolution,
System.Boolean printerDialog
)Parameters
The view to print.
Specifies how the view area will be adjusted to fit the destination area on the printed page.
Specifies the resolution (DPI) of the bitmap used to render the map.
Indicates if the standard printer selection/setup dialog should be shown.
Return Value
The geographical area that was actually printed.
Remarks
This method prints the supplied view on a full single page, as a separate print job. The areaMode parameter specifies how the view area will be adjusted to fit the printed page. Note that the supplied view will not be modified; it will be cloned internally if needed.
If printerDialog is True, then the method will display a printer dialog where the user can select printer and change printer settings. If it is False, the default printer will be used.
PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Int64 handle)
Prints a full-page map as part of an existing print job.Syntax
public static Rectangle PrintBitmap (
View view,
PrintAreaMode areaMode,
System.Int32 resolution,
System.Int64 handle
)Parameters
The view to print.
Specifies how the view area will be adjusted to fit the destination area on the printed page.
Specifies the resolution (DPI) of the bitmap used to render the map.
A Windows printer device context.
Return Value
The geographical area that was actually printed.
Remarks
This method prints the supplied view on the full current page of an existing print job. The handle parameter is used the specify the print job; it should be a Windows printer DC.
This method is very convenient to use with the .NET printing classes in the System.Drawing.Printing namespace. In the PrintPage event handler of the PrintDocument class, you can retrieve the printer DC via the Graphics property of the event arguments.
PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Int64 handle, Rectangle pageArea)
Prints a map as part of an existing print job.Syntax
public static Rectangle PrintBitmap (
View view,
PrintAreaMode areaMode,
System.Int32 resolution,
System.Int64 handle,
Rectangle pageArea
)Parameters
The view to print.
Specifies how the view area will be adjusted to fit the destination area on the printed page.
Specifies the resolution (DPI) of the bitmap used to render the map.
A Windows printer device context.
The part of the page that the map will be printed on.
Return Value
The geographical area that was actually printed.
Remarks
This method prints the supplied view on the full current page of an existing print job. The handle parameter is used the specify the print job; it should be a Windows printer DC.
The pageArea parameter specifies which part of the page that will be printed. This is expressed as fractions of the full paper size. For instance, specifying a rectangle of (0.1, 0.1, 0.9, 0.9) will result in 10% percent margins on all sides.
This method is very convenient to use with the .NET printing classes in the System.Drawing.Printing namespace. In the PrintPage event handler of the PrintDocument class, you can retrieve the printer DC via the Graphics property of the event arguments. It is very easy to mix Carmenta Engine maps and other output on the same page.
PrintBitmap(View view, PrintAreaMode areaMode, System.Int32 resolution, System.Boolean printerDialog, Rectangle pageArea)
Prints a map on a printer, possibly with a printer dialog.Syntax
public static Rectangle PrintBitmap (
View view,
PrintAreaMode areaMode,
System.Int32 resolution,
System.Boolean printerDialog,
Rectangle pageArea
)Parameters
The view to print.
Specifies how the view area will be adjusted to fit the destination area on the printed page.
Specifies the resolution (DPI) of the bitmap used to render the map.
Indicates if the standard printer selection/setup dialog should be shown.
The part of the page that the map will be printed on.
Return Value
The geographical area that was actually printed.
Remarks
This method prints the supplied view on a single page, as a separate print job. The areaMode parameter specifies how the view area will be adjusted to fit the printed page. Note that the supplied view will not be modified; it will be cloned internally if needed.
If printerDialog is True, then the method will display a printer dialog where the user can select printer and change printer settings. If it is False, the default printer will be used.
The pageArea parameter specifies which part of the page that will be printed. This is expressed as fractions of the full paper size. For instance, specifying a rectangle of (0.1, 0.1, 0.9, 0.9) will result in 10% percent margins on all sides.
Platforms
Windows