version 2003
PA_Dial4DSetPictureHandle (dialog; variable; newPicture; info)
Parameter | Type | Description | |
dialog | PA_Dial4D | Dialog reference | |
variable | char* | Name of the variable to access | |
newPicture | PA_Handle | Handle to the picture data | |
info | PA_PictureInfo | Picture information |
Description
The routine PA_Dial4DSetPictureHandle sets the variable variable to the picture referenced by the PA_Handle newPicture. 4th Dimension handles Macintosh Pictures internally, so you must give a valid Macintosh Picture handle to this routine.
Note that there is no command to get a picture. You can get a picture in a dialog variable using PA_Dial4DGetVariable.
IMPORTANT NOTE
The PA_Handle belongs to 4th Dimension after the call. You must not dispose of it.
By default, variable needs to be a null terminated C string. If you have previously called PA_UsePStrings, you must pass a Pascal string to the command.
By default, variable needs to use Macintosh characters set on Macintosh, and ANSI characters set under Windows. You can call PA_UseMacCharacters or PA_UseAnsiCharacters to specifically use Macintosh or ANSI characters.
Error Handling
None.