1.5.4 第1练:第一个Windows程序 第一个程序hello world

/*------------------------------------------------------------------------

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程序的运行机制和灵活多变的实现方法，继续深入学习，设计更高质量的程序。