PrintDIB Method

Description

Draws a device independent bitmap (DIB) on a document to be printed.

Syntax

Visual Basic
Public Sub PrintDIB( _ ByVal X1 As Single, _ ByVal Y1 As Single, _ ByVal Width1 As Single, _ ByVal Height1 As Single, _ ByVal X2 As Single, _ ByVal Y2 As Single, _ ByVal Width2 As Single, _ ByVal Height2 As Single, _ ByVal Aspect As Boolean _ )

Visual Basic

Public Sub PrintDIB( _
   ByVal X1 As Single, _
   ByVal Y1 As Single, _
   ByVal Width1 As Single, _
   ByVal Height1 As Single, _
   ByVal X2 As Single, _
   ByVal Y2 As Single, _
   ByVal Width2 As Single, _
   ByVal Height2 As Single, _
   ByVal Aspect As Boolean _
)

Parameters

X1

Single-precision value indicating the destination horizontal coordinate of the upper-left corner of the image. The ScaleMode property determines the unit of measure used.

Y1

Single-precision value indicating the destination vertical coordinate of the upper-left corner of the image. The ScaleMode property determines the unit of measure used.

Width1

Single-precision value indicating the destination width of the image.

The ScaleMode property of the object determines the unit of measure used.

If omitted, the width of the image will be used.

If Aspect is False and the destination width is larger or smaller than the source width (width2), the image is stretched or compressed to fit.

Height1

Single-precision value indicating the destination height of the image. The ScaleMode property determines the unit of measure used.

If omitted, the height of the image will be used.

If Aspect is False and the destination height is larger or smaller than the source height (height2), the image is stretched or compressed to fit.

X2

Single-precision value indicating the coordinate (x-axis) of a clipping region within the image. The ScaleMode property determines the unit of measure used.

If Aspect is True, 0 is assumed.

Y2

Single-precision value indicating the coordinate (y-axis) of a clipping region within the image. The ScaleMode property determines the unit of measure used.

If Aspect is True, 0 is assumed.

Width2

Single-precision value indicating the source width of a clipping region within the image. The ScaleMode property determines the unit of measure used.

If Aspect is True, the entire source width is used.

Height2

Single-precision value indicating the source height of a clipping region within the image. The ScaleMode property determines the unit of measure used.

If Aspect is True, the entire source height is used.

Aspect

Boolean value indicating whether the aspect ratio of the image should be maintained.

If Aspect is True, and the destination rectangle is larger or smaller than the source rectangle, the aspect ratio of the resized image is maintained.

If Aspect is True, the x2, y2, width2 and height2 parameters are ignored.

Remarks

The DIB is defined by the hDIB property. The destination coordinates of the image must be within the physical area of the printer. If a printer has not been selected or a document has not been started, the PrintPicture method will select the default printer and start a new document. Use the EndPrintDoc method to print the document.

If the OwnDIB property is true, the PrintDIB method deletes the DIB after drawing the device independent bitmap (DIB) on a document to be printed.