This function draws a polyline in the designated object.
Parameters
| Name | Explanation |
|---|---|
| DeviceValue | The device context or the raster image data (depending on the DeviceMode) |
| lpPoint | A structure defining coordinates for the points of
the polygonal area on the image
In C++Builder, pass the pointer to the first element in the structure array In Delphi, if Pt is an array of TPoint, then the arguments are returned in the first elements of the array Pt[0] |
| Points | The number of points defining the polygonal area on the image (2 or more), i.e. the number of points in the lpPoint array |
| DrawInfo | Structure whose members set the drawing information |
| DeviceMode | The designated object where the polygon is drawn (0: Screen, 1: Printer, 2: Image data) |
Return Value
Returns True (nonzero) if successful. Returns False (0) if unsuccessful.
Explanation
The IKPolyline function draws a polyline in the designated object. This function draws a straight line from a designated point to another point and from there to subsequent points. Unlike the polygon, the polyline is not closed. The points are specified by the IpPoint structure. The polyline is drawn from the value set in the PenStyle member variable of the DrawInfo structure. It is recommended that the PenWidth, PenMode, PenColor, Transparent, and BackColor member variables also be set. BackColor is enabled when the Transparent is True and the pen is set to draw lines other than the solid lines.
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 lpPoint member variables are in pixel units.
If the DeviceMode parameter is 1 (the designated object is the printer) then the lpPoint member variables are in 0.1mm units.
The differences from the ImageKit5
| Name | Explanation |
|---|---|
| IK5Polyline: | DeviceValue, lpPoint, Points, PrintInfo |
| IKPolyline: | DeviceValue, lpPoint, Points, DrawInfo, DeviceMode |
PrintInfo and DrawInfo structures are different, however the member variables in PrintInfo are used in the same way in DrawInfo. 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, there is no difference between this function in the ImageKit10 and the ImageKit6.