Dialogs.dll

To better view, maximize the Window!!!!
A plugin for call the Open and Folder browse dialogs.
Copy Dialogs.dll into your NSIS' plugin folder.
This plugin is for NSIS versions 2.0 or other versions that support the plugin feature.

Contents:
1. About.
2. Functions & Syntax.
3. Other Functions.
4. Author.
5. TODO.
6. Versions.

=======================

1. About.
This plugin was build with Visual C++ 6.0, you'll need Windows 95/98/NT/2000/Me/XP.
If you found errors (bugs) report them, please!!!! :)

2. Functions & Syntax:
The main functions of the plugin are:

a) "Open". Function to call the Open file dialog. Syntax:

Dialogs::Open <hwnd_of_the_parent> <custom_filter> <custom_index_filter> <custom_dialog_title> <intial_folder> <output_var>

<hwnd_of_the_parent>: Use $HWNDPARENT.
<custom_filter>: The filter of the dialog, for example: "All files(*.*)|*.*|sound file (*.wav)|*.wav|". To use this add the char. "|" as separator between filter name and filter patern; always close it with "|" (see Open.nsi & Save.nsi).
<custom_index_filter>: If you use multiple paters, use this as the default filter when the dialog appears.
<custom_dialog_title>: Change the default title of the dialog.
<intial_folder>: Where to start listing the files in the dialog.
<output_var>: typical System plugin. .r0 -> $0; .r1 -> $1.....
See the example "Open.nsi".

b) "Folder". Function to call the Folder Browse dialog. Syntax:

Dialogs::Folder <hwnd_of_the_parent> <custom_string> <output_var>

<hwnd_of_the_parent>:  Use $HWNDPARENT.
<custom_string>: Customize the inner string, not the dialog title.
<output_var>: .r0 -> $0; .r1 -> $1; and so on....
See the example "Folder.nsi".

c) "Save". Function to call the Save file dialog. Syntax:

Dialogs::Save <hwnd_of_the_parent> <custom_filter> <custom_index_filter> <custom_dialog_title> <intial_folder> <output_var>

<hwnd_of_the_parent>:  Use $HWNDPARENT.
<custom_filter>: The filter of the dialog, for example: "All files(*.*)|*.*|sound file (*.wav)|*.wav|". To use this add the char. "|" as separator between filter name and filter patern; always close it with "|" (see Open.nsi & Save.nsi).
<custom_index_filter>: If you use multiple paters, use this as the default filter when the dialog appears.
<custom_dialog_title>: Change the default title of the dialog.
<intial_folder>: Where to start listing the files in the dialog.
<output_var>: .r0 -> $0; .r1 -> $1; and so on....
See the example "Save.nsi".

3. Other Functions:
Might help in some way ;)

a) "Author". Well.... me :P
b) "Ver". Function to obtain the current version of the plugin.
See the example "Other.nsi".

4. Author:
This plugin was created by Lobo Lunar (Joel Almeida Garca).
Email: lobolunarnet@yahoo.com.mx

5. TODO:
1. Customize the filter. I want to customize it to use multiple filters and not just one. [done]
2. Users ideas :D
3. Add the Save dialog [done]
4. Add a custom start-up directory in the Folder Dialog.

6. Versions:
1.0: Release.
1.1: Added the "Save" Dialog.
1.2: Change syntax.
     Added the custom Index filter. 
     Added the multiple filter for both Open and Save Dialogs. 
     Added "Create Folfer" button on Folder Dialog.
     Remove the current selection folder label in Folder Browse (maybe I'll put it back).