PictureBox_DrawFillRect Method

Description

This method draws a solid rectangle on the control.

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.
UpperLeftX: Integer specifying the upper left X-axis coordinate.
UpperLeftY: Integer specifying the upper left Y-axis coordinate.
Width: Integer specifying the width of the rectangle.
Height: Integer specifying the height of the rectangle.
Color: Color specifying the rectangle color.

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:

Copy Code
(Odcl_PictureBox_DrawFillRect MyControlReference [as Reference] (list (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] Color [as Color]) (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] Color [as Color]) ... ) )

Copy Code

(Odcl_PictureBox_DrawFillRect 
		MyControlReference [as Reference]
		(list 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				Color [as Color]) 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [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:

Copy Code
(Odcl_PictureBox_DrawFillRect ProjectFile [as String] DialogName [as String] ControlName [as String] (list (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] Color [as Color]) (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] Color [as Color]) ... ) )

Copy Code

(Odcl_PictureBox_DrawFillRect
		ProjectFile [as String]
		DialogName [as String]
		ControlName [as String]
		(list 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				Color [as Color]) 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				Color [as Color]) 
			...
		)
	)

Remarks

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

Please create lists as follows using the list keyword:

(list (list x y ...) (list x y ...) ...)

It seems that ObjectARX does not always handle lists created as follows:

'(x y ...) (x y ...) ...

Applies For

PictureBox.

Example

Copy Code
; Draw solid rectangles (Odcl_PictureBox_DrawFillRect MyProject_MyForm_MyControl (list (list 0 0 50 50 -11) (list 50 50 50 50 -3) ) )