QPx_SetAreaImageFile

QPx_SetAreaImageFile(areaRef; areaRef):error
	areaRef	Longint	QPix area reference
	imagePath	Text	Path to the image file
	error	Longint	Error result

The QPix plug-in area is specified by areaRef. If areaRef is not a valid QPix plug-in area reference, qpx_paramErr is returned.

The image file to be displayed is specified by imagePath. If imagePath is empty, QPix presents a file selection dialog where the user can preview and select an image file. If the user selects a file, its full pathname is returned in imagePath, otherwise error qpx_userCancelErr is returned.

Example

   // Let the user select an image from disk
   // and display it in the plug-in area

C_LONGINT($error)
C_TEXT($imagePath)

$imagePath:=""

$error:=QPx_SetAreaImageFile (gQPixArea;$imagePath)

If ($error=qpx_noErr)
   
      // $imagePath contains the pathname of the selected file
   
End if 

Related commands