RoundRect (ImageKit Control/PrintDraw Method)

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

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->RoundRect(unsigned DeviceValue, int ALeft, int ATop, int ARight, int ABottom, int X, int Y, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->RoundRect(unsigned DeviceValue, const TRect &ARect, int X, int Y, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->RoundRect(void * DeviceValue, int ALeft, int ATop, int ARight, int ABottom, int X, int Y, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->RoundRect(void * DeviceValue, const TRect &ARect, int X, int Y, TVIkOutPutDeviceMode DeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.RoundRect(DeviceValue: THandle; ALeft, ATop, ARight, ABottom, X, Y: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.RoundRect(DeviceValue: THandle; const ARect: TRect; X, Y: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.RoundRect(DeviceValue: Pointer; ALeft, ATop, ARight, ABottom, X, Y: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.RoundRect(DeviceValue: Pointer; const ARect: TRect; X, Y: Integer; DeviceMode: TVIkOutPutDeviceMode)

[TVIkOutPutDeviceMode Type]

Unit
IkInit

type
TVIkOutPutDeviceMode = (vikScreen, vikPrinter, vikMemoryHandle);

Parameters

Name	Explanation
DeviceValue	The device context or the raster image data depending on the DeviceMode
ALeft, ATop	The x, y coordinates of the top left corner of the rectangle
ARight, ABottom	The x, y coordinates of the bottom right corner of the rectangle
ARect	The x, y coordinates of the rectangle
x,y	The height and width of the arc used to round the rectangles corners
DeviceMode	If vikScreen, then the Rectangle will be drawn in pixel units. If vikPrinter, the Rectangle will be drawn in 0.1mm units. If vikMemoryHandle, the Rectangle will be drawn (in pixel units) to the image data

Use either ALeft, ATop, ARight, ABottom or ARect.

Return Value

Returns True if successful. Returns False 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 vikScreen or vikMemoryHandle then ALeft, ATop, ARight, ABottom parameters are in pixel units.

If the DeviceMode parameter is vikPrinter then ALeft, ATop, ARight, ABottom parameters are in 0.1mm units.

Differences between the ImageKit7/8/9

In VCL the constants contain a "v". In ActiveX, the constants are: ikScreen, ikPrinter, ikMemoryHandle.
Methods that pass a TRect type have been added.