PA_Dial4DSetArrayPictureHandle

version 2003

PA_Dial4DSetArrayPictureHandle (dialog; variable; picture; info; index)

Parameter	Type		Description
dialog	PA_Dial4D	→	Dialog reference
variable	char*	→	Variable name of the picture array
picture	PA_Handle	→	Handle of the Macintosh Picture
info	PA_PictureInfo	→	Picture information
index	long	→	Index of the picture in the array

Description

The routine PA_Dial4DSetArrayPictureHandle allows you to set a picture in an array. variable is the variable name, this variable must be an array of pictures. index is the index in the array where you want to assign the picture. If this index is greater than the array length, the picture will be appended to the array, otherwise the picture will replace the previous one in this array.

4th Dimension uses Macintosh Pictures internally as such the data must point to a valid Macintosh Picture handle. The picture handle belongs to the array once this command has been called; you should not attempt to dispose of it.