QMedical Command Reference Area Image

QMed_SetAreaImage

QMed_SetAreaImage(areaRef; imageRef):error
areaRef Longint QMedical area reference
imageRef Longint Image reference
error Longint Error result

Assigns an image reference to a QMedical plug-in area.

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

Parameter imageRef must be a valid image reference created with the QMed_OpenImage command.

If the image is succesfully assigned, the area takes its ownership. This means that you don't have to call QMed_CloseImage to destroy the image reference; it is freed when the area is destroyed by 4D or when another command changes the area's content data.



Example

  `Assign an image to a plug-in area

C_LONGINT($error)

C_LONGINT(gImageRef)

$error:=QMed_SetAreaImage (gAreaRef;gImageRef)

If ($error # qmed_noErr)
   `Handle the error
End if 



Related commands

QMed_GetAreaImage Returns the image reference currently assigned to a QMedical plug-in area

QMedical © Escape Information Services
Generated by QDoc 2.7 on Wed, Mar 24, 2004 17:00:36