# 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 okular $0
        }

Index, Commands

KVIrc 4.0.2.4740 Documentation
Generated by root at Tue Feb 1 06:16:04 2011