RoundRect (ImageKit Control/PrintDraw Method)

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

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

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

[VB.NET] [ Boolean = ]imagekitcontrolname.PrintDraw.RoundRect(DeviceValue As Integer(x86) or Long(x64), left As Integer, top As Integer, right As Integer, bottom As Integer, x As Integer, y As Integer, DeviceMode As ImageKit10(A)Lib.OutPutDeviceModeConstants)

[C#.NET] [ bool = ]imagekitcontrolname.PrintDraw.RoundRect(int(x86) or long(x64) DeviceValue, int left, int top, int right, int bottom, int x, int y, ImageKit10(A)Lib.OutPutDeviceModeConstants DeviceMode)

ImageKit10ALib refers to the ANSI version, ImageKit10Lib refers to the Unicode version, (x86) refers to the 32 bit version, and (x64) refers to the 64 bit version.

Parameters

Name	Explanation
DeviceValue	The device context or the raster image data (i.e. Hdc or ImageHandle) depending on the DeviceMode
left,top	The x and y coordinates for the top left corner of the rounded rectangle
right,bottom	The x and y coordinates for the bottom right corner of the rounded rectangle
x,y	The height and width of the arc used to round the rectangles corners
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

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 RoundRect method draws a rounded rectangle in the designated object (screen, printer, image data). The left, top, right, and bottom parameters define the coordinates specifying the rounded rectangle. The corners of the rounded rectangle are rounded according to the arc defined in the x and y parameters. The outline of the rounded rectangle is drawn from the value set in the PenStyle property and the rounded rectangle is filled by the value set in the BrushStyle property. When drawing a rounded rectangle, it is recommended that the PenWidth, PenMode, PenColor, BrushColor, Transparent, and BackColor properties also be set. The BackColor property is enabled when the Transparent property is False and the the pen is not solid or the brush is hatch pattern.

If the DeviceMode parameter is 0 or2 then left, top, right, bottom, x and y parameters are in pixel units.

If the DeviceMode parameter is 1 then left, top, right, bottom, x and y parameters are in 0.1mm units.

Differences between ImageKit7/8

The DeviceValue argument's type has changed.