1.5.4 第1练:第一个Windows程序
/*------------------------------------------------------------------------
001-1 编程达人win32 API每日一练
第1个例子HELLOMSG1.c：显示一行消息 MessageBox
windows.h头文件
WinMain 函数
GetDesktopWindow函数
MessageBox函数
TEXT宏
(c) www.bcdaren.com 编程达人
-----------------------------------------------------------------------*/
/*************************程序入口 ******************************************
int：返回值类型；
WINAPI： 函数调用约定，_stdcall
hInstance： 应用程序（进程）句柄，与指针、引用差不多，但又不同。（句柄无类型，其值会因操作系统中内存页面转换而不同，由操作系统维护）。
hPrevInstance：通过此参数可查看是否另一个实例进程正在运行。为NULL，兼容windows16的遗留，现在一般不用。
lpCmdLine： 命令行参数
nCmdShow： 窗体显示方式—正常、最大化、最小化、全屏等
***************************************************************************/
/*C程序，新建控制台项目测试
#include <string.h> //C标准库文件
#include <stdio.h>
//ANSI字符集
int main()
{
printf("hello,world\n");
return 0;
}
//Unicode字符集
int main()
{
//C程序中屏幕输出
wchar_t *pw = L"Hello!";
//int iLength = strlen(pw);//错误
int iLength = wcslen(pw);//正确，宽字符函数
fprintf(stdout, "%ws\n", pw);//宽字符
}*/
/*对应的windows程序-桌面应用程序项目*/
#include <windows.h>
int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
PSTR szCmdLine, int iCmdShow) //PSTR非宽字符串指针char*
{
//获得桌面的句柄
HWND hWnd = GetDesktopWindow();
//显示一个窗口提示信息
MessageBox(hWnd, TEXT("第一个应用程序"),TEXT("例子"),MB_OK);
return 0;
}
/*
Windows.h是一个最重要的头文件，它包含了其他Windows头文件，这些头文件的某些也包含了其他头文件。这些头文件中最重要的和最基本的是：
Windef.h基本数据类型定义。
Winnt.h支持Unicode的类型定义。
Winbase.h Kernel（内核）函数。
Winuser.h用户界面函数。
Wingdi.h图形设备接口函数。
*******************************************************************************
WinMain函数：Windows程序入口函数：该函数的功能是被系统调用，作为一个32位应用程序的入口点。
WinMain函数应初始化应用程序，显示主窗口，进入一个消息接收一发送循环，这个循环是应用程序执行的其余部分的顶级控制结构。
函数返回值类型：int
函数类型：WINAPI——STDCALL调用约定
HINSTANCE hInstance ：实例句柄
HINSTANCE hPrevInstance：没有任何意义，Windows 16位遗留
PSTR szCmdLine：指向应用程序命令行的字符串的指针，不包括执行文件名。
int iCmdShow：32位值。窗口最小化、最大化或正常显示一个空的WinMain函数：
INT WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,PSTR lpCmdLine, INT nCmdShow)
{
return 0;
}
*******************************************************************************
GetDesktopWindow函数:检索桌面窗口的句柄。桌面窗口覆盖整个屏幕。桌面窗口是在其上绘制其他窗口的区域。
HWND GetDesktopWindow();
返回值
类型：HWND
返回值是桌面窗口的句柄。
*******************************************************************************
MessageBox函数:显示一个模式对话框，其中包含一个系统图标，一组按钮以及一个简短的特定于应用程序的消息，例如状态或错误信息。
该消息框返回一个整数值，该整数值指示用户单击了哪个按钮。
int MessageBox(
HWND hWnd,//要创建的消息框的所有者窗口的句柄。如果此参数为NULL，则消息框没有所有者窗口。
LPCTSTR lpText,//要显示的消息。如果字符串包含多行，则可以在每行之间使用回车符和/或换行符来分隔行。
LPCTSTR lpCaption,//对话框标题。如果此参数为NULL，则默认标题为Error。
UINT uType//对话框的内容和行为。此参数可以是来自以下标志组的标志的组合。请查阅MSDN
);
*******************************************************************************
TEXT宏:Windows程序设计中经常会遇到的一个宏。
说明：
TCHAR*ptch=TEXT("This is aconst string.");
如果使用UNICODE字符集， 则TEXT("This is a const string.")相当于L"This is a const string."， 如果使用ASCII集，
则上述字符串相当于“This is a const string.”。这样， 写的程序既可以使用UNICODE， 也可以使用ASCII， 增强了移植性。
在写windows应用程序时， 如果您不确定使用UNICODE还是ASCII好， 那么推荐您使用TCHAR来替代程序中的char和wchar_t，
同时对于字符串常量使用TEXT宏。
*/
在HELLOMSG1.c程序中，首先给出了C语言控制台程序的写法，分别使用ANSI函数printf和Unicode函数fprintf函数在控制台窗口输出ANSI字符串 "hello,world\n"和Unicode字符串L"Hello!"。
【注意】C程序需要新建C语言控制台项目测试。
接下来我们再建一个简洁的Windows窗口程序。
/*------------------------------------------------------------------------
001-2 编程达人win32 API每日一练
第2个例子HELLOMSG2.c：MessageBox 函数
(c) www.bcdaren.com 编程达人
-----------------------------------------------------------------------*/
#include <windows.h>
/*************************程序入口 ******************************************
int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
PSTR szCmdLine, int iCmdShow) //PSTR非宽字符串指针char*
{
MessageBox(NULL, L"MB_YESNOCANCEL|MB_DEFBUTTON4|MB_HELP",
TEXT("第一个应用程序"), MB_YESNOCANCEL | MB_DEFBUTTON4 | MB_HELP +
MB_ICONQUESTION);
return 0;
}
/*
点击MessageBox按F12或右键转到定义
可以查看该函数的原型申明有两个版本
（后面API例题中不再重复说明两个版本及其兼容问题）：
#ifdef UNICODE
#define MessageBox MessageBoxW
#else
#define MessageBox MessageBoxA
#endif // !UNICODE
int
MessageBox(
HWND hWnd,
LPCTSTR lpText,
LPCTSTR lpCaption,
UINT uType
)
参数的定义：
hWnd 是指向父窗口的句柄，如果没有父窗口，可以把这个参数设置为 NULL。
lpText 是需要显示的文字。显示字符串的起始地址。
lpCaption 是在窗口上标题显示。
uType 是窗口组合按钮和显示图标的类型。
详细信息请查阅MSDN
*******************************************************************************
WINUSERAPI
int
WINAPI
MessageBoxA(
_In_opt_ HWND hWnd,
_In_opt_ LPCSTR lpText,
_In_opt_ LPCSTR lpCaption,
_In_ UINT uType);
WINUSERAPI
int
WINAPI
MessageBoxW(
_In_opt_ HWND hWnd,
_In_opt_ LPCWSTR lpText,
_In_opt_ LPCWSTR lpCaption,
_In_ UINT uType);
#ifdef UNICODE
#define MessageBox MessageBoxW
#else
#define MessageBox MessageBoxA
#endif // !UNICODE
_In_opt_:输入参数, 返回后不会改变其值
__in：输入参数； __out：输出参数 ；__in_opt：可选的输入参数。
*/
注意
请读者动手验证：HELLOMSG2.c程序中，使用L"MB_YESNOCANCEL|MB_DEFBUTTON4|MB_HELP"表示宽字符，当VS默认字符集改为多字节字符集时，对话框会显示的是乱码。为了让程序可以更好的兼容ANSI多字节字符集和Unicode字符集，建议统一改为TEXT文本宏定义字符串。
处于学习效果的角度考虑，本书将更多的以代码来说明Windows程序设计的知识点。请读者仔细阅读代码中的注释，并根据提示信息进行测试实验。
建议初学者自己敲一遍示例代码，并添加注释（作为本书的课后练习），而不是简单的粘贴复制。相信在这个过程中，很快就可以悟出编写Windows程序的秘诀——粘贴复制模板，并做适当的修改。当然，如果读者立志成为一名高级程序员，需要仔细体会和验证Windows程序的运行机制和灵活多变的实现方法，继续深入学习，设计更高质量的程序。
