Win32常用API讲解

Win32常用API讲解

  • MessageBox

函数作用:弹出一个对话框,典型的模态型对话框
函数原型:int WINAPI MessageBox(HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType)

参数含义:

hWnd:该消息框的父窗口句柄,如果此参数为NULL,则该消息框没有父窗口
lpText:消息框的内容
lpCaption:消息框的标题
uType:对话框的按钮样式和图标

按钮样式:

MB_OK:默认值,包含一个确认按钮
MB_OKCANCEL:包含确定以及取消两个按钮
MB_YESNO:包含是以及否两个按钮
MB_ABORTRETRYIGNORE:包含终止,重试以及跳过三个按钮
MB_YESNOCANCEL:包含是,否以及取消三个按钮
MB_RETRYCANCEL:包含重试以及取消两个按钮

图标样式:

MB_ICONINFORMATION:蓝色i
MB_ICONASTERISK:蓝色i
MB_ICONQUESTION:蓝色?
MB_ICONWARNING:黄色!
MB_ICONEXCLAMATION:黄色!
MB_ICONSTOP:红色x
MB_ICONERROR:红色x
MB_ICONHAND:红色x

消息返回值:

IDYES:点击是
IDNO:点击否
IDOK:点击确认
IDCANCE:点击取消
IDABORT:点击终止
IDRETRY:点击重试
IDIGNORE:点击忽略

Demo:

  1. #include <windows.h>
  2.  
  3. int WINAPI WinMain(
  4. HINSTANCE hInstance,
  5. HINSTANCE hPrevInstance,
  6. LPSTR lpCmdLine,
  7. int nCmdShow){
  8. int chioce = MessageBox(NULL,"HelloWorld","Test",MB_OKCANCEL | MB_ICONINFORMATION);
  9. if(chioce = IDOK){
  10. MessageBox(NULL,"You choosed OK","Test",MB_OK | MB_ICONINFORMATION);
  11. }
  12. return 0;
  13. }
  • CreateWindow

函数作用:创建窗口实例!一个完整的窗口程序应该先注册窗口类,创建窗口实例,设置窗口的显示状态,最后发送重绘消息以防被其它窗口覆盖后不能刷新

函数原型:HWND CreateWindow(LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int nWidth, int nHeight, HWND hWndParent, HMENU hMenu, HANDLE hlnstance, LPVOID lpParam)

参数含义:

lpClassName:指向窗口类名
lpWindowName:指定标题或者静态文本框文本
dwStyle:指定窗口风格(标题,边框,滚动条...)
x:相对于父窗口的横坐标
y:相对于父窗口的纵坐标
nWidth:窗口宽度
nHeight:窗口高度
hWndParent:指向父窗口的句柄
hMenu:该窗口使用的某种类型的菜单的句柄
hlnstance:与窗口相关联的模块实例的句柄
lpParam:指向 CREATESTRUCT 结构的指针,传递 WM_CREATE 消息

重点说明:
1.一般窗口程序套路是:RegisterClass -> CreateWindow -> ShowWindow -> UpdateWindow,按照面向对象实现很好理解,先注册窗口类再实例化窗口,之后的 ShowWindow 是用于设置属性让窗口可见(WS_VISIBLE)或者不可见,UpdateWindow 是用来发送WM_PAINT消息更新窗口的

2.任何控件都属于窗口,所以创建某个控件也是需要 CreateWindow 函数,传入不同的 style 就表示不同的控件,比如:静态文本static,按钮button,编辑框edit,复选框Check Box

3.CreateWindow 会给普通窗口过程发送一个 WM_CREATE 消息,对于层叠,弹出式和子窗口,CreateWindow 给窗口发送WM_CREATEWM_GETMINMAXINFOWM_NCCREATE消息

  • BeginPaint

函数作用:当窗口收到 WM_PAINT 消息时,需要首先调用 BeginPaint 获取设备环境句柄,在其它情况下需要使用 GetDC 来获取设备环境句柄!因为我们不能直接访问硬件,所以需要借助设备环境(Device Context)这个中间层间接访问键盘,显示器等硬件设备

函数原型:HDC BeginPaint(HWND hwnd, LPPAINTSTRUCT lpPaint)

参数含义:

hwnd:被重绘窗口的句柄
lpPaint:指向一个用来接收绘画信息的 PAINTSTRUCT结构

当得到了设备环境句柄后,我们就可以调用图形设备接口(GDI)中已经封装好的函数,诸如:TextOut,DrawText,CreateMenu,CreateBitmap,Rectangle,CreatePen等

  • SendMessage

函数作用:主动发送一条消息给窗口

函数原型:LRESULT SendMessage(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam)

参数含义:

hWnd:目标窗口的句柄
msg:发送的消息
wParam:附加消息,某些特定的消息需要用到
lParam:附加消息,某些特定的消息需要用到
  • GetWindowText

函数作用:用于将指定窗口的标题文本(如果存在)拷贝到一个缓存区内,如果指定的窗口是一个控件,则拷贝控件的文本

函数原型:Int GetWindowText(HWND hWnd, LPTSTR lpString, Int nMaxCount)

参数含义:

hWnd:窗口或者控件句柄
lpString:指向接收文本的缓冲区指针
nMaxCount:最大的保存长度
  • SetWindowText

函数作用:用于改变指定窗口的标题栏的文本内容(如果窗口有标题栏),如果指定窗口是一个控件,则改变控件的文本内容

函数原型:BOOL SetWindowText(HWND hWnd, LPCTSTR lpString)

