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