Windows API一日一练 20 LoadString LoadIcon和LoadCursor函数

在编写国际化的应用程序里，经常要使用不同语言的字符串。比如中文菜单里叫做“文件”，而在英语里叫做“File”。开发这种软件的功能是一样的，只是界面上显示的文字不一样而已。为了方便这种软件的开发，在Windows里经常使用的方法就是替换掉显示的字符串，比如指定在中文里就显示“文件”，在英语里就显示“File”，是通过函数LoadString从不同的资源里加载不同的字符串显示来实现的。其实所有可变的字符串，都可以使用函数LoadString从资源里加载字符串显示。

 

 

 

图像的信息是非常方便人们记忆的，像交通信号一样，就是使用各种各样的图标，每个人看了就会明白是什么东西，因此在程序里使用图标来标识程序。只要看到这个图标，就知道是这个软件做什么用的。比如在程序的左上角显示的图标，就需要调用函数LoadIcon从资源里加载到内存里，然后再显示出来。

 

 

 

光标更是最常用的图标了，时时刻刻都可以看到它。当你在编辑文件时，光标显示为一个“I”字形图标，当你在桌面操作文件时，显示为一个箭头。这样变化的光标，就是因为设置了不同的图标。光标的使用，就是根据不同的区域来作不同的指示。更换光标的函数是LoadCursor。

 

 

 

函数LoadString声明如下：

 

WINUSERAPI

 

int

 

WINAPI

 

LoadStringA(

 

    __in_opt HINSTANCE hInstance,

 

    __in UINT uID,

 

    __out_ecount(cchBufferMax) LPSTR lpBuffer,

 

    __in int cchBufferMax);

 

WINUSERAPI

 

int

 

WINAPI

 

LoadStringW(

 

    __in_opt HINSTANCE hInstance,

 

    __in UINT uID,

 

    __out_ecount(cchBufferMax) LPWSTR lpBuffer,

 

    __in int cchBufferMax);

 

#ifdef UNICODE

 

#define LoadString  LoadStringW

 

#else

 

#define LoadString  LoadStringA

 

#endif // !UNICODE

 

 

 

hInstance是应用程序实例句柄。

 

uID是资源中的字符串编号。

 

lpBuffer是接收从资源里拷贝字符串出来的缓冲区。

 

cchBufferMax是指明缓冲的大小。

 

 

 

函数LoadIcon声明如下：

 

WINUSERAPI

 

HICON

 

WINAPI

 

LoadIconA(

 

    __in_opt HINSTANCE hInstance,

 

    __in LPCSTR lpIconName);

 

WINUSERAPI

 

HICON

 

WINAPI

 

LoadIconW(

 

    __in_opt HINSTANCE hInstance,

 

    __in LPCWSTR lpIconName);

 

#ifdef UNICODE

 

#define LoadIcon  LoadIconW

 

#else

 

#define LoadIcon  LoadIconA

 

#endif // !UNICODE

 

hInstance是应用程序实例句柄。

 

lpIconName是指向图标的名称。

 

 

 

函数LoadCursor声明如下：

 

WINUSERAPI

 

HCURSOR

 

WINAPI

 

LoadCursorA(

 

    __in_opt HINSTANCE hInstance,

 

    __in LPCSTR lpCursorName);

 

WINUSERAPI

 

HCURSOR

 

WINAPI

 

LoadCursorW(

 

    __in_opt HINSTANCE hInstance,

 

    __in LPCWSTR lpCursorName);

 

#ifdef UNICODE

 

#define LoadCursor  LoadCursorW

 

#else

 

#define LoadCursor  LoadCursorA

 

#endif // !UNICODE

 

hInstance是应用程序实例句柄。

 

lpCursorName是光标的名称。

 

 

 

调用这三个函数的例子如下：

 

#001  //

 

#002  //  函数: MyRegisterClass()

 

#003  //

 

#004  //  目的: 注册一个窗口类型.

 

#005  //

 

#006  //  蔡军生  2007/07/12

 

#007  //

 

#008  ATOM MyRegisterClass(HINSTANCE hInstance)

 

#009  {

 

#010    WNDCLASSEX wcex;

 

#011 

 

#012    wcex.cbSize = sizeof(WNDCLASSEX);

 

#013 

 

#014    wcex.style             = CS_HREDRAW | CS_VREDRAW;

 

#015    wcex.lpfnWndProc  = WndProc;

 

#016    wcex.cbClsExtra           = 0;

 

#017    wcex.cbWndExtra        = 0;

 

#018    wcex.hInstance      = hInstance;

 

#019    wcex.hIcon               = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_TESTWIN));

 

#020    wcex.hCursor      = LoadCursor(NULL, IDC_ARROW);

 

#021    wcex.hbrBackground    = (HBRUSH)(COLOR_WINDOW+1);

 

#022    wcex.lpszMenuName     = MAKEINTRESOURCE(IDC_TESTWIN);

 

#023    wcex.lpszClassName     = szWindowClass;

 

#024    wcex.hIconSm        = LoadIcon(wcex.hInstance, MAKEINTRESOURCE(IDI_SMALL));

 

#025 

 

#026    return RegisterClassEx(&wcex);

 

#027  }

 

 

 

第19行就是加载显示的图标，使用宏MAKEINTRESOURCE来转换为合适的类型，它的定义如下：

 

#define IS_INTRESOURCE(_r) ((((ULONG_PTR)(_r)) >> 16) == 0)

 

#define MAKEINTRESOURCEA(i) ((LPSTR)((ULONG_PTR)((WORD)(i))))

 

#define MAKEINTRESOURCEW(i) ((LPWSTR)((ULONG_PTR)((WORD)(i))))

 

#ifdef UNICODE

 

#define MAKEINTRESOURCE  MAKEINTRESOURCEW

 

#else

 

#define MAKEINTRESOURCE  MAKEINTRESOURCEA

 

#endif // !UNICODE

 

 

 

第20行是加载箭头的光标来显示。

 

 

 

// 加载全局字符串。

 

LoadString(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);

 

LoadString(hInstance, IDC_TESTWIN, szWindowClass, MAX_LOADSTRING);

 

上面两行就是调用函数LoadString从资源里获取显示的字符串。