ObjectDCL Banner

PictureBox_DrawPoint Method

Description

This method will paint a single point on the control any specified color.

Parameters

MyControlReference
Reference to the control in the form of MyProject_MyForm_MyControl.
ProjectFile
String identifying the project as it was passed in LoadProject.
DialogName
String identifying the dialog by name.
ControlName
String identifying the control by name.
X
Integer specifying the X-axis coordinate.
Y
Integer specifying the Y-axis coordinate.
Color
Color specifying the color of the point.

Return Values

Returns the following according to the situation:

  • T when successful.
  • Nil if the control is not found or is not visible.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

CopyCode imageCopy Code
(Odcl_PictureBox_DrawPoint 
		MyControlReference [as Reference]
		X [as Integer]
		Y [as Integer]
		Color [as Color]
	)

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

CopyCode imageCopy Code
(Odcl_PictureBox_DrawPoint
		ProjectFile [as String]
		DialogName [as String]
		ControlName [as String]
		X [as Integer]
		Y [as Integer]
		Color [as Color]
	)

Remarks

This function requires that the component is showing. Otherwise it has no effect.

This method does not accept lists passed in to specify a group of points to be drawn.   Due to ObjectARX limitations in lists, at this time, small lists cannot be supported.

Applies For

PictureBox.

Example

CopyCode imageCopy Code
; Draw a point
(Odcl_PictureBox_DrawPoint MyProject_MyForm_MyControl
		50 50 -11)

See Also

PictureBox_DrawArc, PictureBox_DrawCircle, PictureBox_DrawEdge, PictureBox_DrawFillRect, PictureBox_DrawFocusRect, PictureBox_DrawHatchRect, PictureBox_DrawLine, PictureBox_DrawRect, PictureBox_DrawText, PictureBox_DrawWrappedText