|
|
|
|
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.