QGrid Obsolete commands

QGObs_GetPicture

QGObs_GetPicture(areaRef; tableNum; fieldNum; rectLeft; rectTop; rectRight; rectBottom; displayFormat):errorCode
areaRef Longint QGrid area reference
tableNum Longint Table number
fieldNum Longint Field number
rectLeft Longint Left coordinate
rectTop Longint Top coordinate
rectRight Longint Right coordinate
rectBottom Longint Bottom coordinate
displayFormat Longint Picture format number
error Longint Error result
Do not use this command in QGrid v1.1 or later

This QGrid v1.0 command is preserved in QGrid v1.1 for compatibility reasons.
It has been substituted by newer commands.


Returns the current picture object setup.

Parameter areaRef is the QGrid area reference. If areaRef is not a valid QGrid area reference, qg_paramErr error is returned. If no picture object was defined, qg_NoPictureErr error is returned.

Parameters tableNum and fieldNum receive the source table and field numbers of the picture object respectively.

Parameters rectLeft, rectTop, rectRight and rectBottom receive the picture box coordinates in the cell's coordinate system.

Parameter displayFormat receives the picture display format. QGrid defines the following constants for picture display formats:

qg_PictTruncCentered 1 Same as 4D's Truncated Centered (default)
qg_PictScaledToFit 2 Same as 4D's Scaled To Fit
qg_PictTruncNonCenter 4 Same as 4D's Truncated non Centered
qg_PictScaledToFitProp 5 Same as 4D's Scaled to fit proportional
qg_PictScaledToFitPropCenter 6 Same as 4D's Scaled to fit prop centered
qg_PictXScaledToFitProp 8 Same as 4D's Scaled to fit proportional, but scales up as well
qg_PictXScaledToFitPropCenter 9 Same as 4D's Scaled to fit prop centered, but scales up as well

Example

C_LONGINT($err;$tblNum;$fldNum;$left;$top;$right;$bottom;$format)
 
$err:=QGObs_GetPicture (xGrid;$tblNum;$fldNum;$left;$top;$right;$bottom;$format)
 
If ($err = qg_NoPictureErr)
  ` No picture object was defined for the area
Else
  If ($err # qg_noErr)
    ` Handle the error
  End if
End if
 
 

Related commands

QG_SetCellPicture Setup a picture object for the area cells
QG_GetCellPicture Return the current picture object
QGObs_SetPicture Setup a picture object for the area cells (obsolete)

QGrid © Escape Information Services
Generated by QDoc 2.6 on Thu, 2 May 2002 00:33:09 +0300