Output Parameters | Significance |
none | - |
Return Code | Significance |
0 | all ok |
1 | no record selected |
2 | no Ident number field in mask |
3 | error while reading binary file |
4 | file selection cancelled |
Can be called as On_Select-userexit in Select-menus/Select-button-areas or as On_Event-userexit in element-selection state.
With this function a binary file is either directly written into the field or selected from a file selection widget. The field must be of the B type (BLOB = Binary Large Object).
If <CLEAR> is passed as second parameter, the function deletes the content of the BLOB field and the database. The third parameter Location must be empty in this case.
The function updates the update date C_UPD_DAT and the version C_VERSION of the selected record.
The maximum size of binary data can be set via default variable BLOBSIZE.
If binary files are stored in the graphics formats BMP
, GIF
, JPG
, WMF
or ICO
, the graphics will be directly displayed if the BLOB field is used in forms. The field there should correspond to the size of the graphics or have a size at which the column width multiplied with the row length is larger than 10. In lists the BLOB field is always displayed without its field content.
If BLOB fields are displayed, the binary files are temporarily stored in a temporary directory at the client run-time. The name of this directory can be detected with the function dal_gfi_env_ipc ($TMP).