dialog.imageShows a image dialog
|Shows a dialog that allows selecting an [doc:image_id]image_id[doc].
The <type> parameter must be a combination of the following flags:<br>
's' : allow selecting from the KVIrc builtin small icons<br>
'f' : allow browsing the local directories<br>
'a' : all of the above<br>
The default for <type> is 'a'.<br>
<caption> is the caption string for the dialog.<br>
<initial_directory> makes sense only if 'f' is specified (if <initial_directory> is empty
then the last path used by the image dialog will be used).<br>
<maxsize> is the maximum size of the images for that the preview will be generated:
this is 256000 bytes by default (if unspecified). Don't make it a lot bigger : it can take a lot to make
the thumbnails for bigger images (and it can eat a considerable amount of memory).<br>
<magic1>,<magic2>... are the magic parameters: evaluated at dialog.image call time and passed
to the <callback_command> as positional parameters.
If the -b or -modal switch is specified the dialog will have non-blocking modal behaviour: it will appear above its parent widget and block its input until it's closed.
Once the dialog has been shown , the user will select an EXISTING file and click either Ok or Cancel. At this point the dialog is hidden and the <callback_command> is executed passing the selected file(s) as $0 and the magic parameters as positional parameters $1 , $2 , $3....
If the user clicks "Cancel" or does not select any image the positional parameter $0 will be empty.