You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
275 lines
11 KiB
275 lines
11 KiB
/////////////////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// Copyright (c) 1998 Active Voice Corporation. All Rights Reserved.
|
|
//
|
|
// Active Agent(r) and Unified Communications(tm) are trademarks of Active Voice Corporation.
|
|
//
|
|
// Other brand and product names used herein are trademarks of their respective owners.
|
|
//
|
|
// The entire program and user interface including the structure, sequence, selection,
|
|
// and arrangement of the dialog, the exclusively "yes" and "no" choices represented
|
|
// by "1" and "2," and each dialog message are protected by copyrights registered in
|
|
// the United States and by international treaties.
|
|
//
|
|
// Protected by one or more of the following United States patents: 5,070,526, 5,488,650,
|
|
// 5,434,906, 5,581,604, 5,533,102, 5,568,540, 5,625,676, 5,651,054.
|
|
//
|
|
// Active Voice Corporation
|
|
// Seattle, Washington
|
|
// USA
|
|
//
|
|
/////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
////
|
|
// res.h - interface for resource functions in res.c
|
|
////
|
|
|
|
#ifndef __RES_H__
|
|
#define __RES_H__
|
|
|
|
#include "winlocal.h"
|
|
|
|
#include "commdlg.h"
|
|
|
|
#define RES_VERSION 0x00000107
|
|
|
|
// handle to res engine
|
|
//
|
|
DECLARE_HANDLE32(HRES);
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// ResInit - initialize resource engine
|
|
// <dwVersion> (i) must be RES_VERSION
|
|
// <hInst> (i) instance handle of calling module
|
|
// return handle (NULL if error)
|
|
//
|
|
HRES DLLEXPORT WINAPI ResInit(DWORD dwVersion, HINSTANCE hInst);
|
|
|
|
// ResTerm - shut down resource engine
|
|
// <hRes> (i) handle returned from ResInit
|
|
// return 0 if success
|
|
//
|
|
int DLLEXPORT WINAPI ResTerm(HRES hRes);
|
|
|
|
// ResAddModule - add module resources to res engine
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <hInst> (i) instance handle of resource module
|
|
// return 0 if success
|
|
//
|
|
int DLLEXPORT WINAPI ResAddModule(HRES hRes, HINSTANCE hInst);
|
|
|
|
// ResRemoveModule - remove module resources from res engine
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <hInst> (i) instance handle of resource module
|
|
// return 0 if success
|
|
//
|
|
int DLLEXPORT WINAPI ResRemoveModule(HRES hRes, HINSTANCE hInst);
|
|
|
|
// ResLoadAccelerators - load specified accelerator table
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszTableName> (i) name of accelerator table
|
|
// or MAKEINTRESOURCE(idAccel)
|
|
// return accel handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadAccelerators function
|
|
//
|
|
HACCEL DLLEXPORT WINAPI ResLoadAccelerators(HRES hRes, LPCTSTR lpszTableName);
|
|
|
|
// ResLoadBitmap - load specified bitmap resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// NULL load pre-defined Windows bitmap
|
|
// <lpszBitmap> (i) name of bitmap resource
|
|
// or MAKEINTRESOURCE(idBitmap)
|
|
// or <OBM_xxx> if hRes is NULL
|
|
// return bitmap handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadBitmap function
|
|
//
|
|
HBITMAP DLLEXPORT WINAPI ResLoadBitmap(HRES hRes, LPCTSTR lpszBitmap);
|
|
|
|
// ResLoadCursor - load specified cursor resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// NULL load pre-defined Windows cursor
|
|
// <lpszCursor> (i) name of cursor resource
|
|
// or MAKEINTRESOURCE(idCursor)
|
|
// or <IDC_xxx> if hRes is NULL
|
|
// return cursor handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadCursor function
|
|
//
|
|
HCURSOR DLLEXPORT WINAPI ResLoadCursor(HRES hRes, LPCTSTR lpszCursor);
|
|
|
|
// ResLoadIcon - load specified icon resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// NULL load pre-defined Windows icon
|
|
// <lpszIcon> (i) name of icon resource
|
|
// or MAKEINTRESOURCE(idIcon)
|
|
// or <IDI_xxx> if hRes is NULL
|
|
// return icon handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadIcon function
|
|
//
|
|
HICON DLLEXPORT WINAPI ResLoadIcon(HRES hRes, LPCTSTR lpszIcon);
|
|
|
|
// ResLoadMenu - load specified menu resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszMenu> (i) name of menu resource
|
|
// or MAKEINTRESOURCE(idMenu)
|
|
// return menu handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadMenu function
|
|
//
|
|
HMENU DLLEXPORT WINAPI ResLoadMenu(HRES hRes, LPCTSTR lpszMenu);
|
|
|
|
// ResFindResource - find specified resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszName> (i) resource name
|
|
// or MAKEINTRESOURCE(idResource)
|
|
// <lpszType> (i) resource type (RT_xxx)
|
|
// return resource handle if success, otherwise NULL
|
|
// NOTE: see documentation for FindResource function
|
|
//
|
|
HRSRC DLLEXPORT WINAPI ResFindResource(HRES hRes, LPCTSTR lpszName, LPCTSTR lpszType);
|
|
|
|
// ResLoadResource - load specified resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <hrsrc> (i) handle returned from ResFindResource
|
|
// return resource handle if success, otherwise NULL
|
|
// NOTE: see documentation for LoadResource function
|
|
//
|
|
HGLOBAL DLLEXPORT WINAPI ResLoadResource(HRES hRes, HRSRC hrsrc);
|
|
|
|
// ResLoadString - load specified string resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <idResource> (i) string id
|
|
// <lpszBuffer> (o) buffer to receive the string
|
|
// <cbBuffer> (i) buffer size in bytes
|
|
// return number of bytes copied to <lpszBuffer>, -1 if error, 0 if not found
|
|
// NOTE: see documentation for LoadString function
|
|
//
|
|
int DLLEXPORT WINAPI ResLoadString(HRES hRes, UINT idResource, LPTSTR lpszBuffer, int cbBuffer);
|
|
|
|
// ResString - return specified string resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <idResource> (i) string id
|
|
// return ptr to string in next available string buffer (NULL if error)
|
|
// NOTE: If the the specified id in <idResource> is not found,
|
|
// a string in the form "String #<idResource>" is returned.
|
|
//
|
|
LPTSTR DLLEXPORT WINAPI ResString(HRES hRes, UINT idResource);
|
|
|
|
// ResCreateDialog - create modeless dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszDlgTemp> (i) dialog box template name
|
|
// or MAKEINTRESOURCE(idDlg)
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// return dialog box window handle (NULL if error)
|
|
// NOTE: see documentation for CreateDialog function
|
|
//
|
|
HWND DLLEXPORT WINAPI ResCreateDialog(HRES hRes,
|
|
LPCTSTR lpszDlgTemp, HWND hwndOwner, DLGPROC dlgproc);
|
|
|
|
// ResCreateDialogIndirect - create modeless dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpvDlgTemp> (i) dialog box header structure
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// return dialog box window handle (NULL if error)
|
|
// NOTE: see documentation for CreateDialogIndirect function
|
|
//
|
|
HWND DLLEXPORT WINAPI ResCreateDialogIndirect(HRES hRes,
|
|
const void FAR* lpvDlgTemp, HWND hwndOwner, DLGPROC dlgproc);
|
|
|
|
// ResCreateDialogParam - create modeless dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszDlgTemp> (i) dialog box template name
|
|
// or MAKEINTRESOURCE(idDlg)
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// <lParamInit> (i) initialization value
|
|
// return dialog box window handle (NULL if error)
|
|
// NOTE: see documentation for CreateDialogParam function
|
|
//
|
|
HWND DLLEXPORT WINAPI ResCreateDialogParam(HRES hRes,
|
|
LPCTSTR lpszDlgTemp, HWND hwndOwner, DLGPROC dlgproc, LPARAM lParamInit);
|
|
|
|
// ResCreateDialogIndirectParam - create modeless dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpvDlgTemp> (i) dialog box header structure
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// <lParamInit> (i) initialization value
|
|
// return dialog box window handle (NULL if error)
|
|
// NOTE: see documentation for CreateDialogIndirectParam function
|
|
//
|
|
HWND DLLEXPORT WINAPI ResCreateDialogIndirectParam(HRES hRes,
|
|
const void FAR* lpvDlgTemp, HWND hwndOwner, DLGPROC dlgproc, LPARAM lParamInit);
|
|
|
|
// ResDialogBox - create modal dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszDlgTemp> (i) dialog box template name
|
|
// or MAKEINTRESOURCE(idDlg)
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// return dialog box return code (-1 if error)
|
|
// NOTE: see documentation for DialogBox function
|
|
//
|
|
INT_PTR DLLEXPORT WINAPI ResDialogBox(HRES hRes,
|
|
LPCTSTR lpszDlgTemp, HWND hwndOwner, DLGPROC dlgproc);
|
|
|
|
// ResDialogBoxIndirect - create modal dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <hglbDlgTemp> (i) dialog box header structure
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// return dialog box return code (-1 if error)
|
|
// NOTE: see documentation for DialogBoxIndirect function
|
|
//
|
|
INT_PTR DLLEXPORT WINAPI ResDialogBoxIndirect(HRES hRes,
|
|
HGLOBAL hglbDlgTemp, HWND hwndOwner, DLGPROC dlgproc);
|
|
|
|
// ResDialogBoxParam - create modal dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpszDlgTemp> (i) dialog box template name
|
|
// or MAKEINTRESOURCE(idDlg)
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// <lParamInit> (i) initialization value
|
|
// return dialog box return code (-1 if error)
|
|
// NOTE: see documentation for DialogBoxParam function
|
|
//
|
|
INT_PTR DLLEXPORT WINAPI ResDialogBoxParam(HRES hRes,
|
|
LPCTSTR lpszDlgTemp, HWND hwndOwner, DLGPROC dlgproc, LPARAM lParamInit);
|
|
|
|
// ResDialogBoxIndirectParam - create modal dialog box from template resource
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <hglbDlgTemp> (i) dialog box header structure
|
|
// <hwndOwner> (i) handle of owner window
|
|
// <dlgproc> (i) instance address of dialog box procedure
|
|
// <lParamInit> (i) initialization value
|
|
// return dialog box return code (-1 if error)
|
|
// NOTE: see documentation for DialogBoxIndirectParam function
|
|
//
|
|
INT_PTR DLLEXPORT WINAPI ResDialogBoxIndirectParam(HRES hRes,
|
|
HGLOBAL hglbDlgTemp, HWND hwndOwner, DLGPROC dlgproc, LPARAM lParamInit);
|
|
|
|
// ResGetOpenFileName - display common dialog for selecting a file to open
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpofn> (i/o) address of struct with initialization data
|
|
// return non-zero if file chosen, 0 if error or no file chosen
|
|
// NOTE: see documentation for GetOpenFileName function
|
|
//
|
|
BOOL DLLEXPORT WINAPI ResGetOpenFileName(HRES hRes, LPOPENFILENAME lpofn);
|
|
|
|
// ResGetSaveFileName - display common dialog for selecting a file to save
|
|
// <hRes> (i) handle returned from ResInit
|
|
// <lpofn> (i/o) address of struct with initialization data
|
|
// return non-zero if file chosen, 0 if error or no file chosen
|
|
// NOTE: see documentation for GetSaveFileName function
|
|
//
|
|
BOOL DLLEXPORT WINAPI ResGetSaveFileName(HRES hRes, LPOPENFILENAME lpofn);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // __RES_H__
|