SlideView_SlideImage Method

Description

This method will load a slide image from a slide file or slide library file and paint it anywhere 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.
FileName: String specifying the path to the file.
SlideLibraryImageName: String specifying the image name to paint.

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_SlideView_SlideImage MyControlReference [as Reference] (list (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] FileName [as String] [Optional] SlideLibraryImageName [as String]) (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] FileName [as String] [Optional] SlideLibraryImageName [as String]) ... ) )

Copy Code

(Odcl_SlideView_SlideImage 
		MyControlReference [as Reference]
		(list 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				FileName [as String]
				[Optional] SlideLibraryImageName [as String]) 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				FileName [as String]
				[Optional] SlideLibraryImageName [as String]) 
			...
		)
	)

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

Copy Code
(Odcl_SlideView_SlideImage ProjectFile [as String] DialogName [as String] ControlName [as String] (list (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] FileName [as String] [Optional] SlideLibraryImageName [as String]) (list UpperLeftX [as Integer] UpperLeftY [as Integer] Width [as Integer] Height [as Integer] FileName [as String] [Optional] SlideLibraryImageName [as String]) ... ) )

Copy Code

(Odcl_SlideView_SlideImage
		ProjectFile [as String]
		DialogName [as String]
		ControlName [as String]
		(list 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				FileName [as String]
				[Optional] SlideLibraryImageName [as String]) 
			(list 
				UpperLeftX [as Integer]
				UpperLeftY [as Integer]
				Width [as Integer]
				Height [as Integer]
				FileName [as String]
				[Optional] SlideLibraryImageName [as String]) 
			...
		)
	)

Remarks

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

SlideView.

Example

Copy Code
; Paint slides (Odcl_SlideView_SlideImage MyProject_MyForm_MyControl (list (list 0 0 50 50 "SingleSlide.slb") (list 50 50 50 50 "SetOfSlides.slb" "Slide1") ) )