|
|
|
|
dialog.image Shows a image dialog |
Usage |
dialog.image [-b] (<type>,<caption>,<initial_directory>,[<maxsize>,[,<magic1>[,<magic2>[...]]]]]]) { <callback_command> } |
Description |
| 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. |
Examples |
dialog.image(f,Choose an image file,/home/pragma/,"256000") { if("$0" != "")run okular $0 } |