PA_Dial4DSetPictureHandle

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_Dial4DSetPictureHandle (dialog; variable; newPicture; info)

ParameterTypeDescription
dialogPA_Dial4DDialog reference
variablechar*Name of the variable to access
newPicturePA_HandleHandle to the picture data
infoPA_PictureInfoPicture 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.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next