# 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.2.0.6190 Documentation
Generated by portbuild at Mon Aug 12 12:09:14 2013