- added ME_FILEDLG_CANCELED & ME_FILEDLG_SUCCEEDED events to support async file selection dialog;

- return value of MS_FILE_SENDFILE* services changed: now it returns a dialog handle;
- code cleaning

git-svn-id: http://svn.miranda-ng.org/main/trunk@8253 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

1 files changed, 39 insertions, 33 deletions

diff --git a/include/m_file.h b/include/m_file.h
index 98597bb745..ccb39cd66d 100644
--- a/include/m_file.h
+++ b/include/m_file.h
@@ -25,45 +25,51 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 #ifndef M_FILE_H__

 #define M_FILE_H__ 1

 

-//brings up the send file dialog for a contact

-//wParam = (WPARAM)(HANDLE)hContact

-//lParam = 0

-//returns 0 on success or nonzero on failure

-//returns immediately, without waiting for the send

+// brings up the send file dialog for a contact

+// wParam = (MCONTACT)hContact

+// lParam = 0

+// returns file selection dialog's handle or 0 on error

+// returns immediately, without waiting for the send

 #define MS_FILE_SENDFILE   "SRFile/SendCommand"

 

-//brings up the send file dialog with the specified files already chosen

-//v0.1.2.1+

-//wParam = (WPARAM)(HANDLE)hContact

-//lParam = (LPARAM)(const char**)ppFiles

-//returns 0 on success or nonzero on failure

-//returns immediately, without waiting for the send

-//the user is not prevented from changing the filename with the 'choose again'

-//button

-//ppFiles is a NULL-terminated array of fully qualified filenames.

-//To send subdirectories, include their name in the list without a trailing

-//backslash. In order to keep contained files in their correct place on

-//receiving, the subdirectory they're in must preceed the file. This applies

-//to subdirectories themselves too: they must be preceeded by their container

-//if you want to send the container and keep the original directory inside it.

+// brings up the send file dialog with the specified files already chosen

+// returns immediately, without waiting for the send

+// wParam = (WPARAM)(HANDLE)hContact

+// lParam = (LPARAM)(const char**)ppFiles

+// returns file selection dialog's handle or 0 on error

+// returns immediately, without waiting for the send

+// the user is not prevented from changing the filename with the 'choose again' button

+// ppFiles is a NULL-terminated array of fully qualified filenames.

+// To send subdirectories, include their name in the list without a trailing

+// backslash. In order to keep contained files in their correct place on

+// receiving, the subdirectory they're in must preceed the file. This applies

+// to subdirectories themselves too: they must be preceeded by their container

+// if you want to send the container and keep the original directory inside it.

 #define MS_FILE_SENDSPECIFICFILES  "SRFile/SendSpecificFiles"

 

-//v0.9.0+

-//wParam = (WPARAM)(HANDLE)hContact

-//lParam = (LPARAM)(const TCHAR**)ppFiles

-//returns 0 on success or nonzero on failure

-//returns immediately, without waiting for the send

+// wParam = (MCONTACT)hContact

+// lParam = (LPARAM)(const TCHAR**)ppFiles

+// returns file selection dialog's handle or 0 on error

+// returns immediately, without waiting for the send

 #define MS_FILE_SENDSPECIFICFILEST  "SRFile/SendSpecificFilesT"

 

-//get the received files folder    v0.1.2.2+

-//wParam = (WPARAM)(HANDLE)hContact

-//lParam = (LPARAM)(char *)pszOutput

-//returns 0 on success or nonzero on failure

-//pszOutput must be at least MAX_PATH characters long

-//If hContact is NULL this function will retrieve the received files folder

-//name without any appended user names.

-//Note that the directory name returned by this function does not necessarily

-//exist.

+// wParam = (MCONTACT)hContact

+// lParam = (LPARAM)(char *)pszOutput

+// returns 0 on success or nonzero on failure

+// pszOutput must be at least MAX_PATH characters long

+// If hContact is NULL this function will retrieve the received files folder

+// name without any appended user names.

+// Note that the directory name returned by this function does not necessarily exist.

 #define MS_FILE_GETRECEIVEDFILESFOLDER  "SRFile/GetReceivedFilesFolder"

 

+// notifies a caller about file send start

+// wParam = (MCONTACT)hContact

+// lParam = (LPARAM)(HWND)hwndDialog

+#define ME_FILEDLG_SUCCEEDED "SRFile/Dlg/Succeeded"

+

+// notifies a caller about file send cancellation

+// wParam = (MCONTACT)hContact

+// lParam = (LPARAM)(HWND)hwndDialog

+#define ME_FILEDLG_CANCELED "SRFile/Dlg/Canceled"

+

 #endif // M_FILE_H__