?? appface.h
字號:
/*
File: appface.h
Description: AppFace UI SDK export functions.
Version 0.4
Compatible with:
Microsoft Windows 9x, NT, 2000, XP ,2003
Microsoft Visual C++ 5-7
uses no MFC
*==========================================================
* Cpyright MatinSoft Inc. 2004.11.22
*
* COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTY
* OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
* THAT THE COVERED CODE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE
* OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED
* CODE IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT
* THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
* SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL
* PART OF THIS LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER
* THIS DISCLAIMER.
*
* Use at your own risk!
* ==========================================================
What is AppFace ?
AppFace For VC is a windows library which is designed to develop software
User Interface easily and quickly, or you can name it as "Windows application skin tool".It
make you beautify your software easily with calling several functions . With AppFace you could
save a mass of time and energy for the design of software UI , and you can create the
characterful and creative "application face" for your software quickly .
How to use it ?
AppFace.dll is a standard windows dynamic library,you can load it staticly or dynmaicly.
Call it staticly:
1.Copy appface.h and appface.lib to your project folder,and add them to your project ; copy appface.dll
to your application export folder,remark "#define LOAD_APPFACE_DYNAMIC" statement in appface.h
2.Load appface before the first window created by call : SkinStart(char* UiResourceFile,0,GTP_LOAD_FILE,0,0);
3.Before exit the process to release resource call this : SkinRemove();
Call it dynamicly:
The class CAppFace help you to load appface.dll easily .
1.Include this file in your project,and copy "AppFace.dll" to the project EXE file output folder.
2.Declare a global variable in your project: CAppFace g_af ;
3.Load appface before the first window created by call : g_af.Start(char* UiResourceFile);
4.Before exit the process to release resource call this : g_af.Remove();
Bugs reported:
appface@matinsoft.com
http://www.matinsoft.com
http://www.appface.com
------------------------------------------------------------
簡介:
AppFace For VC 是一個Windows界面開發庫,它能夠使您更輕松，更快捷的開發
軟件界面。您也可以把它稱做"應用程序皮膚工具"。使用AppFace界面開發包,只需
調用幾個函數，添加幾行代碼就能使您的軟件擁有漂亮的外觀。它能最大限度的降低您
在軟件界面上所花費的時間和精力,使您能夠將工作重心完全放在軟件的核心價值的
開發上.
使用方法:
AppFace.dll 是一個標準的Windows 動態鏈接庫，您可以靜態或動態的調用它的輸
出函數 。
靜態調用:
1.將 "appface.h" 已及 "appface.lib" 拷貝到您的工程目錄下,并將其添加到您的
工程中;將"AppFace.dll"拷貝到EXE文件的輸出目錄,去掉 "appface.h"中的如下語句:
"#define LOAD_APPFACE_DYNAMIC"
2. 在創建第一個窗口前調用 SkinStart (char * UiResourceFile,0,GTP_LOAD_FILE,0,0) ;
3. 在程序退出前調用 SkinRemove() ;
動態調用:
CAppFace這個類包裝了對AppFace.dll 中輸出函數的調用,幫助您更容易的
使用 AppFace 界面開發包.
1. 將這個文件添加進您的工程,將"AppFace.dll"拷貝到EXE文件的輸出目錄
2. 在您的工程中聲明一個全局變量 CAppFace g_af ;
3. 在創建第一個窗口前調用 g_af.Start(char * UiResourceFile) ;
4. 在程序退出前調用 g_af.Remove() ;
Bug reported:
support_cn@matinsoft.com
http://www.matinsoft.com
http://www.appface.com
-------------------------------------------------------------
History:
AppFace.h 0.4 2004.12.20
Added an export function : SkinThread
Supported loading appface.dll static linked .
Modified the paramerers order for CAppFace::Start function
Modified the description for this file .
AppFace.h 0.3 2004.12.08
Modified "Release" member function to prevert from throwing an exception
for debug version under Win XP
Modified the function prototype
Added a member function : BOOL SkinWindow(HWND hWnd,BOOL bSkin) ; We can decide which Window we need skin or not skin
Modified the description for class CAppFace .
AppFace.h 0.2 2004.11.25
Modified "Start" member fucntion to load urf file from resource or memory.
Modified the description for class CAppFace .
Supported UNICODE
Added a help function, void T2C(IN LPCTSTR src,OUT char* dst,IN int dstlen)
which used to convert a TCHAR string to char string
AppFace.h 0.1 2004.09.25
Can work.
*/
#ifndef __APPFACE_H__
#define __APPFACE_H__
#define GTP_LOAD_FILE 1
#define GTP_LOAD_MEMORY 2
#define GTP_LOAD_RESOURCE 3
//////////////////////////////////////////////
/*Uncomments the below statement to load appface.dll dynamicly
*/
//#define LOAD_APPFACE_DYNAMIC
//////////////////////////////////////////////
//#ifdef LOAD_APPFACE_DYNAMIC //Load appface dynamic from "appface.dll"
class CAppFace
{
public:
typedef BOOL (__stdcall *APPFACE_START)(char*,char*,int,DWORD,char*) ;
typedef void (__stdcall *APPFACE_REMOVE)();
typedef BOOL (__stdcall *APPFACE_SKINWINDOW)(HWND,BOOL);
typedef void (__stdcall *APPFACE_THREAD)();
CAppFace(LPCTSTR DllPath = _T("AppFace.dll"))
{
pfnStart = NULL ;
pfnRemove = NULL ;
pfnThread = NULL ;
pfnSkinWindow = NULL ;
m_bValid = FALSE;
m_hDll = NULL ;
Init(DllPath) ;
};
~CAppFace(){Release(); };
BOOL Init(LPCTSTR DllPath)
{
if(m_hDll && m_bValid)
return TRUE;
m_hDll = ::LoadLibrary(DllPath);
if(m_hDll == NULL)
return FALSE ;
pfnStart = (APPFACE_START) GetProcAddress(m_hDll, "SkinStart");
if(!pfnStart) return FALSE;
pfnRemove= (APPFACE_REMOVE)GetProcAddress(m_hDll, "SkinRemove");
if(!pfnRemove) return FALSE;
pfnSkinWindow= (APPFACE_SKINWINDOW)GetProcAddress(m_hDll, "SkinWindowSet");
if(!pfnSkinWindow) return FALSE;
pfnThread= (APPFACE_THREAD)GetProcAddress(m_hDll, "SkinThread");
if(!pfnThread) return FALSE;
m_bValid = TRUE ;
return TRUE ;
};
BOOL IsValid(){return m_bValid;};
//----------------------------
//We'll call these functions.
void SkinThread(){if(pfnThread) pfnThread() ;};
BOOL Start(void* SkinFile=NULL, //Source buffer
LPCTSTR szCheckSum= NULL , //Checksum string,not used for the free version
int Type = GTP_LOAD_FILE, //Loading type
DWORD hInst= NULL, //The HINSTANCE for the loaded module or the size of the memory block
LPCTSTR szResType =NULL //Resource type ,only used when Type is GTP_LOAD_RESOURCE
)
{
if(pfnStart)
{
if(!SkinFile)
{
return pfnStart(NULL,NULL,NULL,NULL,NULL);
}
else
{
char checksum[256] ;
if(Type == GTP_LOAD_MEMORY)
{
T2C(szCheckSum,checksum,256) ;
return pfnStart((char*)SkinFile,checksum,Type,hInst,NULL);
}
else
{
char skinfile[256] ;
char type[256] ;
T2C((LPCTSTR)SkinFile,skinfile,256) ;
T2C(szResType,type,256) ;
T2C(szCheckSum,checksum,256) ;
return pfnStart(skinfile,checksum,Type,hInst,type);
}
}
}
return FALSE;
};
void Remove() { if(pfnRemove) pfnRemove() ;};
BOOL SkinWindow(HWND hWnd,BOOL bSkin){if(pfnSkinWindow) return pfnSkinWindow(hWnd,bSkin);return FALSE;} ;
//----------------------------
private:
BOOL m_bValid ;
HMODULE m_hDll ;
APPFACE_START pfnStart ;
APPFACE_REMOVE pfnRemove ;
APPFACE_SKINWINDOW pfnSkinWindow ;
APPFACE_THREAD pfnThread ;
//Convert a TCHAR string to char string
void T2C(IN LPCTSTR src,OUT char* dst,IN int dstlen)
{
memset(dst,0,dstlen);
if(!src || !dst) return ;
//----------------------------
#ifdef UNICODE
BOOL bRes= FALSE ;
WideCharToMultiByte(CP_ACP,
0,
src,
wcslen(src),
dst,
dstlen,
NULL,
&bRes);
#else
strncpy(dst,src,dstlen-1) ;
#endif
} ;
protected:
void Release()
{
/*
If the m_hDll is not available,it will throw an exception for debug version,
so we need "try{...} catch(...)"
*/
try{
if(m_hDll)
{
FreeLibrary(m_hDll) ;
m_hDll = NULL ;
m_bValid = false ;
pfnStart = NULL ;
pfnRemove= NULL ;
pfnSkinWindow = NULL;
}
}catch(...)
{
}
};
};
#else //LOAD_APPFACE_DYNAMIC
#ifdef __cplusplus
extern "C"
{
#endif
/*
Function: BOOL SkinStart(char* SkinFile,
char* CheckSum ,
int Type ,
DWORD hInstance ,
char* szResType )
Description : The SkinStart function perform the most work for appface UI library
Parameters :
SkinFile
[ IN ] Depands on the value of parameter Type
If the value of Type equal to GTP_LOAD_FILE , SkinFile means the string which
contained the disk file path .
If the value of Type equal to GTP_LOAD_MEMORY , SkinFile means the address of the
memory block.
If the value of Type equal to GTP_LOAD_RESOURCE , SkinFile means the string
which contained the resource name .
If this value is NULL ,it will restore to the Windows default UI .
CheckSum
[ IN ] Only use for our regitered users.Input the valid checksum value(License Code),users can open the extra
characterful and creative URF which Matinsoft afforded .Otherwise leave this param NULL ,
and you can only use the public URF .
Type
[ IN ] This value indicate where the URF we will load .It can be one of the bellow:
GTP_LOAD_FILE : Means the URF we will load is a disk file
GTP_LOAD_MEMORY : Means the URF we will load is a memory block
GTP_LOAD_RESOURCE : Means the URF we will load is from resource
hInstance
[ IN ] Depands on the value of parameter Type
for GTP_LOAD_FILE , hInstance can be any value .
for GTP_LOAD_MEMORY , hInstance means the memory block size .
for GTP_LOAD_RESOURCE , hInstance means the HINSTANCE which the resource is from .
szResType
[ IN ] Only used when Type equal to GTP_LOAD_RESOURCE ,means the resource type
Return Values: Return nor-zero if do this operation successfully
Remarks:
For multithreaded applications ,you should call SkinStart at the main UI thread ,and call
SkinThread() in the other UI threads .
Example:
1.Load URF(UI Resource File) from disk file: SkinStart(_T("c:\\Yourpath\\yoururf.urf"),"Your License Code",GTP_LOAD_FILE,NULL,NULL) ;
2.Load URF(UI Resource File) from Resource : SkinStart(_T("IDR_URFNAME_YOURDEFINED"),"Your License Code",GTP_LOAD_RESOURCE,(DWORD)::GetModuleHandle(NULL),_T("RESOURCETYPE")) ;
3.Load URF(UI Resource File) from Memory : SkinStart((char*)pBuf,"Your License Code",GTP_LOAD_MEMORY,nBufLen,NULL)
4.Change the application UI : SkinStart(_T("c:\\Yourpath\\yourotherurf.urf"),"Your License Code",GTP_LOAD_FILE,NULL,NULL) ;
5.Return to windows default UI : SkinStart(0,0,0,0,0) ;
*/
BOOL __stdcall SkinStart(char* SkinFile ,
char* CheckSum ,
int Type ,
DWORD hInstance ,
char* szResType ) ;
/*
Function: void SkinThread()
Description : Init AppFace in another UI thread.
Parameters :
Return Values:
Remarks:
For multithreaded applications ,you should call SkinStart at the main UI thread ,and call
SkinThread in the other UI threads .
*/
void __stdcall SkinThread() ;
/*
Function: BOOL SkinWindowSet(HWND hWnd,BOOL bSkin)
Description : The SkinWindowSet function skin or unskin the special window
Parameters :
hWnd
[ IN ] Handle to the window which will be skinned or unskinned.
bSkin
[ IN ] Specifies whether a window is skinned
Return Values: Return nor-zero if do this operation successfully
Remarks:
Call SkinWindowSet function should be after call SkinStart function,otherwise it will
return FALSE immediately .
This function afford an ability for users to draw the window by themself after loaded
appface library.
*/
BOOL __stdcall SkinWindowSet(HWND hWnd,BOOL bSkin) ;
/*
Function: void SkinRemove()
Description : The SkinRemove function removes AppFace skin from the process,and releases all
the allocated resource .
Parameters :
Return Values:
Remarks:
Once call SkinStart in a process ,you must call SkinRemove before terminating this
process ,otherwise it may be cause memory leaking .
You need do this function only once ,even you had call SkinStart or SkinThread times without number
for multithreaded applications .
*/
void __stdcall SkinRemove() ;
#ifdef __cplusplus
}
#endif //__cplusplus
//#endif //LOAD_APPFACE_DYNAMIC
#endif //__APPFACE_H__
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -