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.
Syntax Specification
dialog.image [-b] (<type>,<caption>,<initial_directory>,[<maxsize>,[,<magic1>[,<magic2>[...]]]]]])
{
    <callback_command>
}
Examples

    dialog.image(f,Choose an image file,/home/pragma/,"256000")
    {
        if("$0" != "")run kview $0
    }


Index, Commands
KVIrc 3.9.99 Documentation
Generated by root at Wed Oct 17 19:34:06 2007