Command PV Add picture

PV Add picture

version 6.8

PV Add picture (area; picture{; expression{; tableNum{; fieldNum}}}) Longint

Parameter	Type		Description
area	Longint		4D View area
picture	Picture		4D picture
expression	String		Any expression that returns a 4D picture
tableNum	Integer		Table number
fieldNum	Integer		Field number

Function result Longint Picture number

The PV Add picture command pastes a 4D picture at the position of the current cell of area and returns its unique ID number. This identifier can then be used with other commands in the "PV Pictures" theme.

The picture must be a valid 4D picture. It can proceed from one of the following sources:

• A picture variable. In this case, pass the variable name in the picture parameter. Other parameters can be omitted.

• A 4D expression. In this case, pass the expression name in the expression parameter (the picture parameter is not used and the last parameters can be omitted). The expression parameter can contain for example the name of a 4D method that returns a picture variable or a Picture field reference ("[Table]PictureField").

• A picture field number. In this case, pass the table and field number in the tableNum and fieldNum parameters (picture and expression parameters are not used).

4D View keeps the dynamic reference between the picture pasted into the area and the source picture. Any modification carried out on the source picture in 4D will be reflected in the picture pasted into the area.

Paste in the current cell of a 4D View area the photo of the client whose record is current:

   C_LONGINT($PicRef)  `Added picture reference
   C_PICTURE($Picture)  `Empty picture (ignored)

   $PicRef:=PV Add picture  (Area;$Picture;"";Table(->[Clients]);Field(->[Clients]Photo))

PV Get picture, PV REMOVE PICTURE.