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从资源里获取显示的字符串。