This function draws a pie shaped figure in the designated object (the screen, printer, or image data).

[C++Builder]     BOOL IKPie(LPVOID DeviceValue, LPRECT PrintRect, int x1, int y1, int x2, int y2, PTR_IKPRINT_DRAWINFO DrawInfo, BYTE DeviceMode);
[Delphi]         function IKPie(DeviceValue: THandle; var PrintRect: TRect; x1, y1, x2, y2: Integer; var DrawInfo: IKPRINT_DRAWINFO; DeviceMode: Byte): LongBool;

Parameters

Name Explanation
DeviceValue The device context or the raster image data (Depends on the DeviceMode)
PrintRect Structure containing the coordinates of points for the area bounding the pie
x1,y1 x and y coordinates of the starting point of the pie shape
x2,y2 x and y coordinates of the ending point of the pie shape
DrawInfo Structure whose members set the drawing information
DeviceMode The designated object where the paint occurs (0: Screen, 1: Printer, 2: Image data)

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The IKPie function draws a pie shaped figure in the designated object. This function draws part of an ellipse and two edges that extend from the ends of the arc to the center point of the bounding rectangle to complete the pie shape (See the IKArc function).

The outline of the pie shape is drawn from the value set in the DrawInfo structure's PenStyle member variable and the pie shape is filled by the value set in the BrushStyle member variable. When drawing a pie shape, it is recommended that the PenWidth, PenMode, PenColor, BrushColor, Transparent, and BackColor member variables also be set. BackColor is enabled when the Transparent is False and the pen is set to draw lines other than solid lines or the brush is set to draw hatch pattern.

This function can draw in the following designated objects: screen, printer, and image data.

If the DeviceMode parameter is 0 or 2 (the designated object is the screen or the image data) then the PrintRect, x1, y1, x2, y2 parameters are in pixel units.

If the DeviceMode parameter is 1 (the designated object is the printer) then the PrintRect, x1, y1, x2, y2 parameters are in 0.1mm units

The differences from the ImageKit5

Name Explanation
IK5Pie: DeviceValue, PrintRect, x1, y1, x2, y2, PrintInfo
IKPie: DeviceValue, PrintRect, x1, y1, x2, y2, DrawInfo, DeviceMode

PrintInfo and DrawInfo structures are different, however the member variables in PrintInfo are used in the same way in DrawInfo. The DeviceMode parameter has been added to this function in the ImageKit6 and ImageKit10. If you set the Transparent parameter to True and then set the DeviceMode parameter to the value that you used in the ImageKit5 IKSetDeviceMode, then there is no difference between this function in the ImageKit10 and the ImageKit5.

The differences from the ImageKit6

BackColor has been added. If you set the Transparent parameter to True then there is no difference between this function in the ImageKit10 and ImageKit6.

The ImageKit10 VCL is a product created by Newtone Corporation