PA_SetPictureInArray

version 2003

PA_SetPictureInArray (array; index; newPict; pictSize; info)

Parameter	Type		Description
array	PA_Variable		Array to access
index	long		Index of the element to access
newPict	void *		Pointer to the new picture data
pictSize	long		Size of the new picture in bytes
info	PA_PictureInfo		Background picture info

The routine PA_SetPictureInArray sets the index element of the picture array array to picture.

Pass a pointer to the new picture data in picture, its size in size, and the PictureInfo in info.

Because 4th Dimension uses Macintosh Pictures internally, you must pass a pointer to a valid Macintosh Picture.

A Macintosh Picture starts with 5 short values that gives the size and the rectangle of the picture respectively. Under Windows, these 5 short values need to be byte swapped into the Windows byte order.

If array is not a eVK_ArrayPicture or if index is out of range, the routine does nothing.

Initialize every element of a picture array to a special value, setting the PictureInfo to a default picture.

   void FillPictureArrayWith( PA_Variable arr, void *newPict, long size )
   {
      PA_PictureInfo   info = {0, 0, 0};
      long   count, i;
      count = PA_GetArrayNbElements( arr );
      for ( i = 1; i <= count; i++ )
         PA_SetPictureInArray( arr, i, newPict, size, info);
   }

PA_GetPictureHandleInArray, PA_GetPictureInArray, PA_SetPictureHandleInArray.

None.