This function draws the border of the specified rectangle in the designated object.
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 rectangle |
DrawInfo | Structure whose members set the drawing information |
DeviceMode | The designated object where the rectangle is drawn (0: Screen, 1: Printer, 2: Image data) |
Return Value
Returns True (nonzero) if successful. Returns False (0) if unsuccessful.
Explanation
The IKFrameRect function draws the border of the specified rectangle in the designated object. The rectangle is specified by PrintRect parameter and drawn using the value of BrushStyle member variables. The area inside the border of the rectangle will not be filled (The designated object can be the screen, printer, or image data).
To use this function the BrushStyle, BrushColor, Transparent, and BackColor member variables of DrawInfo parameter must be set. The BackColor member variable is enabled when the Transparent is False and the hatch pattern brush is used. With the IKFrameRect function, when the Transparent is other than zero 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 function instead.
If the DeviceMode parameter is 0 or 2 (the designated object is the screen or the image data) then the member variables of PrintRect parameter are in pixel units.
If the DeviceMode parameter is 1 (the designated object is the printer) then the member variables of PrintRect parameter are in 0.1mm units.