/*
'File Association Manager'-Plugin for
Miranda NG: the free IM client for Microsoft* Windows*
Copyright (C) 2012-22 Miranda NG team (https://miranda-ng.org),
Copyright (C) 2005-2007 H. Herkenrath
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program (AssocMgr-License.txt); if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
#ifndef M_ASSOCMGR_H__
#define M_ASSOCMGR_H__
/* Add a new file type v0.1.0.0+
Add a new file type to be registered with Windows.
You probably want to call this event when
ME_SYSTEM_MODULESLOADED is fired.
wParam=0
lParam=(LPARAM)(FILETYPEDESC*)ftd
Returns 0 on success, nonzero otherwise.
*/
#define MS_ASSOCMGR_ADDNEWFILETYPE "AssocMgr/AddNewFileType"
typedef struct {
int cbSize; // set to sizeof(FILETYPEDESC), in bytes
const wchar_t *pwszDescription; // description for options dialog and in registry.
HINSTANCE hInstance; // instance of the calling module and where the icon
// resource is located.
// always be sure you set this to your own hInstance even if
// you use the generic default icon
UINT nIconResID; // resource id of an icon to use for the file type.
// this icon should contain icons of all sizes and color depths
// needed by Windows.
// set this to 0 to use the generic 'miranda file' icon
// provided by assocmgr.
const char *pszService; // service to call when a file is opened
// this service will be called with lParam set to
// the file name being opened including path.
// it can be assumed that the provided file name
// is always the long path name.
// return zero on suceess, nonzero on error.
// Note: set this to NULL to pass the file name as
// commandline argument to miranda32.exe (db file).
DWORD flags; // see FTDF_* flags below
const char *pszFileExt; // file extension, e.g. ".ext"
// first character must be a dot, assumed to be all lower case.
// may only consist of ascii characters.
const char *pszMimeType; // MIME type of the file, e.g. "application/x-icq"
// may only consist of ascii characters.
const wchar_t *pwszVerbDesc; // description for the open verb e.g. "&Install".
// include an ampersand (&) character for a mnemonic key.
// please Translate().
} FILETYPEDESC;
#define FTDF_UNICODE 0x0001 // pszDescription and pszVerbDesc in struct are Unicode.
// the specified service is called with Unicode parameters.
#define FTDF_DEFAULTDISABLED 0x0002 // file type is not registered by default, it needs to be
// enabled explicitly on the options page.
#define FTDF_BROWSERAUTOOPEN 0x0004 // tells the browser to download and open the file directly
// without prompt (currently IE and Opera6+) - be careful!
// use only in conjunction with pszMimeType set.
// this tells Windows that open can be safely invoked for
// downloaded files.
// Note that this flag may create a security risk,
// because downloaded files could contain malicious content.
// you need to protect against such an exploit.
#define FTDF_ISTEXT 0x0008 // tells Windows that this file can be opened
// as a text file using e.g Notepad.
// only has an effect on Windows XP and higher.
#define FTDF_ISSHORTCUT 0x0010 // file type behaves as shortcut, this means a
// small overlay arrow is applied and the extension is never shown
__inline static int AssocMgr_AddNewFileTypeW(const char *ext, const char *mime, const wchar_t *desc, const wchar_t *verb, HINSTANCE hinst, UINT iconid, const char *service, DWORD flags)
{
FILETYPEDESC ftd;
ftd.cbSize = sizeof(FILETYPEDESC);
ftd.pszFileExt = ext;
ftd.pszMimeType = mime;
ftd.pwszDescription = desc;
ftd.pwszVerbDesc = verb;
ftd.hInstance = hinst;
ftd.nIconResID = iconid;
ftd.pszService = service;
ftd.flags = flags | FTDF_UNICODE;
return CallService(MS_ASSOCMGR_ADDNEWFILETYPE, 0, (LPARAM)&ftd);
}
/* Remove a file type v0.1.0.0+
Remove a file type registered previously using
MS_ASSOCMGR_ADDNEWFILETYPE.
This removes all settings in database and in registry
associated with the file type.
wParam=0
lParam=(WPARAM)(char*)pszFileExt
Returns 0 on success, nonzero otherwise.
*/
#define MS_ASSOCMGR_REMOVEFILETYPE "AssocMgr/RemoveFileType"
/* Add a new url protocol type v0.1.0.0+
Add a new url type to be registered with Windows.
You probably want to call this event when
ME_SYSTEM_MODULESLOADED is fired.
wParam=0
lParam=(LPARAM)(URLTYPEDESC*)utd
Returns 0 on success, nonzero otherwise.
*/
#define MS_ASSOCMGR_ADDNEWURLTYPE "AssocMgr/AddNewUrlType"
typedef struct {
int cbSize; // set to sizeof(URLTYPEDESC), in bytes
const wchar_t *pwszDescription; // description for options dialog and in registry.
HINSTANCE hInstance; // instance of the calling module and where the icon
// resource is located.
// always be sure you set this to your own hInstance even if
// you use the generic default icon
UINT nIconResID; // resource id of an icon to use for the url type.
// only a small one (16x16) is needed by Windows,
// e.g. proto icon as used in Miranda.
// set this to 0 to use the default miranda icon.
const char *pszService; // service to call when a url is opened (can't be NULL)
// this service will be called with lParam set to
// the url being opened including the prefix.
// return zero on suceess, nonzero on error.
DWORD flags; // see UTDF_* flags below
const char *pszProtoPrefix; // protocol prefix, e.g. "http:"
// last character must be a colon, assumed to be all lower case.
// may only consist of ascii characters.
} URLTYPEDESC;
#define UTDF_UNICODE 0x0001 // pszDescription in struct is Unicode.
// the specified service is called with Unicode parameters.
#define UTDF_DEFAULTDISABLED 0x0002 // url type is not registered by default, it needs to be
// enabled explicitly on the options page.
static int __inline AssocMgr_AddNewUrlTypeW(const char *prefix, const wchar_t *desc, HINSTANCE hinst, UINT iconid, const char *service, DWORD flags)
{
URLTYPEDESC utd;
utd.cbSize = sizeof(URLTYPEDESC);
utd.pszProtoPrefix = prefix;
utd.pwszDescription = desc;
utd.hInstance = hinst;
utd.nIconResID = iconid;
utd.pszService = service;
utd.flags = flags | UTDF_UNICODE;
return CallService(MS_ASSOCMGR_ADDNEWURLTYPE, 0, (LPARAM)&utd);
}
/* Remove an url protocol type v0.1.0.0+
Remove an url registered previously using
MS_ASSOCMGR_ADDNEWURLTYPE.
This removes all settings in database and in registry
associated with the url type.
wParam=0
lParam=(WPARAM)(char*)pszProtoPrefix
Returns 0 on success, nonzero otherwise.
*/
#define MS_ASSOCMGR_REMOVEURLTYPE "AssocMgr/RemoveUrlType"
/* utility which should be moved as service into m_netlib.h (MS_NETLIB_URLENCODE already exists) */
#if defined(MoveMemory) && defined(lstrlen)
static __inline char *Netlib_UrlDecode(char *str)
{
char *psz = str;
for (; *psz; ++psz)
switch (*psz) {
case '+':
*psz = ' ';
break;
case '%':
if (!psz[1] || !psz[2]) break;
MoveMemory(psz, &psz[1], 2);
psz[2] = 0;
*psz = (char)strtol(psz, nullptr, 16);
MoveMemory(&psz[1], &psz[3], mir_strlen(&psz[3]) + 1);
break;
}
return str;
}
#endif
#ifndef ASSOCMGR_NOSETTINGS
#define SETTING_ONLYWHILERUNNING_DEFAULT 0
#endif
#endif // M_ASSOCMGR_H