Ellipse (ImageKit Control/PrintDraw Method)

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

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Ellipse(NativeUInt DeviceValue, int ALeft, int ATop, int ARight, int ABottom, bool EnableFontScale, bool Clip, TVIkOutPutDeviceMode DeviceMode)

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Ellipse(NativeUInt DeviceValue, const TRect &ARect, bool EnableFontScale, bool Clip, TVIkOutPutDeviceMode DeviceMode)

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

[C++Builder] [ bool = ]imagekitcontrolname->PrintDraw->Ellipse(void * DeviceValue, const TRect &ARect, bool EnableFontScale, bool Clip, TVIkOutPutDeviceMode DeviceMode)

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

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Ellipse(DeviceValue: THandle; const ARect: TRect; DeviceMode: TVIkOutPutDeviceMode)

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

[Delphi] [ Boolean = ]imagekitcontrolname.PrintDraw.Ellipse(DeviceValue: Pointer; const ARect: TRect; DeviceMode: TVIkOutPutDeviceMode)

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
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 Ellipse method draws an ellipse in the designated object (the screen, printer, or memory handle). The (ALeft, ATop), and (ARight, aBottom) parameters are coordinates for points that specify a bounding rectangle in which the ellipse is drawn. The outline of the ellipse is drawn from the value set in the PenStyle property and the ellipse is filled by the value set in the BrushStyle property (this method can draw in the following designated objects: screen, printer, and image data). When drawing an ellipse, it is recommended that the PenWidth, PenStyle, PenMode, PenColor, BrushStyle, BrushColor, Transparent, BackColor 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 or the brush is set to draw hatch pattern.

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/10

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