IKFillRect

This function draws a filled rectangle in the designated object (the screen, printer, or image data).

[C++Builder/Visual C++] BOOL IKFillRect(LPVOID DeviceValue, LPRECT PrintRect, PTR_IKPRINT_DRAWINFO DrawInfo, BYTE DeviceMode);

[Delphi] function IKFillRect(DeviceValue: THandle; var PrintRect: TRect; var DrawInfo: IKPRINT_DRAWINFO; DeviceMode: Byte): LongBool;

[Visual Basic] Function IKFillRect(ByVal DeviceValue As Long, PrintRect As IKRECT, DrawInfo As IKPRINT_DRAWINFO, ByVal DeviceMode As Byte) As Long

Parameters

Name	Explanation
DeviceValue	The device context or the raster image data (depending on the DeviceMode)
PrintRect	Structure containing the coordinates of points for the area bounding the filled rectangle
DrawInfo	Structure whose members set the drawing information
DeviceMode	The designated object where the filled rectangle is drawn (0: Screen, 1: Printer, 2: Image data)

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The IKFillRect function draws a filled rectangle in the designated object (the screen, printer, or image data). A chord is a region bounded by the intersection of an ellipse and a line segment. The PrintRect member variables contain the coordinates for points that specify a bounding rectangle in which the ellipse is drawn. The outline of the ellipse is drawn from the value set in the PenStyle member of DrawInfo and the ellipse is filled by the value set in the BrushStyle member variable. When drawing an ellipse, it is recommended that the PenWidth, PenMode, PenColor, BrushColor, Transparent, and BackColor member variables of DrawInfo also be set. The BackColor is enabled when the Transparent is false and the pen is set to draw lines other than solid lines or the brush is set to draw hatch pattern.

If the DeviceMode parameter is 0 or 2 (the designated object is the screen or the image data) then the member variables of the PrintRect parameter are in pixel units.

If the DeviceMode parameter is 1 (the designated object is the printer) then the member variables of the PrintRect parameter parameter are in 0.1mm units.

The differences from the ImageKit5

Function Name	Parameters
IK5Ellipse:	DeviceValue, PrintRect, PrintInfo
IKEllipse:	DeviceValue, PrintRect, DrawInfo, DeviceMode

PrintInfo and DrawInfo structures are different, however the member variables in PrintInfo are used in the same way in DrawInfo. If you set the Transparent parameter to True and then set the DeviceMode parameter to the value that you used in the ImageKit5 IKSetDeviceMode, then there is no difference between this function in the ImageKit8 and the ImageKit5.

The differences from the ImageKit6

The BackColor member variable has been added. If you set the Transparent parameter to True, there is no difference between this function in the ImageKit8 and the ImageKit6.