Arc (ImageKit Control/PrintDraw Method)

This method draws an arc in the designated object (the screen, printer, or image data).

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Arc(unsigned DeviceValue, int ALeft, int ATop, int ARight, int ABottom, int X1, int Y1, int X2, int Y2, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Arc(unsigned DeviceValue, const TRect &ARect, int X1, int Y1, int X2, int Y2, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Arc(void * DeviceValue, int ALeft, int ATop, int ARight, int ABottom, int X1, int Y1, int X2, int Y2, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Arc(void * DeviceValue, const TRect &ARect, int X1, int Y1, int X2, int Y2, TVIkOutPutDeviceMode DeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue: THandle; ALeft, ATop, ARight, ABottom, X1, Y1, X2, Y2: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue: THandle; const ARect: TRect; X1, Y1, X2, Y2: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue: Pointer; ALeft, ATop, ARight, ABottom, X1, Y1, X2, Y2: Integer; DeviceMode: TVIkOutPutDeviceMode)

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue: Pointer; const ARect: TRect; X1, Y1, X2, Y2: 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 parameter
ALeft, ATop	The x, y coordinates of the top left corner of the bounding rectangle
ARight, ABottom	The x, y coordinates of the bottom right corner of the bounding rectangle
ARect	The x, y coordinates of the bounding rectangle
X1, Y1	x and y coordinates of the starting point of the arc
X2, Y2	x and y coordinates of the ending point of the arc
DeviceMode	If vikScreen, then the output will be drawn in pixel units. If vikPrinter, the output will be drawn in 0.1mm units. If vikMemoryHandle, the output will be drawn (in pixel units) to the image data according to the DeviceValue parameter

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

Return Value

Returns True if successful. Returns False if unsuccessful.

Explanation

The Arc method draws an arc in the designated object (the screen, printer, or image data). The (ALeft, ATop) and (ARight, ABottom) parameters are the coordinates for points that specify a bounding rectangle in which the arc is drawn. ARect may also be used to specify the bounding rectangle. The bounding rectangle defines the curve of the arc between the two points specified by the starting point (X1, Y1) and ending point (X2, Y2) of the arc. The arc extends from the specified starting point (X1, Y1) to a point where it intersects a radial from the center of the bounding rectangle. The arc ends at the specified ending point (X2, Y2) where it intersects another radial from the center of the bounding rectangle. If the end point and the starting point are the same, a complete ellipse is drawn.

To draw an arc, the PenStyle, PenWidth, PenMode, PenColor, Transparent, and BackColor properties must 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.

If the DeviceMode parameter is vikScreen or vikMemoryHandle, then the ALeft, ATop, ARight, ABottom, (or ARect), X1, Y1, X2, Y2 parameters are in pixel units.

If the DeviceMode parameter is vikPrinter, then the ALeft, ATop, ARight, ABottom, (or ARect), X1, Y1, X2, Y2 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.