Arc (ImageKit Control/PrintDraw Method)

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

[Visual Basic] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue As LONG_PTR, left As Long, top As Long, right As Long, bottom As Long, x1 As Long, y1 As Long, x2 As Long, y2 As Long, DeviceMode As OutPutDeviceModeConstants)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetPrintDraw().Arc(LONG_PTR DeviceValue, long left, long top, long right, long bottom, long x1, long y1, long x2, long y2, long DeviceMode)

[VB.NET] [ Boolean = ]imagekitcontrolname.PrintDraw.Arc(DeviceValue As Integer(x86) or Long(x64), left As Integer, top As Integer, right As Integer, bottom As Integer, x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer, DeviceMode As ImageKit10(A)Lib.OutPutDeviceModeConstants)

[C#.NET] [ bool = ]imagekitcontrolname.PrintDraw.Arc(int(x86) or long(x64) DeviceValue, int left, int top, int right, int bottom, int x1, int y1, int x2, int y2, 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 parameter
left,top	The x, y coordinates of the top left corner of the area bounding the arc
right,bottom	The x, y coordinates of the bottom right corner of the area bounding the arc
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 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 Arc method draws an arc in the designated object (the screen, printer, or image data). The (left, top) and (right, bottom) parameters are the coordinates for points that specify a bounding rectangle in which the arc is drawn. 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 property must be set. It is recommended that the PenWidth, PenMode, PenColor and Transparent properties 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.

If the DeviceMode parameter is 0 or 2, then the left, top, right, bottom, x1, y1, x2, y2 parameters are in pixel units.

If the DeviceMode parameter is 1, then the left, top, right, bottom, x1, y1, x2, y2 parameters are in 0.1mm units.

Differences between the ImageKit7/8

The DeviceValue argument's type has changed.