参数含义:

hWnd:要改变文本内容的窗口或控件的句柄
lpString:指向改变后的字符串指针
  • DialogBox

函数作用:从一个对话框资源中创建一个模态对话框,该函数直到指定的回调函数通过调用 EndDialog 函数中止模态的对话框才能返回控制。该函数通过调用 DialogBoxParam 实现

函数原型:int DialogBox(HINSTANCE hInstance, LPCTSTR lpTemplate, HWND hWndParent, DLGPROC lpDialogFunc)

参数含义:

hInstance:实例句柄
lpTemplate:对话框模板名
hWndParent:指定拥有对话框的窗口
lpDialogFunc:指向对话框过程的指针
  • CreateDialog

函数作用:创建一个非模态对话框,需要使用 DestroyWindow 结束该对话框。该函数通过调用 CreateDialogParam 实现

函数原型:HWND CreateDialog(HINSTANCE hlnstance, LPCTSTR lpTemplate, HWND hWndParent, DLGPROC IpDialogFunc)

参数含义:

hInstance:标识该模块的可执行文件含有对话框模板
lpTemplate:对话框模板名
hWndParent:指定拥有对话框的窗口
lpDialogFunc:指向对话框过程的指针

重点说明:
当关闭非模态对话框或者窗口时,会调用DestroyWindow,这个函数先发送 WM_DESTROY 消息,接着发送 WM_NCDESTROY 消息

  • LoadString

函数作用:从资源里加载字符串资源到 CString 对象里,参数是资源 ID,同类型的还有LoadIconLoadCursor

函数原型:int WINAPI LoadStringA(HINSTANCE hInstance, UINT uID, LPSTR lpBuffer, int nBufferMax)

参数含义:

hInstance:应用程序实例句柄
uID:资源ID
lpBuffer:接收从资源里拷贝字符串出来的缓冲区
nBufferMax:指明缓冲区大小
  • OutputDebugString

函数作用:输出调式信息到 Debugger

函数原型:void OutputDebugString(LPCTSTR lpOutputString)

参数含义:

lpOutputString:在调试器中调试时,输出的字符串
  • SetWindowPos

函数作用:改变一个子窗口,弹出式窗口或顶层窗口的尺寸,位置或Z序

函数原型:WINUSERAPI BOOL WINAPI SetWindowPos(HWND hWnd, HWND hWndInsertAfter, int X, int Y, int cx, int cy, UINT uFlags)

参数含义:

hWnd:窗口句柄
hWndInsertAfter:窗口的 Z 顺序
x:指定窗口新位置的左边界
y:指定窗口新位置的顶边界
cx:以像素指定窗口的新的宽度
cy:以像素指定窗口的新的高度
uFlags:窗口尺寸和定位的标志
  • FindWindowEx

函数作用:在窗口列表中寻找与指定条件相符的第一个子窗口

函数原型:HWND FindWindowEx(HWND hwndParent, HWND hwndChildAfter, LPCTSTR lpszClass, LPCTSTR lpszWindow)

参数含义:

hwndParent:要查找子窗口的父窗口句柄
hwndChildAfter:子窗口句柄,查找从在Z序中的下一个子窗口开始
lpszClass:指向一个指定了类名的空结束字符串
lpszWindow:指向一个指定了窗口名(窗口标题)的空结束字符串
  • AnimateWindow

函数作用:该函数在显示与隐藏窗口时能产生特殊的效果,有两种类型的动画效果:滚动动画和滑动动画

函数原型:BOOL AnimateWindow(HWND hWnd, DWORD dwTime, DWORD dwFlags)

参数含义:

hWnd:指定产生动画的窗口的句柄
dwTime:指明动画持续的时间
dwFlags:指定动画类型
  • MoveWindow

函数作用:改变指定窗口的位置和大小

函数原型:BOOL MoveWindow(HWND hWnd, int X, int Y, int nWidth, int nHeight, BOOL bRepaint)

参数含义:

hWnd:窗口的句柄
x:指定了CWnd的左边的新位置
y:指定了CWnd的顶部的新位置
nWidth:指定了CWnd的新宽度
nHeight:指定了CWnd的新高度
bRepaint:指定了是否要重画CWnd
  • EnumWindows

函数作用:枚举所有屏幕上的顶层窗口,并将窗口句柄传送给定义的回调函数。FindWindow 和它类似,只找顶层窗口不找子窗口

函数原型: BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)

参数含义:

lpEnumFunc:指向一个应用程序定义的回调函数指针
lPararm:指定一个传递给回调函数的应用程序定义值

回调函数原型:BOOL CALLBACK EnumWindowsProc(HWND hwnd, LPARAM lParam)

  • IsWindow

函数作用:判断目标窗口是否存在

函数原型:BOOL IsWindow(HWND hWnd)

参数含义:

hWnd:目标窗口句柄
  • GetWindow

函数作用:返回与指定窗口有特定关系(如Z序或所有者)的窗口句柄

函数原型:HWND GetWindow(HWND hWnd, UNIT nCmd)

参数含义:

hWnd:窗口句柄
nCmd:说明指定窗口与要获得句柄的窗口之间的关系

重要说明:
Z 序表示窗口层叠时的顺序,Z 序越大窗口越靠前,即 Z 序小的窗口会被 Z 序大的窗口遮挡

Win32常用API讲解

上一篇:android DatePicker / TimePicker 占空间太大的解决办法


下一篇:win10配置cuda和pytorch