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

Display an image file in a QPix area

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.


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



$error:=QPx_SetAreaImageFile (gQPixArea;$imagePath)

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

Related commands

QPx_GetAreaImageFile Get the image file being displayed in a QPix area