416 lines
14 KiB
C
416 lines
14 KiB
C
|
// ----------------------------------------------------------------------------
|
||
|
|
// Generated by InterfaceFactory [Wed May 07 00:55:56 2003]
|
||
|
|
//
|
||
|
|
// File : api_application.h
|
||
|
|
// Class : api_application
|
||
|
|
// class layer : Dispatchable Interface
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#ifndef __API_APPLICATION_H
|
||
|
|
#define __API_APPLICATION_H
|
||
|
|
|
||
|
|
#include <bfc/dispatch.h>
|
||
|
|
#include <bfc/platform/guid.h>
|
||
|
|
#include <bfc/platform/platform.h>
|
||
|
|
#ifdef _WIN32
|
||
|
|
#include "ifc_messageprocessor.h"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
enum
|
||
|
|
{
|
||
|
|
API_APPLICATION_SUCCESS = 0,
|
||
|
|
API_APPLICATION_FAILURE = 1,
|
||
|
|
};
|
||
|
|
|
||
|
|
enum
|
||
|
|
{
|
||
|
|
TRANSLATE_MODE_NORMAL = 0,
|
||
|
|
TRANSLATE_MODE_GLOBAL = 1,
|
||
|
|
TRANSLATE_MODE_CHILD = 2,
|
||
|
|
};
|
||
|
|
|
||
|
|
class NOVTABLE api_application: public Dispatchable
|
||
|
|
{
|
||
|
|
protected:
|
||
|
|
api_application() {}
|
||
|
|
~api_application() {}
|
||
|
|
|
||
|
|
public:
|
||
|
|
const wchar_t *main_getAppName(); // returns (e.g.) "Winamp"
|
||
|
|
const wchar_t *main_getVersionString(); // returns (e.g.) "Winamp 5.12"
|
||
|
|
const wchar_t *main_getVersionNumString(); // returns (e.g.) "5.12"
|
||
|
|
unsigned int main_getBuildNumber(); // returns (e.g.) 666
|
||
|
|
GUID main_getGUID();
|
||
|
|
|
||
|
|
#ifdef _WIN32
|
||
|
|
HANDLE main_getMainThreadHandle(); // This actually gives you a DuplicateHandle, so call CloseHandle() when you are done.
|
||
|
|
HINSTANCE main_gethInstance();
|
||
|
|
#endif // !_WIN32
|
||
|
|
|
||
|
|
const wchar_t *main_getCommandLine();
|
||
|
|
void main_shutdown( int deferred = TRUE );
|
||
|
|
void main_cancelShutdown();
|
||
|
|
int main_isShuttingDown();
|
||
|
|
const wchar_t *path_getAppPath();
|
||
|
|
const wchar_t *path_getUserSettingsPath();
|
||
|
|
|
||
|
|
// added for 5.58+ so gen_ff can fill @SKINSPATH@ in scripts correctly
|
||
|
|
const wchar_t *path_getSkinSettingsPath();
|
||
|
|
int app_getInitCount();
|
||
|
|
intptr_t app_messageLoopStep();
|
||
|
|
|
||
|
|
#ifdef _WIN32
|
||
|
|
void app_addMessageProcessor( ifc_messageprocessor *processor );
|
||
|
|
void app_removeMessageProcessor( ifc_messageprocessor *processor );
|
||
|
|
|
||
|
|
/* accelerators are 5.53+ */
|
||
|
|
void app_addAccelerators( HWND hwnd, HACCEL *phAccel, INT cAccel, UINT translateMode );
|
||
|
|
void app_removeAccelerators( HWND hwnd );
|
||
|
|
bool app_translateAccelerators( MSG *msg );
|
||
|
|
int app_getAccelerators( HWND hwnd, HACCEL *phAccel, INT cchAccelMax, BOOL bGlobal ); // phAccel == NULL && cchAccelMax == 0 -> returns accels count
|
||
|
|
|
||
|
|
/* register window as part of winamp global group (5.54+) */
|
||
|
|
void app_registerGlobalWindow( HWND hwnd );
|
||
|
|
void app_unregisterGlobalWindow( HWND hwnd );
|
||
|
|
|
||
|
|
/* 5.58 + */
|
||
|
|
bool DirectMouseWheel_RegisterSkipClass( ATOM klass );
|
||
|
|
bool DirectMouseWheel_UnregisterSkipClass( ATOM klass );
|
||
|
|
bool DirectMouseWheel_EnableConvertToMouseWheel( HWND hwnd, BOOL enable ); // !!! must be disabled before window destroyed !!!
|
||
|
|
|
||
|
|
/* 5.64 + */
|
||
|
|
BOOL DirectMouseWheel_ProcessDialogMessage( HWND hwnd, unsigned int uMsg, WPARAM wParam, LPARAM lParam, const int controls[], int controlslen );
|
||
|
|
|
||
|
|
/* 5.61 + */
|
||
|
|
void ActiveDialog_Register( HWND hwnd );
|
||
|
|
void ActiveDialog_Unregister( HWND hwnd );
|
||
|
|
HWND ActiveDialog_Get();
|
||
|
|
|
||
|
|
/* 5.64 + */
|
||
|
|
const wchar_t *getATFString(); // returns the current ATF formatting string
|
||
|
|
|
||
|
|
/* 5.66 + */
|
||
|
|
// used for dpi scaling so we're consistent in usage throughout the UI, etc
|
||
|
|
int getScaleX( int x );
|
||
|
|
int getScaleY( int y );
|
||
|
|
|
||
|
|
#endif // !_WIN32
|
||
|
|
|
||
|
|
/*
|
||
|
|
note: on windows, these two functions DON'T call Set/GetCurrentDirectory, Winamp maintains it's own path
|
||
|
|
because calling SetCurrentDirectory locks the folder
|
||
|
|
Added for 5.34
|
||
|
|
*/
|
||
|
|
const wchar_t *path_getWorkingPath(); // useful to call for populating lpstrInitialDir in GetOpenFileName
|
||
|
|
void path_setWorkingPath(const wchar_t *newPath); // useful to call for populating lpstrInitialDir in GetOpenFileName
|
||
|
|
|
||
|
|
/*
|
||
|
|
The following three function return you unique IDs you can use if you need
|
||
|
|
They are created anonymously, so information cannot be tracked back to a specific person
|
||
|
|
The main reason for their existence is that a few third party libraries require them
|
||
|
|
and some online media providers require this info for billing.
|
||
|
|
You can call this functions with a pointer to any 16 byte data structure cast to a GUID *
|
||
|
|
Added for 5.35
|
||
|
|
*/
|
||
|
|
// returns an ID unique to this computer, but not unique to the logged in user (two windows accts would share this ID)
|
||
|
|
int GetMachineID( GUID *id );
|
||
|
|
// returns an ID unique to this user. Another user logged in to the computer will have a different ID
|
||
|
|
// note that if Winamp was installed with "shared settings", the IDs of multiple users will probably be identical
|
||
|
|
// as we're just storing it in winamp.ini for now
|
||
|
|
int GetUserID( GUID *id );
|
||
|
|
// returns a unique ID for this session. Generated on the fly the first time someone calls this function
|
||
|
|
int GetSessionID( GUID *id );
|
||
|
|
|
||
|
|
/* 5.54 + */
|
||
|
|
size_t AllocateThreadStorage(); // returns an index, -1 for error
|
||
|
|
void *GetThreadStorage(size_t index);
|
||
|
|
void SetThreadStorage(size_t index, void *value);
|
||
|
|
|
||
|
|
protected:
|
||
|
|
enum
|
||
|
|
{
|
||
|
|
API_APPLICATION_MAIN_GETAPPNAME = 10,
|
||
|
|
API_APPLICATION_MAIN_GETVERSIONSTRING = 20,
|
||
|
|
API_APPLICATION_MAIN_GETVERSIONSTRING2 = 21,
|
||
|
|
API_APPLICATION_MAIN_GETBUILDNUMBER = 30,
|
||
|
|
API_APPLICATION_MAIN_GETGUID = 40,
|
||
|
|
API_APPLICATION_MAIN_GETMAINTHREADHANDLE = 50,
|
||
|
|
API_APPLICATION_MAIN_GETHINSTANCE = 60,
|
||
|
|
API_APPLICATION_MAIN_GETCOMMANDLINE = 70,
|
||
|
|
API_APPLICATION_MAIN_SHUTDOWN = 80,
|
||
|
|
API_APPLICATION_MAIN_CANCELSHUTDOWN = 90,
|
||
|
|
API_APPLICATION_MAIN_ISSHUTTINGDOWN = 100,
|
||
|
|
API_APPLICATION_PATH_GETAPPPATH = 110,
|
||
|
|
API_APPLICATION_PATH_GETUSERSETTINGSPATH = 120,
|
||
|
|
API_APPLICATION_APP_GETINITCOUNT = 130,
|
||
|
|
API_APPLICATION_APP_MESSAGELOOPSTEP = 140,
|
||
|
|
API_APPLICATION_APP_ADDMESSAGEPROCESSOR = 150,
|
||
|
|
API_APPLICATION_APP_REMOVEMESSAGEPROCESSOR = 160,
|
||
|
|
API_APPLICATION_APP_ADDMODELESSDIALOG = 170,
|
||
|
|
API_APPLICATION_APP_REMOVEMODELESSDIALOG = 180,
|
||
|
|
API_APPLICATION_PATH_GETWORKINGPATH = 190,
|
||
|
|
API_APPLICATION_PATH_SETWORKINGPATH = 200,
|
||
|
|
API_APPLICATION_GETMACHINEID = 210,
|
||
|
|
API_APPLICATION_GETUSERID = 220,
|
||
|
|
API_APPLICATION_GETSESSIONID = 230,
|
||
|
|
API_APPLICATION_APP_ADDACCELERATORS = 240,
|
||
|
|
API_APPLICATION_APP_REMOVEACCELERATORS = 250,
|
||
|
|
API_APPLICATION_APP_TRANSLATEACCELERATORS = 260,
|
||
|
|
API_APPLICATION_APP_GETACCELERATORS = 270,
|
||
|
|
API_APPLICATION_APP_REGISTERGLOBALWINDOW = 280,
|
||
|
|
API_APPLICATION_APP_UNREGISTERGLOBALWINDOW = 290,
|
||
|
|
API_APPLICATION_ALLOCATETHREADSTORAGE = 300,
|
||
|
|
API_APPLICATION_GETTHREADSTORAGE = 310,
|
||
|
|
API_APPLICATION_SETTHREADSTORAGE = 320,
|
||
|
|
API_APPLICATION_PATH_GETSKINSETTINGSPATH = 330,
|
||
|
|
API_APPLICATION_DIRECTMOUSEWHEEL_REGISTERSKIPCLASS = 340,
|
||
|
|
API_APPLICATION_DIRECTMOUSEWHEEL_UNREGISTERSKIPCLASS = 350,
|
||
|
|
API_APPLICATION_DIRECTMOUSEWHEEL_ENABLECONVERTTOMOUSEWHEEL = 360,
|
||
|
|
API_APPLICATION_DIRECTMOUSEWHEEL_PROCESSDIALOGMESSAGE = 365,
|
||
|
|
API_APPLICATION_ACTIVEDIALOG_REGISTER = 370,
|
||
|
|
API_APPLICATION_ACTIVEDIALOG_UNREGISTER = 380,
|
||
|
|
API_APPLICATION_ACTIVEDIALOG_GET = 390,
|
||
|
|
API_APPLICATION_GETATFSTRING = 400,
|
||
|
|
API_APPLICATION_GETSCALEX = 500,
|
||
|
|
API_APPLICATION_GETSCALEY = 510,
|
||
|
|
};
|
||
|
|
};
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::main_getAppName()
|
||
|
|
{
|
||
|
|
const wchar_t *__retval = _call(API_APPLICATION_MAIN_GETAPPNAME, (const wchar_t *)0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::main_getVersionString()
|
||
|
|
{
|
||
|
|
const wchar_t *__retval = _call(API_APPLICATION_MAIN_GETVERSIONSTRING, (const wchar_t *)0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::main_getVersionNumString()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_MAIN_GETVERSIONSTRING2, (const wchar_t *)0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline unsigned int api_application::main_getBuildNumber()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_MAIN_GETBUILDNUMBER, 0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline GUID api_application::main_getGUID()
|
||
|
|
{
|
||
|
|
GUID __retval = _call(API_APPLICATION_MAIN_GETGUID, INVALID_GUID);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
#ifdef _WIN32
|
||
|
|
inline HANDLE api_application::main_getMainThreadHandle()
|
||
|
|
{
|
||
|
|
HANDLE __retval = _call(API_APPLICATION_MAIN_GETMAINTHREADHANDLE, (HANDLE)NULL);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline HINSTANCE api_application::main_gethInstance()
|
||
|
|
{
|
||
|
|
HINSTANCE __retval = _call(API_APPLICATION_MAIN_GETHINSTANCE, (HINSTANCE)NULL);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::main_getCommandLine()
|
||
|
|
{
|
||
|
|
const wchar_t *__retval = _call(API_APPLICATION_MAIN_GETCOMMANDLINE, (const wchar_t *)0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::main_shutdown(int deferred)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_MAIN_SHUTDOWN, deferred);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::main_cancelShutdown()
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_MAIN_CANCELSHUTDOWN);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::main_isShuttingDown()
|
||
|
|
{
|
||
|
|
int __retval = _call(API_APPLICATION_MAIN_ISSHUTTINGDOWN, (int)0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::path_getAppPath()
|
||
|
|
{
|
||
|
|
const wchar_t *__retval = _call(API_APPLICATION_PATH_GETAPPPATH, (const wchar_t *)0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::path_getUserSettingsPath()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_PATH_GETUSERSETTINGSPATH, (const wchar_t *)0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::path_getSkinSettingsPath()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_PATH_GETSKINSETTINGSPATH, (const wchar_t *)0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::app_getInitCount()
|
||
|
|
{
|
||
|
|
int __retval = _call(API_APPLICATION_APP_GETINITCOUNT, 0);
|
||
|
|
return __retval;
|
||
|
|
}
|
||
|
|
|
||
|
|
inline intptr_t api_application::app_messageLoopStep()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_APP_MESSAGELOOPSTEP, (intptr_t)1);
|
||
|
|
}
|
||
|
|
|
||
|
|
#ifdef _WIN32
|
||
|
|
inline void api_application::app_addMessageProcessor(ifc_messageprocessor *processor)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_ADDMESSAGEPROCESSOR, processor);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::app_removeMessageProcessor(ifc_messageprocessor *processor)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_REMOVEMESSAGEPROCESSOR, processor);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::app_addAccelerators(HWND hwnd, HACCEL *phAccel, INT cAccel, UINT translateMode)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_ADDACCELERATORS, hwnd, phAccel, cAccel, translateMode);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::app_removeAccelerators(HWND hwnd)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_REMOVEACCELERATORS, hwnd);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline bool api_application::app_translateAccelerators(MSG *msg)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_APP_TRANSLATEACCELERATORS, (bool)false, msg);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::app_getAccelerators(HWND hwnd, HACCEL *phAccel, INT cchAccelMax, BOOL bGlobal)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_APP_GETACCELERATORS, (int)0, hwnd, phAccel, cchAccelMax, bGlobal);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::app_registerGlobalWindow(HWND hwnd)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_REGISTERGLOBALWINDOW, hwnd);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::app_unregisterGlobalWindow(HWND hwnd)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_APP_UNREGISTERGLOBALWINDOW, hwnd);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline bool api_application::DirectMouseWheel_RegisterSkipClass(ATOM klass)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_DIRECTMOUSEWHEEL_REGISTERSKIPCLASS, (bool)false, klass);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline bool api_application::DirectMouseWheel_UnregisterSkipClass(ATOM klass)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_DIRECTMOUSEWHEEL_UNREGISTERSKIPCLASS, (bool)false, klass);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline bool api_application::DirectMouseWheel_EnableConvertToMouseWheel(HWND hwnd, BOOL enable)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_DIRECTMOUSEWHEEL_ENABLECONVERTTOMOUSEWHEEL, (bool)false, hwnd, enable);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline BOOL api_application::DirectMouseWheel_ProcessDialogMessage(HWND hwnd, unsigned int uMsg, WPARAM wParam, LPARAM lParam, const int controls[], int controlslen)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_DIRECTMOUSEWHEEL_PROCESSDIALOGMESSAGE, (BOOL)FALSE, hwnd, uMsg, wParam, lParam, controls, controlslen);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::ActiveDialog_Register(HWND hwnd)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_ACTIVEDIALOG_REGISTER, hwnd);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::ActiveDialog_Unregister(HWND hwnd)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_ACTIVEDIALOG_UNREGISTER, hwnd);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline HWND api_application::ActiveDialog_Get()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_ACTIVEDIALOG_GET, (HWND)NULL);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::getATFString()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETATFSTRING, (wchar_t *)0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::getScaleX(int x)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETSCALEX, (int)0, x);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::getScaleY(int y)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETSCALEY, (int)0, y);
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
inline const wchar_t *api_application::path_getWorkingPath()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_PATH_GETWORKINGPATH, (wchar_t *)0);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::path_setWorkingPath(const wchar_t *newPath)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_PATH_SETWORKINGPATH, newPath);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::GetMachineID(GUID *id)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETMACHINEID, (int)API_APPLICATION_FAILURE, id);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::GetUserID(GUID *id)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETUSERID, (int)API_APPLICATION_FAILURE, id);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline int api_application::GetSessionID(GUID *id)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETSESSIONID, (int)API_APPLICATION_FAILURE, id);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline size_t api_application::AllocateThreadStorage()
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_ALLOCATETHREADSTORAGE, (size_t)-1);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void *api_application::GetThreadStorage(size_t index)
|
||
|
|
{
|
||
|
|
return _call(API_APPLICATION_GETTHREADSTORAGE, (void *)0, index);
|
||
|
|
}
|
||
|
|
|
||
|
|
inline void api_application::SetThreadStorage(size_t index, void *value)
|
||
|
|
{
|
||
|
|
_voidcall(API_APPLICATION_SETTHREADSTORAGE, index, value);
|
||
|
|
}
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// {23B96771-09D7-46d3-9AE2-20DCEA6C86EA}
|
||
|
|
static const GUID applicationApiServiceGuid =
|
||
|
|
{
|
||
|
|
0x23b96771, 0x9d7, 0x46d3, { 0x9a, 0xe2, 0x20, 0xdc, 0xea, 0x6c, 0x86, 0xea }
|
||
|
|
};
|
||
|
|
|
||
|
|
extern api_application *applicationApi;
|
||
|
|
|
||
|
|
#endif // __API_APPLICATION_H
|