FillRect (ImageKit Control/PrintDraw Method)

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

[Visual Basic] [ Boolean = ]imagekitcontrolname.PrintDraw.FillRect(DeviceValue As Long, left As Long, top As Long, right As Long, bottom As Long, DeviceMode As OutPutDeviceModeConstants)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetPrintDraw().FillRect(long DeviceValue, long left, long top, long right, long bottom, long DeviceMode)

Parameters

Name	Explanation
DeviceValue	The device context or the raster image data (i.e. Hdc or ImageHandle) depending on the DeviceMode parameter
left, top	The x, y coordinates of the top left corner of the filled rectangle
right, bottom	The x, y coordinates of the bottom right corner of the filled rectangle
DeviceMode	If 0 (ikScreen), then the output will be drawn in pixel units. If 1 (ikPrinter), the output will be drawn in 0.1mm units. If 2 (ikMemoryHandle), the output will be drawn (in pixel units) to the image data according to the DeviceValue parameter

In Visual Basic the following constants can be used: (ikScreen = 0, ikPrinter = 1, ikMemoryHandle = 2).

Return Value

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

Explanation

The FillRect method draws a filled rectangle in the designated object (the screen, printer, or image data). The (left, top), and (right, bottom) parameters are coordinates for points that specify the rectangle. The rectangle is filled by the value set in the BrushStyle property.

Note that the left and top sides are included in the filled rectangle but the right and bottom sides are not (This method can draw in the following designated objects: screen, printer, and image data).

It is recommended that the BrushColor, Transparent, and BackColor property also be set. The BackColor property is enabled when the Transparent property is false and the pen is set to draw lines other than solid lines or the brush is set to draw hatch pattern. With the FillRect method, when the Transparent property is True and a hatch pattern is selected, the spaces between the lines will be filled with the default color and will NOT be transparent. To make the space between the lines of the hatch pattern transparent, please use the Rectangle method instead.

If the DeviceMode parameter is 0 or 2 (the designated object is the screen or the image data) then the left, top, right, bottom parameters are in pixel units.

If the DeviceMode parameter is 1 (the designated object is the printer) then the left, top, right, bottom parameters are in 0.1mm units.