study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-06-07 22:14:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

新增win32api手册

Browse Source
This commit is contained in:
fofolee 2020-06-06 20:39:00 +08:00
parent fb509cb39a
commit 2e34d2f9e5
546 changed files with 14341 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@ -1,4 +1,4 @@
# 程序员手册 V1.1.1 # 程序员手册 V1.1.2
## 简介 ## 简介
@ -10,10 +10,6 @@
- 可以自行添加手册 - 可以自行添加手册
- 可以查询devdocs、dash/zeal上的文档 - 可以查询devdocs、dash/zeal上的文档
前身是之前发布的两个插件：
[PHP函数查询助手](https://yuanliao.info/d/329) [Linux命令查询手册](https://yuanliao.info/d/336)
## 基本操作 ## 基本操作
- 列表界面： - 列表界面：
@ -36,6 +32,20 @@
## 更新 ## 更新
### v1.1.2
- 新增功能
- 新增在文档界面显示导航目录，方便在篇幅较长文档中快速定位，默认情况下，如果`h1+h2+h3`的数量大于10则自动显示目录
![tcER4e.png](https://s1.ax1x.com/2020/06/06/tcER4e.png)
- 新增`win32api`手册
- 体验改善
- 为了减少使用语音面板进行划词搜索时的干扰项，更改了开启`主输入框搜索`时匹配的正则，现在的匹配规则是`/^[a-zA-Z._]{2,20}$/i`
- bug 修复
- 修复了从`主输入框搜索`进入插件时未对关键词进行搜索的bug
### v1.1.1 ### v1.1.1
- 新增linux下调用zeal - 新增linux下调用zeal
@ -237,6 +247,7 @@
- tkinter | [易学教程](https://www.e-learn.cn/content/python/1101684) - tkinter | [易学教程](https://www.e-learn.cn/content/python/1101684)
- PyQt5文档 | [PyQt5中文教程](https://github.com/maicss/PyQt5-Chinese-tutorial) - PyQt5文档 | [PyQt5中文教程](https://github.com/maicss/PyQt5-Chinese-tutorial)
- C函数 | C语言函数速查（Knocker 2004.7.7 版本 0.5） - C函数 | C语言函数速查（Knocker 2004.7.7 版本 0.5）
- win32api | 新编win32api大全.chm
- vim命令 | [awesome-cheatsheets](https://github.com/skywind3000/awesome-cheatsheets/blob/master/editors/vim.txt) - vim命令 | [awesome-cheatsheets](https://github.com/skywind3000/awesome-cheatsheets/blob/master/editors/vim.txt)
- git命令 | [php中文网git开发手册](http://www.php.cn/manual/view/34942.html) - git命令 | [php中文网git开发手册](http://www.php.cn/manual/view/34942.html)
- sql手册 | [php中文网sql参考手册](http://www.php.cn/manual/view/21301.html) - sql手册 | [php中文网sql参考手册](http://www.php.cn/manual/view/21301.html)

21
src/README.md
View File

@ -1,4 +1,4 @@
# 程序员手册 V1.1.1 # 程序员手册 V1.1.2
## 简介 ## 简介
@ -10,10 +10,6 @@
- 可以自行添加手册 - 可以自行添加手册
- 可以查询devdocs、dash/zeal上的文档 - 可以查询devdocs、dash/zeal上的文档
前身是之前发布的两个插件：
[PHP函数查询助手](https://yuanliao.info/d/329) [Linux命令查询手册](https://yuanliao.info/d/336)
## 基本操作 ## 基本操作
- 列表界面： - 列表界面：
@ -36,6 +32,20 @@
## 更新 ## 更新
### v1.1.2
- 新增功能
- 新增在文档界面显示导航目录，方便在篇幅较长文档中快速定位，默认情况下，如果`h1+h2+h3`的数量大于10则自动显示目录
![tcER4e.png](https://s1.ax1x.com/2020/06/06/tcER4e.png)
- 新增`win32api`手册
- 体验改善
- 为了减少使用语音面板进行划词搜索时的干扰项，更改了开启`主输入框搜索`时匹配的正则，现在的匹配规则是`/^[a-zA-Z._]{2,20}$/i`
- bug 修复
- 修复了从`主输入框搜索`进入插件时未对关键词进行搜索的bug
### v1.1.1 ### v1.1.1
- 新增linux下调用zeal - 新增linux下调用zeal
@ -237,6 +247,7 @@
- tkinter | [易学教程](https://www.e-learn.cn/content/python/1101684) - tkinter | [易学教程](https://www.e-learn.cn/content/python/1101684)
- PyQt5文档 | [PyQt5中文教程](https://github.com/maicss/PyQt5-Chinese-tutorial) - PyQt5文档 | [PyQt5中文教程](https://github.com/maicss/PyQt5-Chinese-tutorial)
- C函数 | C语言函数速查（Knocker 2004.7.7 版本 0.5） - C函数 | C语言函数速查（Knocker 2004.7.7 版本 0.5）
- win32api | 新编win32api大全.chm
- vim命令 | [awesome-cheatsheets](https://github.com/skywind3000/awesome-cheatsheets/blob/master/editors/vim.txt) - vim命令 | [awesome-cheatsheets](https://github.com/skywind3000/awesome-cheatsheets/blob/master/editors/vim.txt)
- git命令 | [php中文网git开发手册](http://www.php.cn/manual/view/34942.html) - git命令 | [php中文网git开发手册](http://www.php.cn/manual/view/34942.html)
- sql手册 | [php中文网sql参考手册](http://www.php.cn/manual/view/21301.html) - sql手册 | [php中文网sql参考手册](http://www.php.cn/manual/view/21301.html)

18
src/docs/win32api/1/AdjustWindowRectEx.html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数依据所需客户矩形大小，计算需要的窗口矩形的大小。计算出的窗口矩形随后可以传送给CreateWindowEx函数，用于创建一个客户区所需大小的窗口。<br>
<h3>函数原型</h3>BOOL AdjustWindowRectEX（LPRECT lpRect，DWORD dwStyte；BOOL bMenu；DWORD dwExStyle）；<br>
<h3>参数</h3>
lpRect：指向RECT结构的指针，该结构包含所需客户区域的左上角和右下角的坐标。函数返回时，该结构包含容纳所需客户区域的窗口的左上角和右下角的坐标。<br>
dwStyle：指定将被计算尺寸的窗口的窗口风格。<br>
bMenu：指示窗口是否有菜单。<br>
dwExStyle：指定将被计算尺寸的窗口的扩展窗口风格。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：客户矩形是指完全包含一个客户区域的最小矩形；窗口矩形是指完全包含一个窗口的最小矩形，该窗口包含客户区与非客户区。<br>
当一个菜单条下拉出两行或更多行时，AdjustWindowRect函数不增加额外的空间。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

16
src/docs/win32api/1/AdlustWindowRect.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数依据所需客户矩形的大小，计算需要的窗日矩形的大小。计算出的窗口矩形随后可以传递给CreateWindow函数，用于创建一个客户区所需大小的窗口。<br>
<h3>函数原型</h3>BOOL AdjustWindowRect（LPRECT lpRect ，DWORD dwStyle，BOOL bMENU）；<br>
<h3>参数</h3>
lpRect：指向RECT结构的指针，该结构包含所需客户区域的左上角和右下角的坐标。函数返回时，该结构容纳所需客户区域的窗口的左上角和右下角的坐标。<br>
dwStyle：指定将被计算尺寸的窗口的窗口风格。<br>
bMenu：指示窗口是否有菜单。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。获取错误信息，参看GetLastError。<br>
备注：客户矩形是指完全包含一个客户区域的最小矩形；窗日矩形是指完全包含一个窗口的最小矩形，该窗口包含客户区与非客户区。<br>
当一个菜单条下拉出两行或更多行时，AdjustWindowRect函数不增加额外的空间。<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本：Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

24
src/docs/win32api/1/AnImateWindow.html Normal file
View File

@ -0,0 +1,24 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数能在显示与隐藏窗口时能产生特殊的效果。有两种类型的动画效果：滚动动画和滑动动画。<br>
<h3>函数原型</h3>BOOL AnimateWindow（HWND hWnd，DWORD dwTime，DWORD dwFlags）；<br>
<h3>参数</h3>
hWnd：指定产生动画的窗口的句柄。<br>
dwTime：指明动画持续的时间（以微秒计），完成一个动画的标准时间为200微秒。<br>
dwFags：指定动画类型。这个参数可以是一个或多个下列标志的组合。标志描述：<br>
AW_SLIDE：使用滑动类型。缺省则为滚动动画类型。当使用AW_CENTER标志时，这个标志就被忽略。<br>
AW_ACTIVE：激活窗口。在使用了AW_HIDE标志后不要使用这个标志。<br>
AW_BLEND：使用淡出效果。只有当hWnd为顶层窗口的时候才可以使用此标志。<br>
AW_HIDE：隐藏窗口，缺省则显示窗口。<br>
AW_CENTER：若使用了AW_HIDE标志，则使窗口向内重叠；若未使用AW_HIDE标志，则使窗口向外扩展。<br>
AW_HOR_POSITIVE：自左向右显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。<br>
AW_VER_POSITIVE：自顶向下显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。<br>
AW_VER_NEGATIVE：自下向上显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。在下列情况下函数将失败：<br>
窗口使用了窗口边界；窗口已经可见仍要显示窗口；窗口已经隐藏仍要隐藏窗口。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：可以将AW_HOR_POSITIVE或AW_HOR_NEGTVE与AW_VER_POSITVE或AW_VER_NEGATIVE组合来激活一个窗口。<br>
可能需要在该窗口的窗口过程和它的子窗口的窗口过程中处理WM_PRINT或WM_PRINTCLIENT消息。对话框，控制，及共用控制已处理WM_PRINTCLIENT消息，缺省窗口过程也已处理WM_PRINT消息。<br>
<h3>速查</h3>WIDdOWS NT：5.0以上版本：Windows：98以上版本；Windows CE：不支持；头文件：Winuser.h；库文件：user32.lib。<br>
</body>
</html>

12
src/docs/win32api/1/AnyPopup.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数指出一个被属窗口，可见窗口，顶级弹出窗口，或层叠窗日是否在屏幕上存在。这个函数搜索整个屏幕，而不仅仅搜索应用程序的客户区。<br>
<h3>函数原型</h3>BOOL AnyPopup（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>如果一个弹出式窗口存在，返回值为非零，即使该窗口被其他窗口完全覆盖。如果弹出式窗口不存在，返回值为零。<br>
备注：函数不检测无所属关系的弹出式窗口，或无WS_VISIBLE设置位的窗口。<br>
<h3>速查</h3>Windows NT:3.1以上版本；Windows：95以上版本；Windows CE:不支持；头文件：winuser.h;库文件：USer32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/ArrangelconlcWindows.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数安排指定父窗口的各个最小化（图标化）子窗口。<br>
<h3>函数原型</h3>UNIT ArrangelconicWindows（HWND hWnd）：<br>
<h3>参数</h3>
hWnd：父窗口句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为一行图标的高度。如果函数失败，返回值为零。若想获得更多错误信息，请调用 callGetLastError函数。<br>
备注：一个应用程序可以通过使用ArrangelconicWindows安排在一个父窗口卫的它自身的最小化的子窗口。这个函数也可以安排桌面图标。使用GetDesttopWindow函数获得桌面窗口的句柄。<br>
一个应用程序给多文本接口（MDI）客户窗口发送WM_MDIICONARRANGE消息，使客户窗口来安排自身的最小化MDI子窗口。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

17
src/docs/win32api/1/BeginDeferWindowPos.html Normal file
View File

@ -0,0 +1,17 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为一个多窗口位置结构分配内存并且返回该结构的句柄。<br>
<h3>函数原型</h3>HDWP BeginDeferWindowPos（int nNumWindows）；<br>
<h3>参数</h3>
nNumWindows：指示存储位置信息的初始窗口数目。如有必要，DeferWindowPos函数可以增加该结构的大小。<br>
<h3>返回值</h3>如果函数成功，返回多窗口位置结构。如果分配内存时内存不足，则返回值为NULL。若想获得更多的错误信息，请调用GetLastError函数。<br>
备注：多窗口位置结构是一个内部结构，应用程序不能直接引用。<br>
DeferWindowPos函数在多窗口位置结构中填充了将被移动的一个或多个窗口的目标位置信息。EndDeferWindowPos接收该结构的句柄，并且依据存储在该结构中的信息重定位这些窗口。<br>
如果在多窗口位置结构中的任意一个窗口中设置了SWP_HIDEWINDOW和SWP_SHOWWINDOW标志，则所有窗口都不能被重定位。<br>
如果系统必须增加在多窗口位置结构中由nNumWindows设置的初始窗口数目，但又没有足够的内存分配，则系统的整个窗口重定位顺序失败（BeginDeferWindowsPos，DeferWindowsPos，EndDeferWindowPos）。应用程序通过指定所需最大数目，可以在执行过程中进行早期的检测和处理。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持：头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/BeginUpdateResource.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回一个可被UpdateResource函数使用的句柄以便在一个可执行文件中增加、删除或替换资源。<br>
<h3>函数原型</h3>HANDLE BeginUpdateResource（LPCTSTR pFileName，BOOL bDeleteExistingResources）；<br>
<h3>参数</h3>
pFileName：指向一个表示结束的空字符串指针，它是用来指定用以更新资源的基于32-位可执行文件的文件名。应用程序必须获得访问这个文件的可写权限，并且此文件在当前状态下不能被执行。如果pFileName未被指定完全路径，系统将在当前路径下搜寻此文件。<br>
bDeleteExistingResources：说明是否删除PFileName参数指定的现有资源。如果这个参数为TRUE则现有的资源将被删除，而更新可执行文件只包括由UpdateResource函数增加的资源。如果这个参数为FALSE，则更新的可执行文件包括现有的全部资源，除非通过UpdateResource特别说明被删除或是替换的。<br>
<h3>返回值</h3>如果此函数运行成功，其值将通过使用UpdateResource和EndUpdateResource函数返回一个句柄。如果被指定的文件不是一个可执行文件，或者可执行文件已被装载，或者文件不存在，或是文件不能被打开写入时，则返回值为空。若想获得更多的错误信息，请调用GetLastError函数。<br>
速查:Windows 3.1以上。头文件：winbase.h：库文件：kernel32.lib，Unicode：在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

31
src/docs/win32api/1/BroadcastSystemMessage.html Normal file
View File

@ -0,0 +1,31 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数发送消息给指定的接受者。接受者可以是一个应用程序、安装驱动器、网络驱动器、系统级设备驱动器或这些系统组件的组合。<br>
<h3>函数原型</h3>long BroadcastSystemMessage（DWORD dwFIags，LPDWORD IpdwRecipients,UINT UiMessage，WPARAMwParam,LPARAM IParam）；<br>
<h3>参数</h3>
dwFlags：选项标志。可取下列值的组合：<br>
BSF_FLUSHDISK：接受者处理消息之后清洗磁盘。<br>
BSF_FORCEIFHUNG：继续广播消息，即使超时周期结束或一个接受者已挂起。<br>
BSF_IGNORECURRENTTASK：不发送消息给属于当前任务的窗口。这样，应用程序就不会接收自己的消息。<br>
BSF_NOHANG：强制挂起的应用程序超时。如果一个接受者超时，不再继续广播消息。<br>
BSF_NOTIMEOUTIFNOTHUNG：只要接受者没挂起，一直等待对消息的响应。不会出现超时。<br>
BSF_POSTMESSAGE：寄送消息。不能和BSF_QUERY组合使用。<br>
BSF_QUERY：每次发送消息给一个接受者，只有当前接受者返回TRUE后，才能发送给下一个接受者。<br>
lpdwRecipients：指向变量的指针，该变量含有和接收消息接受者的信息。此变量可为下列值的组合：<br>
BSM_ALLCOMPONENTS：广播到所有的系统组件。<br>
BSM_ALLDESKTOPS：Windows NT下，广播到所有的桌面。要求SE_TCB_NAME特权。<br>
BSM_APPLICATIONS：广播到应用程序。<br>
BSM_INSTALLABLEDRIVERS：Windows 95下，广播到安装驱动器。<br>
BSM_INTDRIVER：Windows 95下，广播到网络驱动器。<br>
BSM_VXDS：Windows 95下，广播到所有系统级设备驱动器。<br>
当函数返回时，此变量接受上述值的组合，以确定真正接受消息的接受者。如果此参数为NULL，则将消息广播到所有的组件。<br>
uiMessage：系统消息标识符。<br>
WParam：32位消息特定值。<br>
IParam：32位消息特定值。<br>
返回值:如果函数调用成功，返回值是正数。如果函数不能广播消息，返回值是C1。如果参数dwFlags为BSF_QUERY且至少一个接受者返回BROADCAST_QUERY_DENY给相应的消息，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。<br>
备注：如果BSF_QUERY没指定，函数发送指定的消息给所有请求的接受者，并忽略这些接受者返回的值。<br>
<h3>速查</h3>Windows NT：4.0及以上版本：Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

16
src/docs/win32api/1/BromgWindowToTop.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将指定的窗口设置到Z序的顶部。如果窗口为顶层窗口，则该窗口被激活；如果窗口为了窗口，则相应的顶级父窗口被激活。<br>
<h3>函数原型</h3>B00L BringWindowToTop（HWND，hWnd）；<br>
<h3>参数</h3>
hWnd: 设置到Z序的顶部的窗口句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：使用BringWindowToTop函数显示出被其他窗口部分或全部遮盖的窗口。<br>
调用这个函数类似于调用SetWindowPos函数来改变窗口在Z序中的位置，但是BringWindowToTop函数并不能使一个窗口成为顶层窗口。<br>
如果应用程序不在前台中而想设置在前台中，可以调用SetForegroundWindow函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE:1.0以上版本；头文件：winuser.h；库文件：user32.lid。<br>
</body>
</html>

18
src/docs/win32api/1/CascadeWindows.html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数层叠排列指定父窗口的各指定子窗口。<br>
<h3>函数原型</h3>WORD WINAPI CascadeWihdows（HWND hWndParent，UNIT wHow，CONST RECT*lpRect，UNIT cKids， Const HWND FA*lpKids）；<br>
<h3>参数</h3>
Parent：父窗口的句柄。如果参数为NVLL，则假定为桌面窗口。<br>
wHow：指定层叠标志。唯一可用的标志为MDITILE_SKIPDISABLED，防止被禁止的MDI子窗口被层叠排列。<br>
lpBect：指向RECT结构的指针，该结构以客户坐标定义矩形区域，并在这个区域中排列窗口、该参数可以为NULL，这种情况下使用父窗口的客户区域。<br>
cKids：指明由lpKids参数指定的数组的成员个数。如果IpKidS参数为NULL，则此参数将被忽略。<br>
lpKids：指向将被排列的子窗口的句柄数组的指针。如果此参数为空，则指定的父窗口（或桌面窗口）的所有子窗口都将被排列。<br>
<h3>返回值</h3>如果函数成功，返回值为被排列的窗口数目；如果函数失败，返回值为零。若想获得更多错误信息，请调用 GetLastError函数。<br>
备注：调用CascadeWindows函数使所有最大化窗口恢复到它们原来的大小。<br>
<h3>速查</h3> Windows NT：4.0以上版本；Windows：95以上版本；Windows CE：不支持；头文件：winuser.h；库文件：User32.1<br>
</body>
</html>

14
src/docs/win32api/1/ChildWindowFromaPoint.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定属于某一父窗口的哪一个子窗口（如果存在的话）包含一个指定的点。<br>
<h3>函数原型</h3>HWND ChildWindowFromaPoint（HWND hWndParent.POINT Point）：<br>
Parent：父窗口句柄。<br>
Point：指定一个POINT结构，该结构给定了被检查的点的坐标。<br>
<h3>返回值</h3>返回值为包含该点的子窗口的句柄，即使该子窗口是隐藏的或被禁止的。如果该点在父窗口之外，则返回值为NULL。如果该点在父窗口内，但在任一子窗口外，则返回值为父窗口句柄。<br>
备注：系统有一个与某一父窗口有联系的所有子窗口的内部列表。列表中的句柄顺序依据这些子窗口的z序。如果有多于一个的子窗口包含该点，那么系统返回在列表中包含该点的第一个窗口的句柄。<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本；Windows CE；1.0以上版本；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

18
src/docs/win32api/1/ChildWindowFromaPointEx.html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定属于父窗口的哪一个子窗口（如果存在的话）包含着指定的点。该函数可以忽略不可见的、禁止的和透明的子窗口。<br>
<h3>函数原型</h3>HWND ChidWindowFromaPointEx（HWND hwndParent,POINT pt，UNIT uFlags）；<br>
<h3>参数</h3>
hWndParent:父窗口句柄。<br>
pt：指定一个POINT结构，该结构定义了被检查的点的坐标。<br>
uFlags:指明忽略的子窗口的类型。该参数可以是下列参数的组合。<br>
CWP_ALL：不忽略任一子窗口。CWP_SKIPINVISIBLE：忽略不可见的子窗口。<br>
CWP_SKIPDISABLE:忽略禁止的子窗口。CWP_SKIPTRABSPARENT：忽略透明子窗口。<br>
<h3>返回值</h3>返回值为包含该点并且满足由uFlags定义的规则的第一个子窗口的句柄。如果该点在父窗口内，但在任一满足条件的子窗口外，则返回值为父窗口句柄。如果该点在父窗口之外或函数失败，则返回值为NULL。<br>
备注：系统有一个与某一父窗口有联系的所有子窗口的内部列表。列表中的句柄顺序依据这些子窗口的Z序。如果有多于一个的子窗口包含该点，那么系统返回在列表中包含该点并且满足由uFlags定义的规则的第一个窗口的句柄。<br>
<h3>速查</h3>WindowS NT：4.0以上版本；Windows：95以上版本；Windows CE:不支持；头文件:Winuser.h；库文件：user32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/CloseWindow.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数最小化指定的窗口，但并不销毁该窗口。<br>
<h3>函数原型</h3>BOOL CloseWindow(HWND hWnd);<br>
<h3>参数</h3>
hWnd：将要最小化的窗口的句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：窗口尺寸被最小化成一个图标，并移动到屏幕的图标区域。系统显示窗口的图标而不显示窗口，并在图标下显示窗口标题。应用程序必须使用DestroyWindow函数销毁窗口。<br>
<h3>速查</h3>WindowS NT：3.1以上版本；Windows：95以上版本；Windows CE:不支持；头文件:Winuser.h；库文件：user32.lib<br>
</body>
</html>

28
src/docs/win32api/1/CopyImage.html Normal file
View File

@ -0,0 +1,28 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数创建一个新的图像（图标、光标、位图）并复制该指定图像的属性到新的图像。若有必要，该函数将伸展位值以填满新图像所需要的尺寸。<br>
<h3>函数原型</h3>HANDLE CopyImage（HANDLE hlmage，UjNT uTyPe，int cxDesired，int cyDesired，UINT fuFlags）<br>
<h3>参数</h3>
hImage：指向包含将被复制图像的模型中的一个特例的句柄。<br>
uType：说明被复制图像的类型，此参数将可能是如下值：<br>
IMAGE_BITMAP：表示复制一个位图；IMAGE_CURSOR；表示复制一个光标。<br>
IMAGE_ICON：表示复制一个图标。<br>
cxDesired：用来指定图像所需的像素宽度。<br>
cyDesired：用来指定图像所需的像素高度。<br>
fuFlags：指定下列复合值，其含义具体如下：<br>
LR_COPYDELETEORG：表示创建一个副本后删除原始图像。<br>
LR_COPYRETURNORG；表示创建一个图像的精确副本，而忽略参数cxDesired和cyDesired。<br>
LR_MONOCHROME：表示创建一个新的单色图像。<br>
LR_COPYFROMRESOURCE；表示试图从原始资源文件中再装载图标或光标资源而不是简单的复制当前图像。这使得在含有多种尺寸资源的资源文件中再创建一个不同尺寸的副本时非常有用。若没有这个标志，Copylmage函数将伸展原始图像到新的尺寸；若此标志被设置，Copylmage函数将在资源文件中选择使用最接近所期待尺寸的值。<br>
此函数只有在Loadlcon、LoadCursor或Loadlmage函数中的hlmage参数被装载成LR_SHARED值时才运行成功的。<br>
<h3>返回值</h3>如果函数运行成功，其值将返回最新创建图像的句柄；如果函数运行失败，其值将返回空。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：当使用完资源后，可以调用下表中列举的函数以释放相关内存。<br>
Resource Release function资源释放函数：Bitmap DeleteObject 位图：DeleteObject；<br>
Cursor DestroyCursor 光标：DestroyCursorr；lcon Destroylcon 图标： Destroylcon。<br>
当过程终止时，系统将自动删除这些资源。因而，调用相关函数可以节省内存空间且减少过程工作设置所需空间的大小。<br>
<h3>速查</h3>Windows NT 3.5 Windows 95以上，头文件：winuserh；库文件：user32.lib。<br>
</body>
</html>

87
src/docs/win32api/1/Create Window.html Normal file
View File

@ -0,0 +1,87 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数创建一个重叠式窗口、弹出式窗口或子窗口。它指定窗口类，窗口标题，窗口风格，以及窗口的初始位置及大小（可选的）。该函数也指定该窗口的父窗口或所属窗口（如果存在的话），及窗口的菜单。若要使用除CreateWindow函数支持的风格外的扩展风格，则使用CreateWindowEx函数代替CreateWindow函数。<br>
<h3>函数原型</h3>HWND CreateWindow(LPCTSTR lpClassName,LPCTSTR lpWindowName,DWORD dwStyle,int x,int y,int nWidth，int nHeight，HWND hWndParent,HMENU hMenu，HANDLE hlnstance，LPVOID lpParam）；<br>
<h3>参数</h3>
lpClassName:指向一个空结束的字符串或整型数atom。如果该参数是一个整型量，它是由此前调用theGlobalAddAtom函数产生的全局量。这个小于0xC000的16位数必须是lpClassName参数字的低16位，该参数的高位必须是0。<br>
如果lpClassName是一个字符串，它指定了窗口的类名。这个类名可以是任何用函数RegisterClassEx注册的类名，或是任何预定义的控制类名。请看说明部分的列表。<br>
LPWindowName:指向一个指定窗口名的空结束的字符串指针。<br>
如果窗口风格指定了标题条，由lpWindowName指向的窗口标题将显示在标题条上。当使用Createwindow函数来创建控制例如按钮，选择框和静态控制时，可使用lpWindowName来指定控制文本。<br>
dwStyle：指定创建窗口的风格。该参数可以是下列窗口风格的组合再加上说明部分的控制风格。风格意义：<br>
WS_BORDER：创建一个单边框的窗口。<br>
WS_CAPTION：创建一个有标题框的窗口（包括WS_BODER风格）。<br>
WS_CHIlD：创建一个子窗口。这个风格不能与WS_POPVP风格合用。<br>
WS_CHLDWINDOW：与WS_CHILD相同。<br>
WS_CLIPCHILDREN:当在父窗口内绘图时，排除子窗口区域。在创建父窗口时使用这个风格。<br>
WS_CLlPBLINGS；排除子窗口之间的相对区域，也就是，当一个特定的窗口接收到WM_PAINT消息时，WS_CLIPSIBLINGS 风格将所有层叠窗口排除在绘图之外，只重绘指定的子窗口。如果未指定WS_CLIPSIBLINGS风格，并且子窗口是层叠的，则在重绘子窗口的客户区时，就会重绘邻近的子窗口。<br>
WS_DISABLED:创建一个初始状态为禁止的子窗口。一个禁止状态的窗日不能接受来自用户的输人信息。<br>
WS_DLGFRAME:创建一个带对话框边框风格的窗口。这种风格的窗口不能带标题条。<br>
WS_GROUP:指定一组控制的第一个控制。这个控制组由第一个控制和随后定义的控制组成，自第二个控制开始每个控制，具有WS_GROUP风格，每个组的第一个控制带有WS_TABSTOP风格，从而使用户可以在组间移动。用户随后可以使用光标在组内的控制间改变键盘焦点。<br>
WS_HSCROLL：创建一个有水平滚动条的窗口。<br>
WS_ICONIC：创建一个初始状态为最小化状态的窗口。与WS_MINIMIZE风格相同。<br>
WS_MAXIMIZE：创建一个具有最大化按钮的窗口。该风格不能与WS_EX_CONTEXTHELP风格同时出现，同时必须指定WS_SYSMENU风格。<br>
WS_OVERLAPPED:产生一个层叠的窗口。一个层叠的窗口有一个标题条和一个边框。与WS_TILED风格相同。<br>
WS_OVERtAPPEDWINDOW：创建一个具有WS_OVERLAPPED，WS_CAPTION，WS_SYSMENU WS_THICKFRAME，WS_MINIMIZEBOX，WS_MAXMIZEBOX风格的层叠窗口，与WS_TILEDWINDOW风格相同。<br>
WS_POPUP；创建一个弹出式窗口。该风格不能与WS_CHLD风格同时使用。<br>
WS_POPUWINDOW：创建一个具有WS_BORDER，WS_POPUP,WS_SYSMENU风格的窗口，WS_CAPTION和WS_POPUPWINDOW必须同时设定才能使窗口某单可见。<br>
WS_SIZEBOX：创建一个可调边框的窗口，与WS_THICKFRAME风格相同。<br>
WS_SYSMENU：创建一个在标题条上带有窗口菜单的窗口，必须同时设定WS_CAPTION风格。<br>
WS_TABSTOP：创建一个控制，这个控制在用户按下Tab键时可以获得键盘焦点。按下Tab键后使键盘焦点转移到下一具有WS_TABSTOP风格的控制。<br>
WS_THICKFRAME：创建一个具有可调边框的窗口，与WS_SIZEBOX风格相同。<br>
WS_TILED：产生一个层叠的窗口。一个层叠的窗口有一个标题和一个边框。与WS_OVERLAPPED风格相同。<br>
WS_TILEDWINDOW:创建一个具有WS_OVERLAPPED，WS_CAPTION，WS_SYSMENU MS_THICKFRAME．<br>
WS_MINIMIZEBOX，WS_MAXMIZEBOX风格的层叠窗口。与WS_OVERLAPPEDWINDOW风格相同。<br>
WS_VISIBLE：创建一个初始状态为可见的窗口。WS_VSCROLL：创建一个有垂直滚动条的窗口。<br>
X：指定窗口的初始水平位置。对一个层叠或弹出式窗口，X参数是屏幕坐标系的窗口的左上角的初始X坐标。对于子富口，x是子窗口左上角相对父窗口客户区左上角的初始X坐标。如果该参数被设为CW_UCEDEFAULT则系统为窗口选择缺省的左上角坐标并忽略Y参数。CW_USEDEFAULT只对层叠窗口有效，如果为弹出式窗口或子窗口设定，则X和y参数被设为零。<br>
Y：指定窗口的初始垂直位置。对一个层叠或弹出式窗日，y参数是屏幕坐标系的窗口的左上角的初始y坐标。对于子窗口，y是子窗口左上角相对父窗口客户区左上角的初始y坐标。对于列表框，y是列表框客户区左上角相对父窗口客户区左上角的初始y坐标。如果层叠窗口是使用WS_VISIBLE风格位创建的并且X参数被设为CW_USEDEFAULT，则系统将忽略y参数。<br>
nWidth:以设备单元指明窗口的宽度。对于层叠窗口，nWidth或是屏幕坐标的窗口宽度或是CW_USEDEFAULT。若nWidth是CW_USEDEFAULT，则系统为窗口选择一个缺省的高度和宽度：缺省宽度为从初始X坐标开始到屏幕的右边界，缺省高度为从初始X坐标开始到目标区域的顶部。CW_USEDFEAULT只参层叠窗口有效；如果为弹出式窗口和子窗口设定CW_USEDEFAULT标志则nWidth和nHeight被设为零。<br>
nHelght:以设备单元指明窗口的高度。对于层叠窗口，nHeight是屏幕坐标的窗口宽度。若nWidth被设为CW_USEDEFAULT，则系统忽略nHeight参数。<br>
hWndParent：指向被创建窗口的父窗口或所有者窗口的旬柄。若要创建一个子窗口或一个被属窗口，需提供一个有效的窗口句柄。这个参数对弹出式窗日是可选的。Windows NT 5.0；创建一个消息窗口，可以提供HWND_MESSAGE或提供一个己存在的消息窗口的句柄。<br>
hMenu：菜单句柄，或依据窗口风格指明一个子窗口标识。对于层叠或弹出式窗口，hMenu指定窗口使用的菜单：如果使用了菜单类，则hMenu可以为NULL。对于子窗口，hMenu指定了该子窗口标识（一个整型量），一个对话框使用这个整型值将事件通知父类。应用程序确定子窗口标识，这个值对于相同父窗口的所有子窗口必须是唯一的。<br>
hlnstance：与窗口相关联的模块事例的句柄。<br>
lpParam:指向一个值的指针，该值传递给窗口 WM_CREATE消息。该值通过在IParam参数中的CREATESTRUCT结构传递。如果应用程序调用CreateWindow创建一个MDI客户窗口，则lpParam必须指向一个CLIENTCREATESTRUCT结构。<br>
<h3>返回值</h3>如果函数成功，返回值为新窗口的句柄：如果函数失败，返回值为NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：在返回前，CreateWindow给窗口过程发送一个WM_CREATE消息。对于层叠，弹出式和子窗口，CreateWindow给窗口发送WM_CREATE，WM_GETMINMAXINFO和WM_NCCREATE消息。消息WM_CREATE的IParam参数包含一个指向CREATESTRUCT结构的指针。如果指定了WS_VISIBLE风格，CreateWindow向窗口发送所有需要激活和显示窗口的消息。<br>
获取有关任务条是否为创建的窗口显示一个按钮的控制信息，参看Taskbar按钮的Visbility。<br>
以下预定义的控制类可以在lpClassName参数中指定。注意在dwStyle参数中可以使用的相应的控制风格。<br>
BUTTON按钮按钮是一个小矩形子窗口，用户可以点击来打开或关闭。按钮控制可以单独使用或包含在组中使用，可以为控制写标签或不写标签。当用户点击按钮控制时按钮的外观有明显的改变。请参看Button。查看dwStyle参数中指定的按钮风格表请参考Button Style。<br>
COMBOBOX组合框由一个列表框和一个类似于编辑控制的选择域组成。在使用这个风格控制时，应用程序或者使列表框一直显示或者是作成一个下拉列表。如果列表框可见，则在编辑域中输入字符将使列表框中与字符一致的第一个域高亮。反之，在列表框中选择的项将显示在编辑域中。请参看Combo Boxes。<br>
查看dwStyle参数中指定的组合框风格表请参考Combo Boxes Style。<br>
EDIT编辑框一个小的矩形子窗口用户可以使用键盘向其中输入文本。用户可以通过点击或按Tab键来选中编辑框控制并且使控制获得焦点。当编辑框中显示一个闪烁的插入记号时，用户可以输入文本。使用鼠标移动光标，选择被替换的字符或设置插入字符的位置或使用回退键删除字符。请参看Edit。controls。<br>
查看dwStyle参数中指定的编辑框风格的表格请参考Edit Control Style。<br>
LISTBOX列表框字符串的列表。当应用程序必须显示名称的列表，例如文件名列表等，使用户可以从中选择时就可指定列表框。用户可以通过单击来选择名称。选择时，被选择名高亮，同时传递给父窗口一个通知消息。请参看LiSt Box Style。查看dwStyle参数中指定的列表风格表请参考List BOX Control Style。<br>
MDICLIENT MDI客户设计出MDI客户窗口。窗口接收控制MDI应用程序子窗口的消息。建议使用两种控制风格位：WS_CLIPCHILDREN和WS_CHILD。指定了WS_HSCROLL和WS_VSCROLL风格的MDI客户窗口允许用户将MDI子窗口滑动进入视窗。请参看MDI。<br>
RiChEdit设计一个Rich Editl.0版的控制。该控制使用户可以以字符和段落格式测览和编辑文本，并且可以包含嵌入的COM对象。请参看Rich Edit Controls。查看dwStyle参数中指定的RichEdit风格表请参考LiSt Box Control Style。<br>
RICHEDIT CLASS设计一个Rich Edik2.0版的控制。该控制使用户可以以字符和段落格式测览和编辑文本，并且可以包含嵌入的COM对象。请参看RichEditControls。查看dwStyle参数中指定的RichEdit风格表请参考RichEditControIStyle。<br>
SCROLLBAR 滚动条设计的一个包含着一个滚动盒和两端有方向箭头的矩形。只要用户点击了控制，滚动条就给父窗口发送一个通知消息。如有必要，父窗口负责更新滚动条的位置。请参看ScrollBars。查看dwStyle参数中指定的滚动条风格表请参考Scroll Bars Style。<br>
STATIC一个简单的静态文本域，文本盒或矩形用于给控制加标签，组合控制或将控制与其他控制分开。<br>
静态控制不提供输入和也不提供输出。请参看Static Control Styles。查看dwStyle参数中指定的静态文本风格表请参考Scroll Bars Style。<br>
Windows95：系统可以支持最大16,364个窗口句柄。<br>
备注：如果在链接应用程序时指明是Windows 4.x版本，除非应用程序的窗口有窗口某单，否则窗口控制没有标题控制。对Windows3.x版本没有这种要求。<br>
Windows CE：CreateWindow是以“宏”方式完成的。它被定义为CreateWindowEX，并且dwExStyle参数被置为长整数0。不支持菜单条控制，除非被声明为子窗口标志否则hMenu参数必须为NULL。不支持MDICLIENT窗口类。dwStyle参数可以是对话框（Dialogue Box），窗口（Windows），控制（Controls）文件中的窗口风格和控制风格的组合。<br>
下列dwStyle标志在窗口中不支持：<br>
WS_CHILDWINDOW WS_ICONC；WS_MAXMIZE WS_MAXIMIZEBOX；WS_MINIMIZE WS_MINIMIZEBOX；<br>
WS_OVERLAPPEDWINDOW WS_POPUPWINDOW；WS_SIZEBOXWS_THICKFRAME WS_TILED WS_TILEDWINDOW<br>
下列dwStyle标志在控制和对话框中不支持：<br>
不支持的按钮风格和静态控制风格：<br>
BS_LEFTTEXT SS_BLACKFRAME；BS_MULTILINE SS_GRAYFRAME BS_TEXT SS_METAPICT；BS_USERBUTTON SS_SIMPLE<br>
不支持组合框SS_WHITERECT风格。<br>
CBS_OWNERDRAWFIXED SS_BLACKRECT；CBS_OWNWEDRAWVARIABLE SS_GRAYRECT； CBS_SIMPLE8R旧HTrIMAGE<br>
不支持列表框控制SS_WHITEFRAME风格。<br>
LBS_NODATA<br>
不支持的对话框风格：<br>
LBS_OWNERDRAWFIXED DS_ABSALIGN； LBS_OWNERDRAWVARIABLE DS_CENTERMOUSE； LBS_STANDARD DS_CONTEXTHELP<br>
不支持滚动条的 DS_FIXEDSYS风格<br>
SBS_BOTTOMALIGN DS_NOFAILCREATE；SBS_RIGHTALIGN DS_NOIDLEMSG；<br>
SBS_SlZEBOXBOTT0MRIHTALIGN DS_SYSMODAL；SBS_SIZEGRIP<br>
可使用BS_OWNERDRAW风格来代替BS_USERBUTTON风格。<br>
可使用SS_LEFT或SS_LEFTNOWORDWRAP风格来代替静态控制的SS_SIMPLE风格。<br>
不支持MDICLIENT窗口类。<br>
所有窗口都隐含WS_CLIPSIBLINGS和 WS_CLIPCHILDREN风格。<br>
Windows CE1.0版除对话框外不支持被属窗口。如果hwndParent参数不为NULL，则窗口隐含给出WS_CHILD风格。Windows CE1.0不支持菜单条。<br>
<h3>速查</h3> Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib； Unicode：在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

27
src/docs/win32api/1/CreateMDIWindow.html Normal file
View File

@ -0,0 +1,27 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数创建一个多文档接口MDI的子窗口。<br>
<h3>函数原型</h3>HWND GreateMDIWindow（LPTSTR IpClassName，LPTSTR IpWindowName，LPTSTR IpWindowName，DWORD dwStyle，int X，int Y，intn Width，int nHeight，HWND hWndParent，HINSTANCE hlnstance，LPARAM IParam）；<br>
<h3>参数</h3>
lpClassName：以“\O”为结尾的字符串指针，该字符串指定MDI子窗口的窗口类。该类名必须已通过调用 RegisterClassEx函数注册过。<br>
lpWindowsName：以“＼O”为结尾的字符串指针，该字符串表示窗口的名字。系统在子窗口的标题条中显示此名字。<br>
dwStyle：规定MDI子窗口形式。如果MDI客户窗口是以MDIS-ALLCHILDSTYLES窗日形式创建的，这个参数可以是在Createwindow函数描述中列出的窗口形式的任何组合；否则，这个参数必须取下列值之一或多个组合：<br>
WS_MINIMIZE：创建一个初始状态为极小化的MDI子窗口。<br>
WS_MAXIMIZE：创建一个初始状态为极大化的MDI子窗口。<br>
WS_HSCROLL：创建一个带有水平流动条的MDI子窗口。<br>
WS_VSCROLL：创建一个带有垂直流动条的MDI子窗口。<br>
X：指定MDI子窗口在客户坐标系中水平位置的初值。如果此参数值为CW_USEDEFAULT，MDI子窗口被分配为水平位置的缺省值。<br>
Y：指定MDI子窗口在客户坐标系中垂直位置的初值。如果此参数为CW_USEDEFAULT，MDI子窗口被分配为垂直位置的缺省值。<br>
nWidth：指定MDI子窗口的初始宽度，单位为设备单位。如果此参数值为CW_USEDEFAULT，MDI子窗口被分配为缺省宽度。<br>
nHeight：指定MDI子窗口的初始高度，单位为设备单位。如果此参数值为CW_USEDEFAULT，MDI子窗口被分配为缺省高度。<br>
hWndParent：指向MDI客户窗口的句柄，该窗口为新的MDI子窗口的父窗口。<br>
hlnstance：指向创建MDI子窗口的应用事例的句柄。<br>
lParam：指定一个应用程序定义的值。<br>
<h3>返回值</h3>如果函数调用成功，返回值为所创建窗口的句柄；否则，返回值为NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：使用CreateMDIWindow函数与发送WM_MDCREATE消息给一个MDI客户窗日相似，区别是函数可以在不同的线程中创建一个MDI子窗口，而消息不可以。<br>
Windows 95。系统最多可以支持16，364个窗口句柄。<br>
<h3>速查</h3>Windows NT： 3.1及以上版本； Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib；Unicoae：在Windows NT环境中以Unicode和ANSI方式实现。<br>
</body>
</html>

48
src/docs/win32api/1/CreateWindowEx.html Normal file
View File

@ -0,0 +1,48 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数创建一个具有扩展风格的重叠式窗口、弹出式窗口或子窗口，其他与
CreateWindow函数相同。关于创建窗口和其他参数的内容，请参看CreateWindowEx。<br>
<h3>函数原型</h3>HWND CreateWindowEx（DWORD dwExStle，LPCTSTR IpClassName，LPCTSTR lpWindowName，DWORD dwStyle，int x，int y,int nWidth，int nHeight，HWND hWndParent，HMENUhMenu，HANDLE hlnstance，LPVOIDlpParam）；<br>
<h3>参数</h3>
dwExStyle：指定窗口的扩展风格。该参数可以是下列值：<br>
WS_EX_ACCEPTFILES：指定以该风格创建的窗口接受一个拖拽文件。<br>
WS_EX_APPWINDOW：当窗口可见时，将一个顶层窗口放置到任务条上。<br>
WS_EX_CLIENTEDGE：指定窗口有一个带阴影的边界。<br>
WS_EX_CONTEXTHELP：在窗口的标题条包含一个问号标志。当用户点击了问号时，鼠标光标变为一个问号的指针、如果点击了一个子窗口，则子窗日接收到WM_HELP消息。子窗口应该将这个消息传递给父窗口过程，父窗口再通过HELP_WM_HELP命令调用WinHelp函数。这个Help应用程序显示一个包含子窗口帮助信息的弹出式窗口。 WS_EX_CONTEXTHELP不能与WS_MAXIMIZEBOX和WS_MINIMIZEBOX同时使用。<br>
WS_EX_CONTROLPARENT：允许用户使用Tab键在窗口的子窗口间搜索。<br>
WS_EX_DLGMODALFRAME：创建一个带双边的窗口；该窗口可以在dwStyle中指定WS_CAPTION风格来创建一个标题栏。<br>
WS_EX_LEFT：窗口具有左对齐属性，这是缺省设置的。<br>
WS_EX_LEFTSCROLLBAR：如果外壳语言是如Hebrew，Arabic，或其他支持reading order alignment的语言，则标题条（如果存在）则在客户区的左部分。若是其他语言，在该风格被忽略并且不作为错误处理。<br>
WS_EX_LTRREADING：窗口文本以LEFT到RIGHT（自左向右）属性的顺序显示。这是缺省设置的。<br>
WS_EX_MDICHILD：创建一个MD子窗口。<br>
WS_EX_NOPATARENTNOTIFY：指明以这个风格创建的窗口在被创建和销毁时不向父窗口发送WM_PARENTNOTFY消息。<br>
WS_EX_OVERLAPPED：WS_EX_CLIENTEDGE和WS_EX_WINDOWEDGE的组合。<br>
WS_EX_PALETTEWINDOW：WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW和WS_WX_TOPMOST风格的组合WS_EX_RIGHT:窗口具有普通的右对齐属性，这依赖于窗口类。只有在外壳语言是如Hebrew,Arabic或其他支持读顺序对齐（reading order alignment）的语言时该风格才有效，否则，忽略该标志并且不作为错误处理。<br>
WS_EX_RIGHTSCROLLBAR：垂直滚动条在窗口的右边界。这是缺省设置的。<br>
WS_EX_RTLREADING：如果外壳语言是如Hebrew，Arabic，或其他支持读顺序对齐（reading order alignment）的语言，则窗口文本是一自左向右）RIGHT到LEFT顺序的读出顺序。若是其他语言，在该风格被忽略并且不作为错误处理。<br>
WS_EX_STATICEDGE：为不接受用户输入的项创建一个3一维边界风格<br>
WS_EX_TOOLWIDOW：创建工具窗口，即窗口是一个游动的工具条。工具窗口的标题条比一般窗口的标题条短，并且窗口标题以小字体显示。工具窗口不在任务栏里显示，当用户按下alt＋Tab键时工具窗口不在对话框里显示。如果工具窗口有一个系统菜单，它的图标也不会显示在标题栏里，但是，可以通过点击鼠标右键或Alt＋Space来显示菜单。<br>
WS_EX_TOPMOST：指明以该风格创建的窗口应放置在所有非最高层窗口的上面并且停留在其L，即使窗口未被激活。使用函数SetWindowPos来设置和移去这个风格。<br>
WS_EX_TRANSPARENT：指定以这个风格创建的窗口在窗口下的同属窗口已重画时，该窗口才可以重画。<br>
由于其下的同属富日已被重画，该窗口是透明的。<br>
IpClassName:指向一个空结束的字符串或整型数atom。如果该参数是一个整型量，它是由此前调用theGlobaIAddAtom函数产生的全局量。这个小于OxCOOO的16位数必须是IpClassName参数字的低16位，该参数的高位必须是O。<br>
如果lpClassName是一个字符串，它指定了窗口的类名。这个类名可以是任何用函数RegisterClassEx注册的类名，或是任何预定义的控制类名。请看说明部分的列表。<br>
lpWindowName:指向一个指定窗口名的空结束的字符串指针。<br>
如果窗口风格指定了标题条，由lpWindowName指向的窗口标题将显示在标题条上。当使用CreateWindow<br>
函数来创建控制例如按钮，选择框和静态控制时，可使用lpWindowName来指定控制文本。<br>
dwStyle:指定创建窗口的风格。该参数可以是下列窗口风格的组合再加上说明部分的控制风格。<br>
x：参见CreateWindow。<br>
y：参见CreateWindow。<br>
nWidth:CreateWindow。<br>
nHeigth：参见CreateWindow。<br>
hWndParent：参见CreateWindow。<br>
hMenu：参见CreateWindow。<br>
hlnstance：参见CreateWindow。<br>
lpParam:参见CreateWindow。<br>
<h3>返回值</h3>参见CreateWindow。<br>
备注:参见CreateWindow。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：USer32.lib;Unicode：在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

21
src/docs/win32api/1/DefFrameProc.html Normal file
View File

@ -0,0 +1,21 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数对任何多文档接口（MDI）框架窗日的窗口过程不处理的窗口消息提供缺省处理。窗口过程不能明确处理的所有窗口消息必须通过DefFrameProc函数处理，而不是通过DefWindowProc函数。<br>
<h3>函数原型</h3>LRESULT DefFrameProc（HWND hWnd，HWND hWnd，HWND hWndMDIClient，UINT uMsg，WPARAM wParam，LPARAM IParam）；<br>
<h3>参数</h3>
hWnd：MDI框架窗口句柄。<br>
hWndMDIClient：MDI客户窗口句柄。<br>
uMsg：指定要处理的消息。<br>
wParam：指定附加的特定消息信息。<br>
IParam：指定附加的特定消息信息。<br>
<h3>返回值</h3>返回值指定，消息处理的结果其值与处理的消息有关。如果hWndMDIClient参数为NULL，返回值与DefWindowProc函数的相同。<br>
备注：当应用程序的窗口过程不能处理一个消息时，它把消息传递给DefWindowProc函数来处理。MDI应用程序使用DefFrameProc和DefMDIChildProc函数代替DefWindowProc函数提供缺省消息处理。应用程序传递给DefMDIChildProc函数的所有消息（例如非客户消息和WM_SETTEXT消息）通常应被传递给DefFrameFro函数。DefFramePro函数也处理下列消息：<br>
WM_COMMAND：激活用户选择的MDI子窗口。当用户从MDI框架窗口的菜单中选择MDI子窗口时，此消息被发送伴随该消息的窗口标识符识别被激活的MDI子窗口。<br>
WM_MENUCHAR：当用户按下Alt＋C（减）组合键时，打开活动MDI子窗口的窗口菜单。<br>
WM_SETFOCUS：传递键盘响应给MDI客户窗口，客户窗口又依次地把它传递给活动的MDI子窗口。<br>
WM_SIZE：重新设备新的框架窗口客户域的MDI客户窗口大小。如果框架窗口过程设置了不同大小的MDI客户窗口，消息将不传递给DefWindowProc函数。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件；winuser.h；输入库：user32。lib；Unicode：在Windows NT环境中以Unicode和ANSI方式实现。<br>
</body>
</html>

23
src/docs/win32api/1/DefMDIChildProc.html Normal file
View File

@ -0,0 +1,23 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数对任何多文档接口（MDI）子窗口的窗口过程不能处理的窗口消息提供缺省处理。窗口过程不能处理的窗口消息必须传递给DefMDIChildProc函数，而不是DefWindowProc函数。<br>
<h3>函数原型</h3>LRESULT DDMDIChildProc（HWND hwnd，UINT uMsg，WPARAM wParam，LPARAM IParam）<br>
<h3>参数</h3>
hWnd：MDI子窗口句柄。<br>
wParam：指定要处理的消息。<br>
wParam：指定附加的特定消息信息。<br>
IParam：指定附加的特定消息。<br>
<h3>返回值</h3>返回值指定信息处理的结果和其值与处理的消息有关。<br>
备注：DefMDIChifdProc函数假定由hwnd参数所识别的MDI子窗口的父窗口是由MDICLIENT类生成的。<br>
当应用程序的窗口过程不能处理一个消息时，它把消息传递给DefWindowProc函数来处理，MDI应用程序使用DefFrameProc和DefMDfChildProc函数来代替DefWindowProc函数提供缺省消息处理。应用程序传递给DefwindowProc函数的所有消息（例如非客户消息和WMSET_SETTEXT消息）通常都应传递给DefMDIChildProc函数。另外DefMDIChildProc函数也能处理下列消息：<br>
WM_CHILDACTIVATE：当MDI子窗口被改变大小，移动或显示时执行激活过程。这个消息必须被传递。<br>
WM_GETMINMAXINFO：根据MDI客户窗口的当前大小，计算MDI子窗口极大化的尺寸。<br>
WM_MENUCHAR：传递消息给MDI框架窗口。<br>
WM_MOVE：重新计算MDI客户滚动条，如果存在的话。<br>
WM_SETFOCUS：如果子窗口不是活动的MDI子窗口，激活它。<br>
WM_SIZE；执行改变窗口大小所必须的操作，特别是MDI子窗口极大化或恢复一个MDI子窗口时。如果这个消息没有成功地传递给DefMDIChildProc函数，则很可能产生不是需要的结果。<br>
WM_SYSCOMMAND：处理窗口菜单命令：SC.NEXTWINDOW，SC_PREVWINDOW，SC_MOVE，SC_SIZE，和SC_MAXIMIZE。<br>
<h3>速查</h3>Window NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境中以Unicode和ANSI方式实现。<br>
</body>
</html>

43
src/docs/win32api/1/DeferWindowPos.html Normal file
View File

@ -0,0 +1,43 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为指定的窗口更新指定的多窗口位置结构，然后函数返回该更新结构的句柄。EndDeferWindowPos函数使用该结构内的信息同时改变一些窗口的位置和大小。该结构由BeginDeferWindowPos函数创建。<br>
函数原型:HWND DeferWindowPos（HDWP hWinPoslnfo，HWND hWnd,HWND hWndlnsertAffer, int x,int y, int cx, int Cy,UNIT uFags）；<br>
<h3>参数</h3>
hWinPoslnfo:多窗口定位结构的句柄，该结构包含着一个或多个窗口的尺寸和定位信息，可以由函数BeginDeterWindowPos返回该结构或是由最近一次调用的DeferWindowPos函数返回。<br>
hWnd:窗口的句柄，该窗口的更新信息存储在结构中。<br>
hWndlnsertAfter：被定位窗口的Z序的前一窗口的句柄。这个参数必须为窗口句柄或下列值之一：HWND_BOTTOM：将窗口定位在Z序的底部。如果hWnd参数指定的是一个最顶层窗口，则该窗口将失去顶级位置而被排在所有其他窗口的底部。<br>
HWND_NOTOPMOST：将窗口放置在所有顶层窗口的顶部（即在所有顶层窗口的后面）。如果窗口已经是一个非顶层窗口则此参数不起作用。<br>
HWND_TOP：将窗口放置在Z序的顶部。<br>
HWND_TOPMOST：将窗口放置在所有非顶层窗口的顶部、即使未被激活，窗口仍保持顶级位置。如果在uFlagS参数中指定了SWP_NOZORDER标志则本参数将被忽略。<br>
x：指定窗口左上角的X坐标。<br>
y：指定窗口左上角的y坐标。<br>
cx：以像素定义窗口的新的宽度。<br>
cy：以像素定义窗口的新的宽度。<br>
uelage:指定下列影响窗口的大小和位置的值的组合：<br>
SWP_DRAWFRAME：在窗口周围画一个边框（该边框定义在窗口类的描述中）。<br>
SWP_FRAMECHANGED：给窗口发送一个WM_NCCALCSIZE消息，即使窗口的尺寸不作改变也要发送。如果未指定这个标志，则只有窗口大小 改变时才发送WM_NCCALCSIZE消息。<br>
SWP_HIDEWINDOW：隐藏窗口。<br>
SWP_NOACTIVATE：不激活窗口。如果未指定这个标志，则窗口被激活并且根据hWndlnsertAfter参数的设置移到或是顶部窗口的顶部或是非顶部窗口的顶部。<br>
SWP_NOMOVE；维持当前位置（忽略X和y参数）。<br>
SWP_NOOWNERZORDER：不改变所有者窗口在Z序中的位置。<br>
SWP_NOREDRAM：不作窗口更新。如果设定了这个标志，则不发生任何窗口刷新的动作。包括不对客户区，非客户区（包括标题条和滚动条），以及由于窗口移动露出的部分父窗口进行刷新。当设定了这个标志时，应用程序一定要明确指出将原窗口清除并且重画窗口的任何部分以及父窗口需要重画的部分。<br>
SWP_NOREPOSITION：同 SWP_NOOWNERZORDER标志。<br>
SWP_NOSENDCHANGING：防止窗口接受到WM_WINDOWPOSCHANGING消息。<br>
SWP_NOSIZE；保持当前大小。（即忽略CX,Xy参数）。<br>
SWP_NOZORDER：保持当前Z序（忽略hWndlnsertAfter参数）。<br>
SWP_SHOWWINDOW：显示窗口。<br>
<h3>返回值</h3>返回值指明了被更新的多窗口定位结构。函数返回的句柄可能与传递给函数的句柄不同。这个函数返回的新句柄应在下一次调用时传递给DeferWindowPos函数和EndDeferWindowPos函数。如果调用函数时系统资源不足，则函数返回NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：如果调用函数DeferWindowPos失败，应用程序应放弃窗口定位动作，并且不再调用EndDeferWindowPos 函数。如果未指定SWP_NOZORDER，系统将由hWnd参数指定的窗口定位于在hWndlnsertAfer参数指定的窗口之后的位置。如果hWndlnsertAfsr参数为空或为HWND_TOP，则系统将窗口放置在Z序顶端。如果hWndlnsertAfer设为HWND_BOTTOM则系统将窗口放置在Z序的底部。<br>
所有子窗口的坐标都是相对于父窗口客户区的左上角的坐标。<br>
一个窗口可以通过两种方式设为顶部窗口：或是设hWndlnsertAfter为HWND_TOPMOST并确保未设置SWP_NOZORDER标志；或是设置窗口在Z序中的位置使其在所有已存在的顶端窗口的顶部。当一个非顶端窗口被设为顶端窗口时，则属于它的窗口均被置为顶端窗口，而其所有者则不变。<br>
如果SWP_NOACTIVATE或SWP_NOZORDER均未设置（即当应用程序要求在窗口被激活的同时改变其z序时），hwdfnsertPos参数只在下列情况中使用：<br>
在hWndlnsertAfter参数中既未设定HWND_TOPMOST也未设定HWND_NoTTOPMOST标志； 由hWnd指定的窗口不是激活窗口；<br>
应用程序在将窗口设为活动窗口时应将窗口设置到Z序的顶部。应用程序可以不受任何限制地改变被激活窗口在Z序中的位置，或在激活一个窗口之后将该窗口移到顶端窗口或非顶端窗口的顶部。<br>
如果一个顶端窗口被重定位到Z序的底部（HWND_BOTTOM）或任何非顶端窗口后面时将不再是顶端窗口。<br>
一个非顶端窗口可能拥有一个顶端窗口，反之则不成立。从属的任何窗口（例如一个对话框）都设置为顶层窗口以确保所有的从属窗口都在其所有者之上。<br>
<h3>速查</h3> Windows NT：3.1以上版本；Windows：95以上版本； Windows CE：不支持；头文件： winuser.h；库文件：user32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/DestroyWindow.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>是与函数EnumChilWindows一起使用的由应用程序定义的回调函数。它接收子窗口句柄。类型 WNDENUMOROC定义了指向这个回调函数的指针。EnumChildProc是一个应用程序定义的函数名的位置标志符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumChildProc（HWND hWnd，LPARAM IParam）；<br>
<h3>参数</h3>
hWnd:指向在EnumChildWlndows中定义的父窗口的子窗口句柄。<br>
lparam：指定在EnumchildWindows中给出的应用程序定义值。<br>
<h3>返回值</h3>为继续列举，回调函数必须返回TRUE；为停止列举，回调函数必须返回FALSE。<br>
备注：回调函数可以执行任何要求的任务。应用程序必须通过将其地址传送给EnumChildwindows函数来注册这个回调函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持：头文件：winuser.h；库文件：用户自定义。<br>
</body>
</html>

14
src/docs/win32api/1/DispatchMessage.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数调度一个消息给窗口程序。通常调度从GetMessage取得的消息。<br>
<h3>函数原型</h3>LONG DispatchMessage（CONST MSG★lpmsg）；<br>
<h3>参数</h3>
lpmsg：指向含有消息的MSG结构的指针。<br>
<h3>返回值</h3>返回值是窗口程序返回的值。尽管返回值的含义依赖于被调度的消息，但返回值通常被忽略。<br>
备注：MSG结构必须包含有效的消息值。如果参数lpmsg指向一个WM_TIMER消息，并且WM_TIMER消息的参数IParam不为NULL，则调用IPa1ram指向的函数，而不是调用窗口程序。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

15
src/docs/win32api/1/DragDetect.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数捕获并跟踪鼠标的移动直到用户松开左键、按下Esc。键或者将鼠标移动到围绕指定点的“拖动矩形”之外。拖动矩形的宽和高由函数GetSystemMetrics返回的SM_CXDRAG或SM_CYDRAG确定。<br>
<h3>函数原型</h3>BOOL DragDetect（HWND hwnd，POINT pt）；<br>
<h3>参数</h3>
hwnd：接受鼠标输入的窗口的句柄。<br>
pt：鼠标在屏幕坐标下的初始位置，此函数根据这个点来确定拖动矩形的坐标。<br>
<h3>返回值</h3>如果用户在按着鼠标左键时将鼠标移出了拖动矩形之外，则返回非零值；如果用户按着鼠标左键在拖动内移动鼠标，则返回值是零。<br>
备注：拖动矩形的系统度量是可构造的，允许更大或更小的拖动矩形。<br>
<h3>速查</h3>Windows NT： 4.0及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

27
src/docs/win32api/1/EnableScrollBar.html Normal file
View File

@ -0,0 +1,27 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数可以激活一个或两个滚动条箭头或是使其失效。<br>
<h3>函数原型</h3>BOOL EnableScrollBar（HWND hWnd，UINT WSBflags，UINT wArrows）；<br>
<h3>参数</h3>
hWnd：根据参数wSBflags的值，处理对雷体或滚动条的处理。<br>
wSBflags：指定滚动条的类型。这个参数可以是下面的值，含义如下：<br>
SB_BOTH：可以将指定窗体的水平及垂直滚动条上的箭头激活或使其失效。此时参数hWnd一定指向窗体。<br>
SB_CTL：标识滚动条控制器。此时参数必须指向滚动条控制器。<br>
SB_HORZ：可以将指定窗体的水平滚动条上的箭头激活或使其失效。此时参数hWnd一定指向窗体。<br>
SB_VERT：可以将指定窗体的垂直滚动条上的箭头激活或使其失效。此时参数hWnd一定指向窗体。<br>
wArrows：指定滚动条上的箭头是否被激活或是无效，并指出哪一个箭头位有效或是无效。这个参数可以是下面的值，其含义如下：<br>
ESB_DISABLE_BOTH：使滚动条上两面的箭头功能无效。<br>
ESB_DISABLE_DOWN：使垂直滚动条上下面的箭头功能无效。<br>
ESB_DISABLE_LEFT：使水平滚动条上左边箭头功能无效。<br>
ESB_DISABLE_LTUP：使水平滚动条上左边箭头或垂直滚动条上面的箭头功能无效。<br>
ESB_DISABLE_RLGHT：使水平滚动条上右边箭头功能无效。<br>
ESB_DISABLE_RTDN：使水平滚动条上右边箭头或垂直滚动条下边的箭头功能无效。<br>
ESB_DISABLE_UP：使垂直滚动条上向下箭头功能无效。<br>
ESB_ENABLE_BOTH：激活滚动条两面的箭头。<br>
<h3>返回值</h3>如果被指定的箭头被激活或未被激活，其返回值为非零；如果箭头已经是被请求的状态或是出现错误，那么返回值为零。若想获得更多的错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

17
src/docs/win32api/1/EnableWindow.html Normal file
View File

@ -0,0 +1,17 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数允许或禁止指定的窗口或控制接受鼠标输入或键盘输入。当输入被禁止时窗口不能接收鼠标单击和按键等类输入；当输入允许时，窗口接受所有的输入。<br>
<h3>函数原型</h3>BOOL EnableWindow（HWND hWnd，BOOL bEndble）；<br>
<h3>参数</h3>
hWnd：允许或禁止的窗口句柄。<br>
bEnable：指定是允许还是禁止窗口。如果这个参数为TRUE，窗口允许；如果参数为FALSE，则窗口被禁止。<br>
<h3>返回值</h3>如果窗口此前曾被禁止，则返回值为非零；如果窗口此前未被禁止，则返回值为零。若想获得更多错误信息，请调用 GetLastError函数。<br>
备注：如果窗口的使能状态正在改变，则在EnableWindow函数返回前发送一个WM_ENABLE消息。如果窗口己经被禁止，则它的所有子窗口都被禁止，即使未向它们发送WM_ENABLE消息。<br>
在一个窗口被激活前必须是使能的。例如，如果应用程序正在显示一个无模式对话框并且禁止了它的主窗口，则应用程序在销毁对话框之前一定要使能该主窗口。否则，将有另外一个窗口接受键盘焦点并且被激活。如果一个子窗口被禁止，则在系统确定由哪一个窗口接受鼠标消息时该子窗口将被忽略。<br>
当窗口被创建时缺省为使能状态。要创建一个初始被禁止的窗口，应用程序可以在CreateWindowh 函数和CreateWindowhEx中指定WS_DISABLED风格。在窗口被创建后，应用程序可以使用EnaoleWindow函数来使能和禁止窗口。<br>
应用程序可以使用这个函数来使能或禁止在对话框内的控制。一个被禁止的控制不能接受键盘焦点用户也不能进入该控制。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本； Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/EndDeferWindowPos.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数在一个单一的屏幕刷新周期内同时更新一个或多个窗口的位置和大小。<br>
<h3>函数原型</h3>BOOL EndDeferWindowPos（ HWND hWinPoslnfo）；<br>
参数；<br>
hWlnPoslnfo：指向多窗口定位结构的句柄，该结构包含着一个或多个窗口的尺寸和定位信息。这个内部结构由BeginDeferWindowPos函数返回或由最近一次调用DeferWindowPos函数退回。<br>
<h3>返回值</h3>如果函数成功，返回值为非零：如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注；EndDeferWindowPos函数向内部结构指定的每一个窗口发送WM_WINDOWPOSCHANGING和WM_WINDOWPOSCHANGED消息。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持：头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/EndUpdateResource.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数终止在可执行文件中的资源更新。<br>
<h3>函数原型</h3>BOOL EndUpdateResource（HANDLE hUpdate，BOOL fDiscard）；<br>
<h3>参数</h3>
hUpdate：用于资源更新的句柄。此句柄通过BeginUpdateResource函数返回。<br>
fDiscard：用来说明是否向可执行文件中写入资源更新内容。如果此参数为TRUE，则在可执行文件中无变化；如果此参数为FALSE，则在可执行文件中写入变化。<br>
<h3>返回值</h3>如果函数运行成功，并且通过调用UpdateResource函数指定的不断积聚的资源修正内容被写入指定的可执行文件，那么其返回值为非零。如果函数运行失败，其返回值为零。若想获得更多的错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT 3.1以上，头文件：winbase.h；库文件：kernel32.lib，Unicode：在Windows NT上实现为Unicode和ANSl两种版本。<br>
</body>
</html>

13
src/docs/win32api/1/EnumChildProc.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是由应用程序定义的，与函数EnumChildWindows一起使用的回调函数。它接收子窗口句柄。类型WNDENUMPROC定义了一个指向回调函数的指针。EnumChildProc是一个应用程序定义的函数名的位置标志符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumChildProc（HWND hwnd，LPARAM ItParam）；<br>
<h3>参数</h3>
hwnd：指向在EnumChildWindows中指定的父窗口的子窗口句柄。<br>
Lparam：指定在EnumChildWindows函数给出的应用程序定义值。<br>
<h3>返回值</h3>为继续枚举，回调函数必须返回TRUE；为停止枚举，回调函数必须返回FALSE。<br>
备注：回调函数可以执行任何要求的任务。<br>
应用程序必须通过将其地址传送给EnumChildWindows函数来注册这个回user.h；库文件：用户自定义。<br>
</body>
</html>

13
src/docs/win32api/1/EnumChildProcWORD.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
{dwThreadld,WNDENUMROCIpfn,LPARAMIPam};<br>
<h3>参数</h3>
dwThreadld:标识将被列举窗口的线程。<br>
lpfn：指向一个应用程序定义的回调函数指针，请参看EnumThreadWndProc。<br>
IPararm:指定一个传递给回调函数的应用程序定义值。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持：头文件：winuser.h；库文件：user32.Iib。<br>
</body>
</html>

28
src/docs/win32api/1/EnumResLangProc.html Normal file
View File

@ -0,0 +1,28 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是一个用户定义的和EnumResourceLanguages函数一起使用的回调函数。它接收资源语言。ENUMRESLANGPROC类型定义指向该响应函数的指针。EnumResLangProc是用户定义的函数名称的占位符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumResLangProc（HANDLE hModule，LPCTSTR IPszType， LPCTSTR IpszName，WORDwlDLanguage，LONG IParam）；<br>
<h3>参数</h3>
hModule：处理那些包含着被列举术语资源的可执行文件的模块。如果这个参数为空，函数将在模块中列出在建当前过程时所用的资源术语。<br>
lpszType：指向一个以NULL为结束符的字符串，字符串指定了那些被列举的语句资源的类型名。作为标准的资源类型，此参数可以为下列值，含义如下：<br>
RT_ACCELERATOR：加速器表；RT_ANICURSOR：动态光标；<br>
RT_ANIICON：动态图标；RT_BITMAP：位图资源；<br>
RT_CURSOR：由硬件支持的光标资源；DI_DIALOG：对话框：<br>
RT_FONT：字体资源；RT_FONTDIR；字体目录资源；<br>
RT_GROUP_CURSOR：与硬件无关的光标资源；<br>
RT_GROUP_ICON：与硬件无关的目标资源；<br>
RT_HTML：HTML文档；RT_ICON：由硬件支持的图标资源：<br>
RT_MENU：菜单资源；RT_MESSAGETABLE：消息表的入口；<br>
RT_PLUGPLAY：即插即用资源；<br>
RT_RCDATA：应用定义资源（原始数据）：RT_STRING字符表入口；<br>
RT_VERSION：版本资源：RT_VXD：VXD。<br>
lpszName：指向一个以NULL为结束符的字符串，字符串说明了在资源中被列举出术语的名称。<br>
wlDLanguage：指定了在资源中被列举出语句的标识符。EnumResourceLanguages函数提供了这一值。有关原始的语句标识符和由标识符组成子句标识符的列表可以详看MAKELANGID。<br>
IParam：指定将应用定义的参数传递给EnumResourceLanguages函数，此参数将被用于错误检查。<br>
<h3>返回值</h3>此响应函数返回值为TRUE时将继续列举：否则，当返回值为FALSE时将停止列举。<br>
注意：应用程序必须通过向EnumResourceLanguages函数传递这个函数的地址来注册。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winbase.h；库文件：由用户定义。<br>
</body>
</html>

16
src/docs/win32api/1/EnumResNameProc.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是一个用户定义的和EnumResourceNames函数一起使用的回调函数。ENUMRESNAMEPROC类型定义一个指向该回调函数的指针。EnumResNameProc是用户定义函数名的占位符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumResNameProc（HANDL hModue.LPCTSTR haszTyPe，LPTSTR IPszName，LONGIParam）；<br>
参数:<br>
hModule：处理包含被列举资源文件名的可执行文件的模块。如果这个参数为NULL，那么函数将在模块中列举出创建当前过程的资源名称。<br>
lpszType：指向以NULL为结束符的字符串，它指定了被列举出的资源类型名称。作为标准类型，这个参数的含义同EnumResLangProc\lpszType。<br>
lpszName：指向以NULL为结束符的字符串，它指定了被列举出的资源名称。<br>
IParam：指定传递给EnumResourceNames函数的应用程序定义的参数，此参数用于错误检查。<br>
<h3>返回值</h3>此响应函数返回值为TRUE时将继续列举；否则，当返回值为FALSE时将停止列举。<br>
注意：应用程序必须通过向EnumResourceNames函数传递这个函数的地址来注册。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winbase.h；库文件：由用户定义。<br>
</body>
</html>

15
src/docs/win32api/1/EnumResTypeProc.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是一个用户定义的和EnumResourceTypes函数一起使用的回调函数。它接收资源类型。EnumResTypeProc类型定义一个指向这个回调函数的指针。EnumResTypeProc是这个用户定义函数名称的占位符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumResTyPeProc（HANDLE hModue，LPTSTR lpszType，LONG IParam）；<br>
<h3>参数</h3>
hModule：处理包含被列举资源类型的可执行文件的模块。如果这个参数为NULL，那么函数将在模块中列举出创建当前过程的资源类型。<br>
IpszType：指向以NULL为结束符的字符串，它指定了被列举出的资源类型。作为标准类型，这个参数的含义同EnumResLangProC＼lpszType。<br>
IParam：指定一个申请定义参数值传递给EnumResourceTypes函数，此参数可以用来错误检查。<br>
<h3>返回值</h3>若响应函数返回TRUE值则继续列举；否则，返回FALSE值时将停止列举。<br>
注意：应用程序必须通过将函数的地址传递给EnumResourceTypes函数来注册。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winbase.h；库文件：由用户定义。<br>
</body>
</html>

19
src/docs/win32api/1/EnumResourceLanguages.html Normal file
View File

@ -0,0 +1,19 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为每个指定类型和名称的资源搜索模块，并且向定义的回调函数传递所搜寻到的每种资源语言。<br>
函数原型；BOOL EnumResourceLanguages（HMODULE hModule，LPCTSTR lpType，LPCTSTR IpName，ENUMRESthNGPROC lpEnumFunc，LONG IParam）；<br>
<h3>参数</h3>
hModule：处理包含被列举语言资源的可执行文件的模块。如果这个参数为NULL，那么函数将在模块中列举出创建当前过程的语言资源。<br>
lpType：指向以NULL为结束符的字符串，它指定了被列举出的语言资源类型。作为标准类型，这个参数的含义同EnumResLangProc\lpType。<br>
IpName：指向以NULL为结束符的字符串，它指定了被列举出的语言资源名称。<br>
IpEnumFunc：指向所需要每个列举出的语言资源的响应函数。如要了解更多的信息请参见<br>
EnumResLangProc。<br>
IParam：指定一个申请定义参数值传递给响应函数，此参数可以用来错误检查。<br>
<h3>返回值</h3>若函数运行成功，则返回非零值；若函数运行失败，则返回零值。若想获得更多错误信息，请调用GetLastError函数。<br>
注意：EnumResourceLanguages函数将连续列举出语言资源，直到响应函数返回False值或全部的语言资源均被列举完毕。<br>
<h3>速查</h3>Windows NT 3.1、 Windows 95以上，头文件：winbase.h；库文件：kernel32.lib；Unicode：在Windows和Winaows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

15
src/docs/win32api/1/EnumResourceNames.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为每个指定类型的资源搜寻模块，并将每个查找到的资源名称传递给回调函数。<br>
<h3>函数原型</h3> BOOL EnumResourceNames（HINSTANCE hModue，LPCTSTR lpszType，ENUMRESNAMEPROC lpEnumFunc，LONG IParam）；<h3>参数</h3>
hModule：处理包含被列举资源名称的可执行文件的模块。如果这个参数为NULL，那么函数将在模块中列举出创建当前过程的资源名称。<br>
lpszType：指向以NULL为结束符的字符串，它指定了被列举出的资源类型名称。作为标准类型，这个参数的含义同EnumResLangProc\lpszType。<br>
lpEnumFunc：指向所需要每个列举出的资源名称的响应函数。如要了解更多的信息请参见EnumResNameProc。<br>
IParam：指定一个申请定义参数值传递给响应函数，此参数可以用来错误检查。<br>
<h3>返回值</h3>若函数运行成功，则退回非零值；若函数运行失败，则退回零值。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：函数将连续列举出资源名称，直到响应函数返回False值或全部的资源名称均被列举完毕。<br>
<h3>速查</h3> Windows NT 3.1、 Windows 95以上，头文件：winbase.h；库文件： kernel32.lib；Unicode：在Windows和Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

15
src/docs/win32api/1/EnumResourceTypes.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为资源搜寻模块并且将它找到的每个资源类型传递给用户定义的回调函数。<br>
<h3>函数原型</h3>BOOL EnumResourceTypes（HMODULE hModule，ENUMRESTYPEPROC lpEnumFunc，LONG IParam）；<br>
<h3>参数</h3>
hModule：处理包含被列举资源类型的可执行文件的模块。如果这个参数为NULL，那么函数将在模块中列举出创建当前过程的资源类型。<br>
lpEnumFunc：指向所需要每个列举出的资源类型的响应函数。如要了解更多的信息请参见<br>
EhumResNameProc。<br>
IParam：指定申请定义值传递给响应函数。<br>
<h3>返回值</h3>若函数运行成功，则返回非零值；若函数运行失败，则返回零值。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：函数将连续列举出资源名称，直到响应函数返回False值或全部的资源名称均被列举完毕。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winbase.h；库文件：kernel32.lib；Unicode：在Windows和Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

7
src/docs/win32api/1/EnumTaskWindows.html Normal file
View File

@ -0,0 +1,7 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数已经过时，由EnumThreadwindows函数取代它。
</body>
</html>

15
src/docs/win32api/1/EnumThreadWndProc.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数枚举所有与一个线程相关联的非子窗口，办法是先将句柄传送给每一个窗口，随后传送给应用程序定义的回调函数。EnumThreadWindows函数继续直到所有窗口枚举完为止或回调函数返回FALSE为止。要枚举一个特定窗口的所有子窗口，使用EnumChildWindows函数。<br>
<h3>函数原型</h3>BOOL EnumThreadWindows（DWORD dwThreadld,WNDENUMPROClpfn,LPARAMlparam）；<br>
<h3>参数</h3>
dwThreadld：标识将被列举窗口的线程。<br>
lpfn：指向一个应用程序定义的回调函数指针，请参看EnumThreadWndProc。<br>
lPararm：指定一个传递给回调函数的应用程序定义值。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本； Windows：95以上版本； Windows CE：不支持：头文件：winuser.h；库文件：user32.Iib。<br>
</body>
</html>

19
src/docs/win32api/1/EnumTreadWindows.html Normal file
View File

@ -0,0 +1,19 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数枚举所有与一个线程有关的非子窗口。办法是先将句柄传给每一个窗口，随后传送给应用程序定义的回调函数。EnumThreadWindows函数继续到所有窗口枚举完为止或回调函数返回FALSE为止。要枚举一个特定窗口的所有子窗口；使用EnumChjdwjndows函数。<br>
<h3>函数原型</h3>BOOL EnumThreadWindows{D<h3>函数功能</h3>该函数销毁指定的窗口。该函数发送WS_DESTROY，WS_NCDESTROY消息到窗口中以撤消该窗口并且将键盘焦点移开。该函数也销毁窗口菜单，刷新线程消息队列，销毁计时器，删除剪贴板的所有权，并断开剪贴板视窗链接（如果窗口在视窗链接的顶端）。<br>
如果指定的窗口是父窗口或所有者窗口，DestroyWindow在销毁父窗口或所有者窗口时自动销毁相关的子窗口和从属窗口。该函数首先销毁相关联的子窗口和从属窗口，然后销毁父窗口和所有者窗口。<br>
DestroyWindow也销毁由CreateDialog函数创建的无模式对话框。<br>
<h3>函数原型</h3> BOOL DestroyWindow（HWND hWnd）；<br>
<h3>参数</h3>
hWnd；将被销毁窗口的句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：一个线程不能用DestroyWindow函数销毁由其他线程创建的窗口。<br>
如果被销毁窗口是一个不具有 WS_EX_NOPARENTNOTIFY风格的子窗口，则其父窗口将接收到一个WM_PARENTNOTIFY消息。<br>
Windows CE：DestroyWindow函数不发送 WM_NCDESTROY消息。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本：头文件：Winuser.h；库文件：user32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/EnumWindows.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数枚举所有屏幕上的顶层窗口，办法是先将句柄传给每一个窗口，然后再传送给应用程序定义的回调函数。EnumThreadWindows函数继续到所有顶层窗口枚举完为止或回调函数返回FALSE为止<h3>函数原型</h3>BOOL EnumWindows（WNDENUMPROC lpEnumFunc，LPARAM lParam）；<br>
<h3>参数</h3>
lpEnumFunc：指向一个应用程序定义的回调数指针，请参看EnumWindowsProc。<br>
lPararm：指定一个传递给回调函数的应用程序定义值。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：EnumWindows函数不列举子窗口。<br>
在循环体中调用这个函数比调用GetWindow函数更可靠。调用GetWindow函数中执行这个任务的应用程序可能会陷入死循环或指向一个已被销毁的窗口的句柄。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/EnumWindowsProc.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是一个与EnumWindows或EnumDesktopWindows一起使用的应用程序定义的回调函数。它接收顶层窗口句柄。WNDENUMPROC定义一个指向这个回调函数的指针。EnumWindowsProc是应用程序定义函数名的位置标志符。<br>
<h3>函数原型</h3>BOOL CALLBACK EnumWindowsProc（HWND hwnd，LPARAM IParam）；<br>
<h3>参数</h3>
hwnd：顶层窗口句柄。<br>
lParam：指定在EnumWIndowsh或EnumDesktopWindows中的应用程序定义值。<br>
<h3>返回值</h3>为继续列表，回调函数必须返回TRUE；若停止列表，它必须返回FALSE。<br>
备注：应用程序必须通过传递给EnumWindows或EnumDesktopWindows应用程序地址来注册这个回调函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本：头文件：winuser.h；库文件：用户自定义。<br>
</body>
</html>

15
src/docs/win32api/1/FindResourceEx.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定指定模块中指定类型、名称及语言的资源所在位置。<br>
<h3>函数原型</h3>HRSRC FindResourceEx（HXODULE hModule，LPCTSTR lpType，LPCTSTR lpName，WORD wLanguage）；<br>
<h3>参数</h3>
hModule：处理包含资源的可执行文件的模块。如果参数值为NULL，则函数搜索曾经创建的最近过程的模块。<br>
lpType：指向以NULL为结束符的字符串，它指定了被列举出的资源类型名称。若要了解更多的信息，请参见注意部分。作为标准类型，这个参数取值同EnumResLangProc\lpType。<br>
lpName：指向说明资源文件名称并以NULL为结束符的字符串。若要了解更多的信息，请参见注意部分。<br>
WLanguage：指明语言资源。若此参数为MAKELANGID（LANG_NEUTRAL，SUBLANG_NEUTRAL），则为了指定零一种语言，可以使用宏创建这个参数。更多的信息请参见MAKELANGID。<br>
<h3>返回值</h3>如果函数运行成功，其返回值是一个指定资源信息块的句柄。为了获得资源，要将此句柄传递给LoadResource函数。如果函数运行失败，返回值为空。若想获得更多的错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winbase.h；库文件：kernel32.lib； Unicode：在Windows和Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

16
src/docs/win32api/1/FindWindow.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获得一个顶层窗口的句柄，该窗口的类名和窗口名与给定的字符串相匹配。这个函数不查找子窗口。在查找时不区分大小写。<br>
函数型：HWND FindWindow（LPCTSTR IpClassName，LPCTSTR IpWindowName）;<br>
<h3>参数</h3>
IpClassName ：指向一个指定了类名的空结束字符串，或一个标识类名字符串的成员的指针。如果该参数为一个成员，则它必须为前次调用theGlobafAddAtom函数产生的全局成员。该成员为16位，必须位于IpClassName的低 16位，高位必须为 0。<br>
IpWindowName：指向一个指定了窗口名（窗口标题）的空结束字符串。如果该参数为空，则为所有窗口全匹配。<br>
<h3>返回值</h3>如果函数成功，返回值为具有指定类名和窗口名的窗口句柄；如果函数失败，返回值为NULL。<br>
若想获得更多错误信息，请调用GetLastError函数。<br>
备注：Windows CE：若类名是一个成员，它必须是从 RegisterClass返回的成员。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：Winuser.h；库文件：user32.lib; Unicode：在 Windows NT上实现为 Unicode和 ANSI两种版本。<br>
</body>
</html>

28
src/docs/win32api/1/FlndResource.html Normal file
View File

@ -0,0 +1,28 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定指定模块中指定类型和名称的资源所在位置。<br>
<h3>函数原型</h3>HRSRC FindResource（HMODULE hModule，LPCTSTR lpName，LPCTSTR lpType）；<br>
<h3>参数</h3>
hModule：处理包含资源的可执行文件的模块。NULL值则指定模块句柄指向操作系统通常情况下创建最近过程的相关位图文件。<br>
lpName：指定资源名称。若想了解更多的信息，请参见注意部分。<br>
lpType：指定资源类型。若想了解更多的信息，请参见注意部分。作为标准资源类型。这个参数的含义同EnumResLangProc\lpType。<br>
<h3>返回值</h3>如果函数运行成功，那么返回值为指向被指定资源信息块的句柄。为了获得这些资源，将这个句柄传递给LoadResource函数。如果函数运行失败，则返回值为NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
注意：如果参数lpType或lpName的高字节为O，那么其低字节中所给定的资源的类型或名称标识说明。另外，这些参数指向以NULL为终止符的字符串。字符串的第一个字符是＃，后面的字符表示十进制数来表示源类型或名称的整数标识符。例如。字符串"#258"表示整数标识符258。<br>
如果用整数标识符替代名称提交资源，用程序将减少所需的内存容量。<br>
当使用完加速器表，位图，光标，图标，或是菜单后，可以通过调用下表所列举的函数释放内存。加速器表：DestroyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；图标：Destroylcon；菜单DestroyMenu。<br>
当过程创建资源终止时，系统将自动删除这些资源。然而通过调用适当的函数可以保留内存，减少过程中工作设置所需的空间大小。<br>
应用程序可以使用FindResource函数去查找任何种类资源，但是这个函数只有在应用程序并发调用LoadLibray和LockResource函数来存取二进制资源时才被使用。<br>
如果想立即使用某一资源，应用程序将使用下面详细资源函数列表中某一函数去查找装载所需资源，FormatMessage：装裁且格式化信息表接口：LoadAccclerators：装载加速器表；LoadBltmap：装载位图资源；LoadCursor：装载光标资源；Loadlcon：装载图标资源；<br>
LoadMenu：装载菜单资源；LoadString：装载字符串表资源。<br>
例如，应用程序可以使用Loadlcon函数装载某一图标以在屏幕上显示。但是，如果是装载某一图标为了将它的数据复制到另一个应用程序中，那么这个应用程序就应该使用FindResource和LoadResource函数。<br>
字符串资源存储在由若干部分组成的某区域，每部分有16个字符串。每部分的字符串是按统一计数方式排列的有序队形式存储的。<br>
TheLoadstring函数将从相应的区域中摘取字符串资源。<br>
参数hModule不能为NULL句柄。<br>
参数lpName不支持ID为零的资源，即FindResource（h，o，t）不能按预期工作。<br>
不可能在IpTyPe参数中传递RT_ANICURSOR或RT_ANllCON的值。<br>
<h3>速查</h3>Windows NT3.1、Windows95、Windows CE1.0以上，头文件：winbase.h；库文件：kerne132.lib；Unicode；在Windows和Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

18
src/docs/win32api/1/FlndWindowEx .html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获得一个窗口的句柄，该窗口的类名和窗口名与给定的字符串相匹配。这个函数查找子窗口，从排在给定的子窗口后面的下一个子窗口开始。在查找时不区分大小写。<br>
<h3>函数原型</h3>HWND FindWindowEx（HWND hwndParent，HWND hwndChildAfter，LPCTSTR lpszClass，LPCTSTR lpszWindow）；<br>
参数；<br>
hwndParent：要查找子窗口的父窗口句柄。<br>
如果hwnjParent为NULL，则函数以桌面窗口为父窗口，查找桌面窗口的所有子窗口。<br>
Windows NT5.0 and later：如果hwndParent是HWND_MESSAGE，函数仅查找所有消息窗口。<br>
hwndChildAfter ：子窗口句柄。查找从在Z序中的下一个子窗口开始。子窗口必须为hwndPareRt窗口的直接子窗口而非后代窗口。如果HwndChildAfter为NULL，查找从hwndParent的第一个子窗口开始。如果hwndParent 和 hwndChildAfter同时为NULL，则函数查找所有的顶层窗口及消息窗口。<br>
lpszClass：指向一个指定了类名的空结束字符串，或一个标识类名字符串的成员的指针。如果该参数为一个成员，则它必须为前次调用theGlobaIAddAtom函数产生的全局成员。该成员为16位，必须位于lpClassName的低16位，高位必须为0。<br>
lpszWindow：指向一个指定了窗口名（窗口标题）的空结束字符串。如果该参数为 NULL，则为所有窗口全匹配。<h3>返回值</h3>如果函数成功，返回值为具有指定类名和窗口名的窗口句柄。如果函数失败，返回值为NULL。<br>
若想获得更多错误信息，请调用GetLastError函数。<br>
速查 NT：4.0对以上版本；Windows：95以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32．lib；Unicode：在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

10
src/docs/win32api/1/FreeResource.html Normal file
View File

@ -0,0 +1,10 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数已过时。它为16位的基于Win32的应用程序提供了一个简单的端口。对于Win32应用程序（32位）没有必要释放用LoadResource函数装载资源。由LoadResource所获得的资源随着被装载模块的卸载自动被释放。但是，为了保留内存减少的程序工作设置所占空间大小，必须通过调用下列表中的函数以释放加速器表、位图、光标、图标以及菜单所占的内存资源。<br>
加速器表：DestroyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；<br>
图标：Destroylcon；菜单：DestroyMenu。<br>
</body>
</html>

12
src/docs/win32api/1/GetCapture.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数取得捕获了鼠标的窗口（如果存在）的句柄。在同一时刻，只有一个窗口能捕获鼠标；此时，该窗口接收鼠标的输入，无论光标是否在其范围内。<br>
<h3>函数原型</h3>HWND GetCapture（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>返回值是与当前线程相关联的捕获窗口的句柄。如果当前线程里没有窗口捕获到鼠标，则返回NULL。<br>
备注：返回NULL并不意味着系统里没有其他进程或线程捕获到鼠标，只表示当前线程没有捕获到鼠标。<br>
<h3>速查</h3>Windows NT：4.0及以上版本；Wiodows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/GetClientRect .html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获取窗口客户区的坐标。客户区坐标指定客户区的左上角和右下角。由于客户区坐标是相对子窗口客户区的左上角而言的，因此左上角坐标为（0，0）<br>
<h3>函数原型</h3>BOOL GetClientRect（HWND hWnd，LPRECT lpRect）；<br>
<h3>参数</h3>
GetLastError 函数。<br>
备注：Windows CE：命令条包含在客户区中。<br>
<h3>速查</h3>Windows NT: 3.1以上版本：Windows：95以上版本： Windows CE：1.0以上版本：头文件：winuser.h；库文件：user32.lib<br>
</body>
</html>

12
src/docs/win32api/1/GetDesktopWindow.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回桌面窗口的句柄。桌面窗口覆盖整个屏幕。桌面窗口是一个要在其上绘制所有的图标和其他窗口的区域。<br>
<h3>函数原型</h3>HWND GetDesktopWindow（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>函数返回桌面窗口的句柄。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本：Windows CE：不支持；头文件：Winuser.h；库文件：user32.lib。<br>
</body>
</html>

11
src/docs/win32api/1/GetDoubleCllckTime.html Normal file
View File

@ -0,0 +1,11 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数取得鼠标的当前双击时间。一次双击是指对鼠标键的两次连击，第一次击键后在指定时间内击第二次。双击时间是指在双击中，第一次击键和第二次击键之间的最大毫秒数。<br>
<h3>函数原型</h3>UINT GetDoubleClickTime（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>返回是当前双击时间，按毫秒计算。<br>
<h3>速查</h3>Windows NT：4.0及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

12
src/docs/win32api/1/GetForegroundWindow.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回前台窗口（用户当前工作的窗口）。系统分配给产生前台窗口的线程一个稍高一点的优先级。<br>
<h3>函数原型</h3>HWND GetForegroundwindow（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>函数返回前台窗回的句柄。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本：Windows CE：1.0以上版本：头文件：Winuser.h；库文件：user32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/GetLastActivePopup.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定指定窗口中的哪一个弹出式窗口是最近活动的窗口。<br>
<h3>函数原型</h3>HWND GetLastActivePopup（HWND hWnd）；<br>
<h3>参数</h3>
hWnd:所有者窗口句柄。<br>
<h3>返回值</h3>返回值标识了最近活动的弹出式窗口的句柄。如果满足下列任一条件，则返回值与参数hWnd<br>
相同：由hWnd指定的窗口是最近活动的：由hWnd指定的窗口不拥有任何弹出式窗口；由hWnd指定的窗口不是顶层窗口或它属于其他窗口。<br>
<h3>速查</h3>Windows：3.1以上版本；Windows：95以上版本：Windows CE：不支持；头文件：winuser.h；<br>
库文件：user32.lib。<br>
</body>
</html>

22
src/docs/win32api/1/GetMessage.html Normal file
View File

@ -0,0 +1,22 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数从调用线程的消息队列里取得一个消息并将其放于指定的结构。此函数可取得与指定窗口联系的消息和由PostThreadMesssge寄送的线程消息。此函数接收一定范围的消息值。GetMessage不接收属于其他线程或应用程序的消息。<br>
<h3>函数原型</h3>BOOL GetMessage（LPMSG lpMsg，HWND hWnd，UINT wMsgFilterMin，UINT wMsgFilteMax<br>
<h3>参数</h3>
lpMsg：指向MSG结构的指针，该结构从线程的消息队列里接收消息信息。<br>
hWnd：取得其消息的窗口的句柄。这是一个有特殊含义的值（NULL）。GetMessage为任何属于调用线程的窗口检索消息，线程消息通过PostThreadMessage寄送给调用线程。<br>
wMsgFilterMin：指定被检索的最小消息值的整数。<br>
wMsgFilterMax：指定被检索的最大消息值的整数。<br>
<h3>返回值</h3>如果函数取得WM_QUIT之外的其他消息，返回非零值。如果函数取得WM_QUIT消息，返回值是零。如果出现了错误，返回值是_1。例如，当hWnd是无效的窗口句柄或lpMsg是无效的指针时。若想获得更多的错误信息，请调用GetLastError函数。<br>
备注：应用程序通常用返回值来确定是否终止主消息循环并退出程序。<br>
GetMesssge只接收与参数hWnd标识的窗口或子窗口相联系的消息，子窗口由函数IsChild决定，消息值的范围由参数wMsgFilterMin和wMsgFilterMax给出。如果hWnd为NULL，则GetMessage接收属于调用线程的窗口的消息，线程消息由函数PostThreadMessage寄送给调用线程。GetMessage不接收属于其他线程或其他线程的窗口的消息，即使hWnd为NULL。由PostThreadMessage寄送的线程消息，其消息hWnd值为NULL。如果wMsgFilterMin和wMsgFilterMax都为零，GetMessage返回所有可得的消息（即，无范围过滤）。<br>
常数 WM_KEYFIRST和WM_KEYAST可作为过滤值取得与键盘输入相关的所有消息：常数WM_MOUSEFIRST和WM_MOUSELST可用来接收所有的鼠标消息。如果wMsgFilterMin和wMsgFilterMax都为零，GetMessage返回所有可得的消息（即，无范围过滤）。<br>
GetMessage不从队列里清除WM.PAINT消息。该消息将保留在队列里直到处理完毕。<br>
注意，此函数的返回值可非零、零或-1，应避免如下代码出现：<br>
while（GetMessage（IpMsg，hwnd，0，0））…<br>
－1返回值的可能性表示这样的代码会导致致命的应用程序错误。<br>
<h3>速查</h3>Windows NT： 3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：winuser.h；输入库：user32.Iib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

12
src/docs/win32api/1/GetMessageExtralnfo.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为当前线程取得附加消息信息。附加消息信息是应用程序或驱动程序定义的与当前线程的消息队列联系的32位值。可用SetMessageExtralnfo来设置线程的附加消息信息，该消息信息将会保留到下一次调用GetMessage或PeekMessage之前。<br>
<h3>函数原型</h3>LONG GetMessageEXtralnfo（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>返回值为附加信息。附加信息是设备特定的。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/GetMessagePos.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回表示屏幕坐标下光标位置的长整数值。此位置表示当上一消息由GetMessage取得时鼠标占用的点。<br>
<h3>函数原型</h3>DWORD GetMessagePos（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>返回值给出光标位置的X，y坐标。X坐标在低位整数，y坐标在高位整数。<br>
备注：如前所述，X坐标在返回值的低位整数，y坐标在高位整数（都表示有符号值，因为在多显示器的系统里可取得负值）。如果返回值赋给了一个变量，可用MAKEPOINT宏从返回值取得POINT结构。也可用GET_X_LPARAM或GET_Y_LPARAM宏来抽取X，y坐标。<br>
要得到光标的当前位置而不是上一个消息发生时的位置，调用函数GetCursorPos。<br>
要点：不要用LOWORD或HIWORD宏来抽取鼠标位置的x，y坐标，因为在多显示器的系统里将返回不正确的结果。多显示器的系统里可取得负的x， y坐标，但LOWORD和HIWORD将坐标当作无符号量。<br>
Windows CE下，对那些使用记录笔而不是鼠标的设备，光标位置是指当上一信息由GetMessage取得时，记录笔在触屏上的位置。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/GetMessageTime.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回由GetMessage从当前线程队列里取得上一消息的消息时间。时间是一个长整数，指定从系统开始到消息创建（即，放入线程消息队列）的占用时间（按毫秒计算）。<br>
<h3>函数原型</h3>LONG GetMessageTime（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>返回值为消息时间。<br>
备注：由GetMessageTime返回的值对后面的消息并不一定是增长的，因为当计时器计数超过长整数的最大值时，又从零开始计算。为计算消息间的延迟时间，必须验证第二个消息的时间比第一个消息的时间大，然后用第二个消息的时间减去第一个消息的时间。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h输入库：user32，lib。<br>
</body>
</html>

23
src/docs/win32api/1/GetMouseMovePoints.html Normal file
View File

@ -0,0 +1,23 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数取得鼠标或画笔。<br>
<h3>函数原型</h3>int GetMouseMovePoints（UINT cbSize，LPMOUSEMOVEPOlNT lppt，LPMOUSEMOVEPOINT IpptBuf，int，nBufPoints，DWORD resolution）；<br>
<h3>参数</h3>
cbSize：结构MOOSEMOVEPOINT的大小。<br>
lppt：指向结构MOUSEMOVEPOINT的指针，该结构包含了有效的鼠标坐标（屏幕坐标）。也可以包含一个时间标记。<br>
函数GetMouseMovePoints在鼠标坐标历史记录中查找一点。如果此函数查到该点，则返回包含提供点在内的在此之前的最后一个nBufPoints。如果应用程序提供一个时间标记，则函数GetMouseMovePoints将用它来区分记录于不同时间的两个相等的点。<br>
应用程序使用从消息WM_MOOSEMOVE中接收的鼠标坐标来调用此函数，并把它们转换为屏幕坐标。<br>
lpptBut：将接收点的缓冲区的指针。其大小至少应为cbsze· nBuffPoints。<br>
nBufPoints：指定将取得的点的个数。<br>
resolution：指定希望的分辨率。此参数可取下列值之一：<br>
GMMP_USE_DISPLAY_POINTS：用显示分辨率取得点。<br>
GMMP_USE_DRIVER_pOINTS：用驱动器分辨率取得点。在Windows CE平台下，画笔驱动器的分辨率高于显示分辨率。这样，函数GetMouseMovePoints可被那些需要准确分辨率的应用程序使用。（如手写体识别软件或计算机辅助设计软件）。<br>
<h3>返回值</h3>如果函数调用成功，返回值是缓冲区里的点的数目。否则，函数返回C1。若想获得更多的错误信息，请调用GetlastError函数。函数GetLastError可能返回下面的错误代码。<br>
GMMF_ERR_POINT_NOT_FOUNQ由lPPt指定的点找不到或不再存在于系统缓冲区中。<br>
备注：系统至少保留着64个鼠标坐标及其时间标记。如果应用程序给GetMouseMovePoints提供了一个鼠标坐标，而该坐标存在于系统中的鼠标坐标历史记录中，则函数从历史坐标记录取得指定个数的坐标。也可以提供一个时间标记，用来区分历史记录中相同的点。<br>
函数GetMouseMonePoints将返回实际发送给调用线程和其他线程的点。<br>
<h3>速查</h3>Windows NT：5.0及以上版本；Windows：98及以上版本；Windows CE：2.0及以上版本；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

17
src/docs/win32api/1/GetNextWindow.html Normal file
View File

@ -0,0 +1,17 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回z序中的前一个或后一个窗口的句柄。下一窗口在指定窗口的下面，前一窗口则在上面。如果指定的窗口是顶端窗口，该函数返回下一个（或前一个）顶端窗口的句柄。如果指定的窗口是顶层窗口，函数返回下一个（或前一个）顶层窗口的句柄。如果函数是子窗口，则函数搜索下一个或前一个子窗口的句柄。<br>
<h3>函数原型</h3>HWND GetNextWindow（HWND hWnd，UNIT wCmd）；<br>
<h3>参数</h3>
hWnd：一个窗口的句柄。窗口句柄在wCmd参数的基础上获得的相对于这个窗口的句柄。<br>
wCmd:指明窗口返回的是前一窗口的句柄还是后一窗口的句柄。该参数可以是下列两个值之一：<br>
GW HWNONEXT：返回在给定窗口的下面窗口的句柄。<br>
GW_HWNDPREV：返回在给定窗口的上面窗口的句柄。<br>
<h3>返回值</h3>如果函数成功，返回值是前一窗口（或后一窗口）的句柄。如果前后窗口不存在，则返回值为NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：在设定了GW_HWNDNEXT或GW_GETPREV标志时，调用该函数与调用GetWindow函数相同。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本：Windows CE：不支持：头文件：Winuer.h;库文件：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/GetParent.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获得一个指定子窗口的父窗口句柄。<br>
<h3>函数原型</h3>HWND GetParent（HWND hWnd）；<br>
<h3>参数</h3>
hWnd:子窗口句柄，函数要获得该子窗口的父窗口句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为父窗口句柄。如果窗口无父窗口，则函数返回NULL。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：WindowsCE：Windows CE1.0版本不支持除了对话框之外的所属子窗口。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本：头文件：Winuser.h：库文件：user32.lib。<br>
</body>
</html>

26
src/docs/win32api/1/GetQueueStatus.html Normal file
View File

@ -0,0 +1,26 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回表示调用线程消息队列里的消息的类型的标志。<br>
<h3>函数原型</h3>DWORD GetQueueStatus（UINT flags）；<br>
<h3>参数</h3>
flags：表示消息类型的队列状态标志。此参数可为下列值的组合：<br>
QS_ALLEVENTS：输入，WM_TIMER， WM_PAINT，WM_HOTKEY或寄送的消息在队列里。<br>
QS_ALLINPUT：任何消息在队列里。<br>
QS_ALLPOSTMESSAGE：寄送的消息（而不是其他所列消息）在队列里。<br>
QS_HOTKEY：一条WM_HOTKEY消息在队列里。QS_INPUT：输入消息在队列里。<br>
QS_KEY：一条WM_KEYUP WM_KEYDOWN，WM_SYSKEYUP或WM_SYSKEYDOWN消息在队列里。<br>
QS_MOUSE：WM_MOUSEMOVE消息或鼠标键消息（WM_BUTTONUP WM_RBUTTONDOWN等）在消息队列里。<br>
QS_MOUSEBUTTON：鼠标键消息（WM_LBUTTONUP，WM_RBUTTONDOWN等）在消息队列里。<br>
QS_MOUSEMOVE：WM_MOUSEMOVE消息在消息队列里。<br>
QS_FAINT：WM_PAINT消息在消息队列里。<br>
QS_POSTMESSAGE：寄送的消息（而不是其他所列消息）在队列里。<br>
QS_SENDMESSAGE：由其他线程或应用程序发送的消息在消息队列里。<br>
QS_TIEMR：一条WM_TIEMR消息在消息队列里。<br>
<h3>返回值</h3>返回值的高位字表示队列里当前消息的类型。低位字表示上次调用GetQueuestatus，GetMessage或FeekMessBge以来加入队列并仍然在队列里的消息的类型。<br>
备注：QS_标志出现在返回值里并不保证以后调用函数GetMessage或PeekMessage会返回一个消息。GetMesssge和PeekMesssge执行某些内部过滤会导致消息被内部处理。因此，GetQueueStatus的返回值只能被看作是否调用GetMessage或PeekMessage的提示。<br>
QS_ALLPOSTMESSAGE和QS_POSTMESSAGE标志在被清除时不一样。QS_POSTMESSAGE在调用GetMessage或 PeekMessage时清除，无论是否过滤消息。QS_ALLPOSTMESSAGE在调用GetMessage或PeekMessage时清除，不过滤消息（wMsgFilterMin和wMsgFilterMax是零）。这对于多次调用PeeKMessage来获得不同范围的消息非常有用。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本：Windows CE：不支持；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

20
src/docs/win32api/1/GetScrollPos.html Normal file
View File

@ -0,0 +1,20 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获取指定滚动条中滚动按钮的当前位置。当前位置是一个根据当前滚动范围而定的相对值。例如，如果滚动范围是0到100之间，滚动按钮在中间位置，则其当前位置为50。该函数提供了向后兼容性，新的应用程序应使用GetScroiliofo函数。<br>
<h3>函数原型</h3>int GetScrogPos（HWND hWnd；int nBar）；<br>
<h3>参数</h3>
hWnd：根据参数nBar值，处理滚动条控制或带有标准滚动条窗体。<br>
nBar：指定滚动条将被检查。这个参数可以是下面值，含义如下：<br>
SB_CTL：找回滚动条控制中滚动翻页盒的位置。而参数hwnd必须是滚动条控制的句柄。<br>
SB_HORZ：找回窗体上标准水平滚动条中参数滚动翻页盒的位置。<br>
SB_VERT：找回窗体上标准垂直滚动条中参数滚动翻页盒的位置。<br>
<h3>返回值</h3>如果函数运行成功，其返回值是滚动翻页盒的当前位置；如果函数运行失败，其返回值是0。想若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：函数GetScrollPos可以使应用程序使用32位滚动位置。尽管消息WM_HSCROLL和WM_VSCROLL指出了滚动条位置，但却被限制为16位，而函数SetScrollPos，SetScrollRange，GetScrollPos，和 GetscrollRange都支持32位的滚动条数据。<br>
在WM_HSCROLL或WM_VSCROLL消息中通告SB_JHUMBTRACK时，为了得到滚动条32位的位置，请调用GetScrolllnfo函数。<br>
在WM_HSCROLL或WM_VSCROLL消息中通告SB_THUMBTRACK时，为了得到32位的滚动条，则调用函数GetScrolllnfo。<br>
<h3>速查</h3>Windows3.1、Windows 95以上，头文件：winuser.h；库文件：user32.lib<br>
</body>
</html>

21
src/docs/win32api/1/GetScrollRange.html Normal file
View File

@ -0,0 +1,21 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>获取指定滚动条中滚动按钮位置的当前最大最小值。<br>
<h3>函数原型</h3>BOOL GetscrollRange（HWND hWnd，int nBar，LPINT lpMinPos，LPINT InMaxPos）；<br>
<h3>参数</h3>
hWnd：滚动条控制或带标准滚动条窗体的句柄，由nBar参数值确定。<br>
nBar：定滚动条哪一个位置将被找回。这个参数可以是下面值，含义如下：<br>
SB_CTL：找回滚动条控制位置。而参数hWnd必须是滚动条控制的句柄。<br>
SB_HORZ：找回窗体上标准水平滚动条的位置。<br>
SB_VERT：找回窗体上标准垂直滚动条位置。<br>
lpMinPos：指向所找到最小位置整型变量。<br>
lpMaxPos：指向所找到最小位置整型变量。<br>
<h3>返回值</h3>如果函数运行成功，返回值为非零；如果函数运行失败，返回值为零。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：如果所指定的窗体没有标准的滚动条或者不是滚动条控制，那么GetscrollRange函数将复制0到参数lpMinPos和lpMaxPos中。<br>
标准滚动条的缺省范围值是从0到100之间，滚动条控制的缺省范围为空。<br>
说明滚动条位置的消息WM_HSCROLL和WM_VSCROLL均为16位的数据。但是，因为函数SetScrolllnfo，SetScrollPos，SetScrollRange；GetScrolllnfo，GetScrollPos，和GetScrollRange都支持32位的滚动条位置数据，所以有一个解决16位WM_HSCROLL和WM_VSCROLL消息阻碍的途径，请参见函数GetScrohnfo的有关技术说明。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winuserh；库文件：user32.lib。 <br>
</body>
</html>

25
src/docs/win32api/1/GetScrolllnfo.html Normal file
View File

@ -0,0 +1,25 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数找到滚动条的参数，包括滚动条位置的最小值、最大值，页面大小，滚动按钮的位置，
<h3>函数原型</h3>BOOL GetScrolllnfo（HWND hWnd，int fnBar，LPSCROLLINFO lpsi）；
<h3>参数</h3>
hWnd：滚动条控制或有标准滚动条的窗体句柄，由fnBar参数确定。
fnBar：指定待找回滚动条参数的类型，此参数可以为如下值，其值含义：
SB_CTL：找回滚动条控制参数。其中参数hwnd一定是处理滚动条控制的句柄。
SB_HORZ：找回所指定窗体的标准水平滚动条参数。
SB_VERT：找回所指定窗体的标准垂直滚动条参数。
lpsi：指向SCROLLINFO结构。在调用Getscrolllofo函数之前，设置SCROLLINFO结构中cbSize成员以标识结构大小，设置成员fMask以说明待找回的滚动条参数。在运行之前，函数复制结构中适当的成员所指定的参数。
成员fMask可以是如下值：
SIF_PAGE：复制滚动页码到由lpsi指向的SCROLLINFO结构的nPage成员中。
SIF_POS：复制滚动位置到由lpsi指向的SCROLLINFO结构的nPos成员中。
SIF_RANGE：复制滚动范围到由lpsi指向的SCROLLINFO结构的nMin和nMax成员中。
SIF_TRACKPOS：复制当前滚动盒跟踪位置到由nTrackPos指向的SCROLLINFO结构的nPage成员中。
<h3>返回值</h3>如果函数找到任何一个值，那么返回值为非零；如果函数没有找到任何值，那么返回值为零；
若要得到更多出错信息，请调用GetLastError函数。
注意：Getscrolllnfo函数尽管WM_HSCROLL和WM_VSCROLL指出了滚动条位置消息，却仅提供了16位数据，而函数SetScrollnfo和GetScrollnfo则提供了32位的滚动条数据。因而，当应用程序在处理WM_HSCROLL或 WM_VSCROLL时，要获得32位滚动条位置的数据时，则要调用Getscrolllnfo函数。
在WM_HSCROLL或WM_VSCROLL消息中SB_THUMBTRACK通告过程中，为了获得32位的滚动盒位置，需要调用GetScrolllnfo函数以得到结构SCROLLINFO成员fMask中的SCROLLINFO值。函数返回在结构SCROLLINFO成员nTrackPos中指出的滚动盒跟踪位置的值。这将允许当用户移动滚动盒时能得到其位置。
<h3>速查</h3>Windows NT3.51、Windows 95、Windows CE1.0以上，头文件：winuser.h；库文件：user32.lib。
</body>
</html>

7
src/docs/win32api/1/GetSysModalWindow.html Normal file
View File

@ -0,0 +1,7 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数已经过时，该函数只是为与16位版的窗口程序兼容而提供的。
</body>
</html>

14
src/docs/win32api/1/GetTopWindow.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数检查与特定父窗口相联的子窗口z序，并返回在z序顶部的子窗口的句柄。<br>
<h3>函数原型</h3>HWND GetTopWindow（HWND hWnd）；<br>
<h3>参数</h3>
hWnd:被查序的父窗口的句柄。如果该参数为NULL，函数返回Z序顶部的窗口句柄。<br>
返回值；如果函数成功，返回值为在Z序顶部的子窗口句柄。如果指定的窗口无子窗口，返回值为NULL。<br>
若想获得更多错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本：Windows CE：不支持；头文件：Winuser.h：库文件；user32.lib。<br>
</body>
</html>

22
src/docs/win32api/1/GetWindow.html Normal file
View File

@ -0,0 +1,22 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回与指定窗口有特定关系（如Z序或所有者）的窗口句柄。<br>
<h3>函数原型</h3>HWND GetWindow（HWND hWnd，UNIT nCmd）；<br>
<h3>参数</h3>
hWnd:窗口句柄。要获得的窗口句柄是依据nCmd参数值相对于这个窗口的句柄。<br>
nCmd:说明指定窗口与要获得句柄的窗口之间的关系。该参数值可以是下列之一：<br>
GW_CHILD：如果指定窗口是父窗口，则获得的是在Z序顶端的子窗口的句柄，否则为NULL。函数仅检查指定父窗口的子窗口，不检查继承窗口。<br>
GW_ENABLEDPOUP：（WindowsNT 5.0）返回的句柄标识了属于指定窗口的处于使能状态弹出式窗口（检索使用第一个由GW_HWNDNEXT 查找到的满足前述条件的窗口）；如果无使能窗口，则获得的句柄与指定窗口相同。<br>
GW_HWNDFIRST：返回的句柄标识了在Z序最高端的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在Z序最高端的最高端窗口；如果指定窗口是顶层窗口，则该句柄标识了在z序最高端的顶层窗口：如果指定窗口是子窗口，则句柄标识了在Z序最高端的同属窗口。<br>
GW_HWNDLAST:返回的句柄标识了在z序最低端的相同类型的窗口。如果指定窗口是最高端窗口，则该柄标识了在z序最低端的最高端窗口：如果指定窗口是顶层窗口，则该句柄标识了在z序最低端的顶层窗口；如果指定窗口是子窗口，则句柄标识了在Z序最低端的同属窗口。<br>
GW_HWNDNEXT：返回的句柄标识了在Z序中指定窗口下的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在指定窗口下的最高端窗口：如果指定窗口是顶层窗口，则该句柄标识了在指定窗口下的顶层窗口；如果指定窗口是子窗口，则句柄标识了在指定窗口下的同属窗口。<br>
GW HWNDPREV：返回的句柄标识了在Z序中指定窗口上的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在指定窗口上的最高端窗口；如果指定窗口是顶层窗口，则该句柄标识了在指定窗口上的顶层窗口；如果指定窗口是子窗口，则句柄标识了在指定窗口上的同属窗口。<br>
GW_OWNER：返回的句柄标识了指定窗口的所有者窗口（如果存在）。<br>
<h3>返回值</h3>如果函数成功，返回值为窗口句柄；如果与指定窗口有特定关系的窗口不存在，则返回值为NULL。<br>
若想获得更多错误信息，请调用GetLastError函数。<br>
备注：在循环体中调用函数EnumChildWindow比调用GetWindow函数可靠。调用GetWindow函数实现该任务的应用程序可能会陷入死循环或退回一个已被销毁的窗口句柄。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

17
src/docs/win32api/1/GetWindowPlacement.html Normal file
View File

@ -0,0 +1,17 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回指定窗口的显示状态以及被恢复的、最大化的和最小化的窗口位置。<br>
<h3>函数原型</h3>BOOL GetWindowPlacement（HWND hWnd，WINDOWPLACEMENT★lpwndpl);<br>
<h3>参数</h3>
hWnd: 窗日句柄。<br>
lpwndpl：指向WINDOWPLACEMENT结构的指针，该结构存贮显示状态和位置信息。<br>
在调用GetWindowPlacement函数之前，将WINDOWPLACEMENT结构的长度设为<br>
sizeof（WIDNOWPLACEMENT）。如果lpwndpl－＞length设置不正确则函数GetWindowPlacement将失败。<br>
返回值；如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetlastError函数。<br>
备注：由该函数获得的WINDOWPLACEMENT结构的flag单元总为0。如果hWnd的窗口被最大化，则showCmd元为SHOWMZAXMIZED，如果窗口被最小化，则showCmd元为SHOWMINIMIZED，除此之外为SHOWNORMN，WINDOWPLACEMENT长度单元必须置为sizeOf（ WINDOWPLACEMENT），如果参数设置不正确，函数返回FALSE。查看设置窗口位置坐标的正确信息，参看WINDOWPLACEMENT。<br>
<h3>速查</h3>Windows Nt：3.1以上版本：Windows：95以上版本；Windows CE：不支持；头文件：Winuser.h；库文件：User32.lib。<br>
</body>
</html>

15
src/docs/win32api/1/GetWindowRect.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。<br>
<h3>函数原型</h3>BOOL GetWindowRect（HWND hWnd，LPRECTlpRect）；<br>
<h3>参数</h3>
hWnd:窗口句柄。<br>
lpRect：指向一个RECT结构的指针，该结构接收窗口的左上角和右下角的屏幕坐标。<br>
<h3>返回值</h3>如果函数成功，返回值为非零：如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本；Windows CE：1.0以上版本；头文件：Winuser.h；库文件：User32.lib。<br>
</body>
</html>

7
src/docs/win32api/1/GetWindowTask.html Normal file
View File

@ -0,0 +1,7 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数已经过时，该函数只是为与16位版的窗口程序兼容而提供的。基于32位的应用程序应该使用GetWindowThreadProcessld函数。
</body>
</html>

16
src/docs/win32api/1/GetWindowText.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将指定窗口的标题条文本（如果存在）拷贝到一个缓存区内。如果指定的窗口是一个控制，则拷贝控制的文本。但是，GetWindowTeXt不能接收在其他应用程序中的控制文本。<br>
<h3>函数原型</h3>Int GetWindowText（HWND hWnd，LPTSTR lpString，Int nMaxCount）；<br>
<h3>参数</h3>
hWnd:带文本的窗口或控制的句柄。<br>
IpString：指向接收文本的缓冲区的指针。<br>
nMaxCount:指定要保存在缓冲区内的字符的最大个数，其中包含NULL字符。如果文本超过界限，它就被截断。<br>
<h3>返回值</h3>如果函数成功，返回值是拷贝的字符串的字符个数，不包括中断的空字符；如果窗口无标题栏或文本，或标题栏为空，或窗口或控制的句柄无效，则返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
函数不能返回在其他应用程序中的编辑控制的文本。<br>
备注：如果目标窗口属于当前进程，GetWindowText函数给指定的窗口或控制发送WM_GETTEXT消息。如果目标窗口属于其他进程，并且有一个窗口标题，则GetWindowTeXt返回窗口的标题文本，如果窗口无标题，则函数返回空字符串。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本：Windows CE：1.0以上版本；头文件：Winuser.h;库文件：user32.lib：Unicode:在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

16
src/docs/win32api/1/GetWindowTextLength.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回指定窗口的标题文本（如果存在）的字符长度。如果指定窗口是一个控制，函数将返回控制内文本的长度。但是GetWindowTextLength函数不能返回在其他应用程序中的控制的文本长度。<br>
<h3>函数原型</h3>nit GetWindowTextLent（HWND hWnd）；<br>
<h3>参数</h3>
hWnd：窗口或控制的句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为文本的字符长度。在一定的条件下，返回值可能比实际的文本长度大。请参看说明。如果窗口无文本，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：如果目标窗口属于当前进程，GetWindowTextLength函数给指定的窗口或控制发送WM_GETTEXT消息。<br>
在一定的条件下，函数GetWindowTextLength的返回值可能比实际的文本长度大。这是由于ANSI和Unlcode的混和使用以及系统允许DBCS字符在文本内存在的原因，但是函数返回值要至少与文本的实际长度相等，因此可以利用这一点指导缓存区的分配。在应用程序既使用ANSI函数又使用Unicode的普通对话框时就会有缓存分配的问题；同样，当应用程序在一个Unicode的窗口过程中使用了ANSI的GetWindowTextLength函数，或在一个ANSI的窗口过程中使用了Unicode的GetWindowTextLength函数的时候也有缓存分配的问题。查看ANSI和Vnicode函数，参考Wind32函数prototypes。<br>
要获得文本的实际长度，使用WM_GETTEXT, LB_GETTEXT或CB_GETLBTBTEXT消息或GetWindowText函数。<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本：Windows CE：1.0以上版本；头文件：Winuser.h；库文件：user32.lib;Unicode：在Windows NT上实现为山Unicode和ANSI两种版本。<br>
</body>
</html>

13
src/docs/win32api/1/GetWlndowThreadprocessld.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数返回创建指定窗口线程的标识和创建窗口的进程的标识符，后一项是可选的。<br>
函数原型；DWORD GetWindowThreadProcessld（HWND hwnd，LPDWORD lpdwProcessld）；<br>
<h3>参数</h3>
hWnd:窗口句柄。<br>
lpdwProcessld:接收进程标识的32位值的地址。如果这个参数不为NULL，GetWindwThreadProcessld将进程标识拷贝到这个32位值中，否则不拷贝。<br>
<h3>返回值</h3>返回值为创建窗口的线程标识。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件；user32.lib。<br>
</body>
</html>

11
src/docs/win32api/1/GetlnputState.html Normal file
View File

@ -0,0 +1,11 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定在调用线程的消息队列里，是否有鼠标键或键盘消息。<br>
<h3>函数原型</h3>BOOL GetlnputState（VOID）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>如果队列里含有一个或多个新的鼠标键或键盘消息，返回非零值。如果队列里没有新的鼠标键或键盘消息，返回值是零。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib。<br>
</body>
</html>

11
src/docs/win32api/1/InSendMessage.html Normal file
View File

@ -0,0 +1,11 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数决定当前窗口程序是否处理另一个线程调用SendMesssge（在相同进程或不同进程）发送来的消息。<br>
<h3>函数原型</h3>BOOL InsendMessage（VOID）；<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>如果窗口程序处理另一个线程调用SendMessage发送来的消息，返回非零值。如果窗口程序不处理另一个线程调用SendMessage发送来的消息，返回值是零。<br>
<h3>速查</h3>Windows NT：3.1及以上版本：Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h输入库：user32.Iib。<br>
</body>
</html>

16
src/docs/win32api/1/InSendMessageEx.html Normal file
View File

@ -0,0 +1,16 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>函数决定当前窗口程序是否处理另一个线程调用SendMessage（在相同进程或不同进程）发送来的消息。此函数与InsendMesssge相似，但另外提供了如何发送消息的信息。<br>
<h3>函数原型</h3>DWORD InsendMessageEx（LPVOID IpReserved）；<br>
<h3>参数</h3>
IpReserved：保留值，必须为NULL。<br>
<h3>返回值</h3>如果消息没被发送，返回值是ISMEX_NOSEND。否则，返回值是一个或多个下列值：<br>
ISMEX_CALLBACK：消息是用函数SendMesssgeCallback发送的。发送此消息的线程没被阻塞。<br>
ISMEX_NOTIFY：消息是用函数SendNotifyMessags发送的。发送此消息的线程没被阻塞。<br>
ISMEX_REPLIED：窗口程序处理了消息。发送此消息的线程不再被阻塞。<br>
ISMEX_SEND：消息是用函数SendMessage或SendMessageTimeout发送的。如果ISMEX_REPLIED没设置，发送此消息的线程被阻塞。<br>
<h3>速查</h3>Wihdows NT：5.0及以上版本：Windows：98及以上版本；Wihdows CE：不支持：头文件：winuser.h；输入库：user32.Iib。<br>
</body>
</html>

13
src/docs/win32api/1/IsChild.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数测试一个窗口是否是指定父窗口的子窗口或后代窗口。如果该父窗口是在父窗口的链表上则子窗口是指定父窗口的直接后代。父窗口链表从原始层叠窗口或弹出窗口一直连到该子窗口。<br>
<h3>函数原型</h3>BOOL IsChild（HWND hWndParant，HWND hWnd）；<br>
<h3>参数</h3>
hWndparant:父窗口句柄。<br>
hWnd：将被测试的窗口句柄。<br>
<h3>返回值</h3>如果窗口是指定窗口的子窗口或后代窗口，则退回值为非零。如果窗口不是指定窗口的子窗口或后代窗口，则退回值为零。<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.Iib。<br>
</body>
</html>

14
src/docs/win32api/1/IsIconic.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定给定窗口是否是最小化（图标化）的窗口。<br>
<h3>函数原型</h3>BOOL IsIconic（HWND hWnd）；<br>
<h3>参数</h3>
hWnd：被测试窗口的句柄。<br>
<h3>返回值</h3>如果窗口已图标化，返回值为非零；如果窗口未图标化，返回值为零。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：不支持；头文件：winuser.h；<br>
库文件：user32.Iib。<br>
</body>
</html>

12
src/docs/win32api/1/IsWindow.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定给定的窗口句柄是否识别一个已存在的窗口。<br>
因数原型：BOOL isWindow（HWND hWnd）；<br>
<h3>参数</h3>
hWnd:被测试窗口的句柄。<br>
<h3>返回值</h3>如果窗口句柄标识了一个已存在的窗口，返回值为非零；如果窗口句柄未标识一个已存在窗口，返回值为零。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuserhs；库文件：User32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/IsWindowUnicode.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定指定的窗口是否是一个本地Unicode窗口。<br>
<h3>函数原型</h3> BOOL lswindowUnicode（HWND hwndJ；<br>
<h3>参数</h3>
hWnd:被测试窗口的句柄。<br>
<h3>返回值</h3>如果窗口是一个本地Unicode窗口，返回值为非零；如果窗口不是一个本地Unicode窗口，返回值为零，同时说明窗口是一个ANSI窗口。<br>
备注；一个窗口的字符集是由函数RegosterClass决定的。如果窗口类是以ANSI版的RegisterClass （ RegjsterClassA）注册的，则窗口字符集是ANSI的；如果窗口类是以Unicode版的Registerclass（ RegisterClassW）注册的，则窗口字符集是Unicode。<br>
系统为窗口消息自动作Unicode和ANSI的双向翻译。例如，如果一个使用Unicode字符集的窗口测到一个ANSI窗口消息，则系统在调用窗口过程之前先将该消息转换为Unicode消息。系统调用lsWindowUnicode函数决定是否翻译消息。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows： 95以上版本；Windows CE：不支持；头文件：Winuser.h；库文件：user32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/IsWindowVlslble.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数获得给定窗口的可视状态。；<br>
<h3>函数原型</h3>BOOL IsWindowVisible（HWND hWnd）；<br>
参数；<br>
hWnd：被测试窗口的句柄。<br>
<h3>返回值</h3>如果指定的窗口及其父窗口具有WS_VISIBLE风格，返回值为非零；如果指定的窗口及其父窗口不具有WS_VISIBLE风格，返回值为零。由于返回值表明了窗口是否具有Ws_VISIBLE风格，因此，即使该窗口被其他窗口遮盖，函数返回值也为非零。<br>
备注：窗口的可视状态由WS_VISIBLE位指示。当设置了WS_VISIBLE位，窗口就可显示，而且只要窗口具有WS_VISIBLE风格，任何画在窗口的信息都将被显示。<br>
<h3>速查</h3>Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h;库文件：user32.lib。<br>
</body>
</html>

12
src/docs/win32api/1/IsZoomed.html Normal file
View File

@ -0,0 +1,12 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数确定窗口是否是最大化的窗口。<br>
<h3>函数原型</h3>BOOL IsZoomed（HWND hWnd）；<br>
<h3>参数</h3>
hWnd:被测试窗口的句柄。<br>
<h3>返回值</h3>如果窗口己最大化，则返回值为非零；如果窗口未最大化，则返回值为零。<br>
<h3>速查</h3>Windows NT:3.1以上版本；Windows：95以上版本；Windows CE：不支持；头文件：Winuer.h;库文件：User32.Iib。<br>
</body>
</html>

39
src/docs/win32api/1/LoadImage.html Normal file
View File

@ -0,0 +1,39 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数装载目标，光标，或位图。<br>
<h3>函数原型</h3>HANDLE LoadImage（NINSTANCE hinst，LPCTSTR lpszName，UINT uType，int cxDesired，int CyDesired，UINT fuLoad）；<br>
<h3>参数</h3>
hinst：处理包含被装载图像模块的特例。若要装载OEM图像，则设此参数值为O。<br>
lpszName：处理图像装载。如果参数hinst为非空，而且参数fuLoad不包括LR_LOADFROMFILE的值时，那么参数lpszName是一个指向保留在hinst模块中装载的图像资源名称，并以NULL为结束符的字符串。<br>
如果参数hinst为空，并且LR_LOADFROMFILE被指定，那么这个参数低位字一定是被装载的OEM图像标识的。OEM图像标识符是在WINUSER.H头文件中定义的，下面列举出前缀的含义：<br>
OBM_ OEM：位图；OIC_OEM图标；OCR_OEM：光标。<br>
如果参数fuLoad包含LR_LOADFROMFILE值，那么参数lpszName是包含有图像的文件名。<br>
uType：指定被装载图像类型。此参数可以为下列值，其含义如下：<br>
IMAGE_BITMAP：装载位图；IMAGE_CURSOR：装载光标；IMAGE_ICON：装载图标。<br>
cxDesired：指定图标或光标的宽度，以像素为单位。如果此参数为零并且参数fuLoad值为LR_DEFAULTSIZE，那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定宽度；如果此参数为零并且值LR_DEFAULTSIZE没有被使用，那么函数使用目前的资源宽度。<br>
cyDesired：指定图标或光标的高度，以像素为单位。如果此参数为零并且参数fuLoad值为LR_DEFAULTSIZE，那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定高度；如果此参数为零并且值LR_DEFAULTSIZE没有被使用，那么函数使用目前的资源高度。<br>
fuLoad：根据下面复合值列表指定函数值，值含义如下：<br>
LR_DEFAULTCOLOR：缺省标志；它不作任何事情。它的含义是“无LR_MONOCHROME”。<br>
LR_CREATEDIBSECTION：当参数uType指定为IMAGE_BITMAP时，使得函数返回一个DIB部分位图，而不是一个兼容的位图。这个标志在装载一个位图，而不是映射它的颜色到显示设备时非常有用。<br>
LRDIFAULTSIZE：若 cxDesired或cyDesired未被设为零，使用系统指定的公制值标识光标或图标的宽和高。如果这个参数不被设置且cxDesired或cyDesired被设为零，函数使用实际资源尺寸。如果资源包含多个图像，则使用第一个图像的大小。<br>
LR_LOADFROMFILE：根据参数lpszName的值装载图像。若标记未被给定，lpszName的值为资源名称。<br>
LW_LOADMAP3DCOLORS：查找图像的颜色表并且按下面相应的3D颜色表的灰度进行替换。<br>
颜色替代：Dk Gray RGB（128，128，128）COLOR_3DSHADOW；Gray RGB（192，192，192）COLOR_3DFACELt Gray RGB（223，223，223） COLOR_3DLIGHT LR_LOADTRANSPARENT；找到图像中的一个像素颜色值并且根据颜色表中系统的缺省颜色值替代其相应接口的值。图像中所有使用这种接口的像素的颜色都变为系统的缺省窗体颜色。此至仅用来申请相应的颜色表。<br>
若fuLoad包括LR_LOADTRANSPARENT和LR_LOADMAP3DCOLORS两个值，则LRLOADTRANSPARENT优先。但是，颜色表接口由COLOR_3DFACE替代，而不是COLOR_WINDOW。<br>
LR_MONOCHROME：装载黑白图。<br>
LR_SHARED：若图像将被多次装载则共享。如果LR_SHARED未被设置，则再向同一个资源第二次调用这个图像是就会再装载以便这个图像且返回不同的句柄。<br>
不要对不同标准尺寸的图像使用LR_SHARED，装载后可能会有改变，或是从文件中被装载。<br>
Windows 95和Windows 98：函数根据缓存中被请求的资源名发现的第一个图像，不管被请求的大小。LR_VGACOLOR：使用VGA真彩色。<br>
<h3>返回值</h3>如果函数运行成功，返回值是相关资源的数据的句柄。如果函数运行失败，返回值为NULL。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：当使用完资源后，必须通过调用函数以释放加速器表、位图、光标、图标以及菜单所占的内存资源；加速器表：DesteoyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；图标：Destroylcon；菜单：DestroyMenu<br>
当过程创建终止时，系统将自动删除这些资源。但是调用相关函数也可以保留内存减少过程的工作设置所占空间。<br>
Windows CE：对IMAGE_BITMAP来说，参数cxDesred和cyDesred p必须为零。Windows CE不支持图表跳跃或闪烁。<br>
参数fuLoad必须为（=LR_DEFAULTCOLOR）。<br>
如果的目标平台不支持鼠标光标，可以指定在参数cxDesred和cyDsired的SM_CXCURSOR和SM_CYCURSOR的值，但不能指定参数uType中IMAGE_CURSOR的值。<br>
如果目标平台支持鼠标光标，可以指定在参数cxDesired和cyDesred的SM_CXCURSOR和SM_CYCURSOR的值，也能指定参数uType中IMAGE_CURSOR的值。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95、Windows CE 1.0以上，头文件：minuser.h：库文件；user32.lib；Unicode：在Windows NT上实现为Unicode和ANSI两种版本。<br>
</body>
</html>

18
src/docs/win32api/1/LoadResource.html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数装载指定资源到全局存储器。<br>
函数原型； HGLOSAL LoadResouare（HMODULE hModule，HRSRC hReslnfo）；<br>
<h3>参数</h3>
hModule：处理包合资源的可执行文件的模块句柄。若hModule为NULL，系统从当前过程中的模块中装载资源。<br>
hReslnfo：将被装载资源的句柄。它必须由函数FirtdResource或FindResourceEx创建。<br>
<h3>返回值</h3>如果函数运行成功，返回值是相关资源的数据的句柄。如果函数运行失败，返回值为NULL。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：LoadResource的返回类型是向后兼容的HGLOBAL型，而不是因为函数返回一个全局存储块句柄。不要传递这个句柄给函数GlobalLock或GlobalFree。为了得到更多资源数据信息，请调用LockResource函数。<br>
当使用完资源后，必须通过调用函数以释放加速器表、位图、光标、图标以及菜单所占的内存资源：加速器表：DestroyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；图标：Destroylcon；菜单：DestroyMenu。<br>
当过程创建终止时，系统将自动删除这些资源。但是调用相关函数也可以保留内存减少过程的工作设置所占空间。<br>
Windows CE：参数hModule必须为非空。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95、Windows CE1.0以上，头文件：winbase.h；库文件：kernel132.lib。<br>
</body>
</html>

15
src/docs/win32api/1/LockResource.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数锁定内存中的指定资源。<br>
<h3>函数原型</h3>LPVOID LOCkResource（HGLOBAL hResDate）；<br>
<h3>参数</h3>
hResDate：被装载的资源的句柄。函数LosdResource可以返回这个句柄。<br>
<h3>返回值</h3>如果被装载的资源被所住了，返回值是资源第一个字节的指针；否则为NULL。<br>
注意：通过使用函数FindResource或FindResourceEx返回句柄试图所住资源，不再工作。可以返回一个错误的数据和任意数据的指针。<br>
当使用完资源后，必须通过调用函数以释放加速器表、位图、光标、目标以及某单所占的内存资源：加速器表：DestroyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；图标：Destroylcon；菜单：DestroyMenu。<br>
当过程创建终止时，系统将自动删除这些资源。但是调用相关函数也可以保留内存减少过程的工作设置所占空间。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95、Windows CE 1.0以上，头文件：winbase.h；库文件：kerne132.lib。<br>
</body>
</html>

19
src/docs/win32api/1/MoveWindow.html Normal file
View File

@ -0,0 +1,19 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数改变指定窗口的位置和尺寸。对于顶层窗口，位置和尺寸是相对于屏幕的左上角的：对于子窗口，位置和尺寸是相对于父窗口客户区的左上角坐标的。<br>
<h3>函数原型</h3>BOOL MoveWindow（HWND hWnd.int x.int y,int nWidth,int nHeight,BOOL BRePaint）；<br>
<h3>参数</h3>
hWnd：窗口句柄。<br>
x：指定窗口的新位置的左边界。<br>
Y：指定窗口的新位置的顶部边界。<br>
nWidth：指定窗口的新的宽度。<br>
nHaight：指定窗口的新的高度。<br>
bRepaint:确定窗口是否被刷新。如果该参数为TRUE，窗口接收一个WM_PAINT消息；如果参数为FALSE，不发生任何刷新动作。它适用于客户区，非客户区（包括标题栏和滚动条），及由于移动子窗口而露出的父窗口的区域。如果参数为FALSE，应用程序就必须明确地使窗口无效或重画该窗口和需要刷新的父窗口。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：如果bRepaint为TRUE，系统在窗口移动后立即给窗口过程发送WM_PAINT消息（即由MoveWindow函数调用UPdateWindow函数）。如果bRepaint 为FALSE，系统将WM_PAINT消息放在该窗口的消息队列中。消息循环只有在派遣完消息队列中的其他消息时才派遣WM_PAINT消息。<br>
MoveWindow给窗口发送WM_WfNOWPOSCHANGING，WM_WINDOWPOSCHANGED，WM_MOVE，WM_SIZE和WM_NCCALCSIZE消息，<br>
<h3>速查</h3>Windows NT：3.1以上版本：Windows：95以上版本；Windows CE：1.0以上版本：头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

13
src/docs/win32api/1/Openlcon.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将一个最小化窗口恢复到原来的位置和尺寸并且激活该窗口。<br>
<h3>函数原型</h3>BOOL Openlcon（HWNDhWnd）；<br>
<h3>参数</h3>
hWnd:被恢复与激活的窗口的句柄。<br>
<h3>返回值</h3>如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。<br>
备注：Openlcon向给出的窗口发送WM_QUERYOPEN消息。<br>
<h3>速查</h3>Windows NT:3.1以上版本；Windows:95以上版本；Windows CE：不支持：头文件：winuser.h;库文件：user32.lib。<br>
</body>
</html>

29
src/docs/win32api/1/PeekMessage.html Normal file
View File

@ -0,0 +1,29 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数为一个消息检查线程消息队列，并将该消息（如果存在）放于指定的结构。<br>
<h3>函数原型</h3>BOOL PeekMessage（LPMSG IpMsg，HWND hWnd，UINT wMSGfilterMin，UINT wMsgFilterMax，UINT wRemoveMsg）；<br>
<h3>参数</h3>
lpMsg：接收消息信息的MSG结构指针。<br>
hWnd：其消息被检查的窗口的句柄。<br>
wMsgFilterMin：指定被检查的消息范围里的第一个消息。<br>
wMsgFilterMax：指定被检查的消息范围里的最后一个消息。<br>
wRemoveMsg：确定消息如何被处理。此参数可取下列值之一：<br>
PM_NOREMOVE：PeekMessage处理后，消息不从队列里除掉。<br>
PM_REMOVE：PeekMessage处理后，消息从队列里除掉。<br>
可将PM_NOYIELD随意组合到PM_NOREMOVE或PM_REMOVE。此标志使系统不释放等待调用程序空闲的线程。<br>
缺省地，处理所有类型的消息。若只处理某些消息，指定一个或多个下列值：<br>
PM_QS_INPUT：Windows NT5.0和Windows 98：处理鼠标和键盘消息。<br>
PM_QS_PAINT：Windows NT 5.0和Windows 98：处理画图消息。<br>
PM_QS_POSTMESSAGE：Windows NT 5.0和Windows 98：处理所有被寄送的消息，包括计时器和热键。<br>
PM_QS_SENDMESSAGE：Windows NT 5.0和Windows 98：处理所有发送消息。<br>
<h3>返回值</h3>如果消息可得到，返回非零值；如果没有消息可得到，返回值是零。<br>
备注：和函数GetMessage不一样的是，函数PeekMesssge在返回前不等待消息被放到队列里。<br>
PeekMesssge只得到那些与参数hWnd标识的窗口相联系的消息或被lsChild确定为其子窗口相联系的消息，并且该消息要在由参数wMsgFiterMin和wMsgFiherMax确定的范围内。如果hWnd为NULL，则PeekMessage接收属于当前调用线程的窗口的消息（PeekMessage不接收属于其他线程的窗口的消息）。如果hWnd为C1，PeekMessage只返回hWnd值为NULL的消息，该消息由函数PostThreadMessage寄送。如果wMsgFilterMin和wMsgFilterMax都为零，GetMessage返回所有可得的消息（即，无范围过滤）。<br>
常数WM_KEYFIRST和WMKEYLAST可作为过滤值取得所有键盘消息；常数WM_MOUSEFIRST和WM_MOUSELAST可用来接收所有的鼠标消息。<br>
PeekMessage通常不从队列里清除WM_PANT消息。该消息将保留在队列里直到处理完毕。但如果WM_PAINT消息有一个空更新区，PeekMessage将从队列里清除WM_PAINT消息。<br>
Windows CE：有一个NULL更新区的WM_PAINT消息不从队列里清除。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Wihdows：95及以上版本：Windows CE：1.0及以上版本；头文件：winuser.h输入库：user32.lib：Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

7
src/docs/win32api/1/PostAppMessage.html Normal file
View File

@ -0,0 +1,7 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数已过时。提供此函数只是为了与Windows的16位版本兼容。基于Win32的应用程序应该使用函数PostThreadMessage。
</body>
</html>

19
src/docs/win32api/1/PostMessage.html Normal file
View File

@ -0,0 +1,19 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将一个消息放入（寄送）到与指定窗口创建的线程相联系消息队列里，不等待线程处理消息就返回。消息队列里的消息通过调用GetMessage和PeekMessage取得。<br>
<h3>函数原型</h3>B00L PostMessage（HWND hWnd，UINT Msg，WPARAM wParam，LPARAM lParam）；<br>
参数<br>
hWnd：其窗口程序接收消息的窗口的句柄。可取有特定含义的两个值：<br>
HWND.BROADCAST：消息被寄送到系统的所有顶层窗口，包括无效或不可见的非自身拥有的窗口、被覆盖的窗口和弹出式窗口。消息不被寄送到子窗口。<br>
NULL：此函数的操作和调用参数dwThread设置为当前线程的标识符PostThreadMessage函数一样。<br>
Msg：指定被寄送的消息。<br>
wParam：指定附加的消息特定的信息。<br>
IParam：指定附加的消息特定的信息。<br>
<h3>返回值</h3>如果函数调用成功，返回非零值：如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。<br>
备注：需要以 HWND_BROADCAST方式通信的应用程序应当用函数 RegisterwindwosMessage来获得应用程序间通信的独特的消息。<br>
如果发送一个低于WM_USER范围的消息给异步消息函数（PostMessage.SendNotifyMessage，SendMesssgeCallback），消息参数不能包含指针。否则，操作将会失败。函数将再接收线程处理消息之前返回，发送者将在内存被使用之前释放。<br>
<h3>速查</h3>Windows NT： 3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

14
src/docs/win32api/1/PostQuitMessage.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数向系统表明有个线程有终止请求。通常用来响应WM_DESTROY消息。<br>
<h3>函数原型</h3>VOID PostQuitMessage（int nExitCode）；<br>
<h3>参数</h3>
pExitCode：指定应用程序退出代码。此值被用作消息WM_QUIT的wParam参数。<br>
<h3>返回值</h3>无。<br>
备注：PostQuitMessage寄送一个WM_oUT消息给线程的消息队列并立即返回；此函数向系统表明有个线程请求在随后的某一时间终止。<br>
当线程从消息队列里取得WM_QUIT消息时，应当退出消息循环并将控制返回给系统。返回给系统的退出值必须是消息WM_QUIT的wParam参数。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32，lib：Uhicode：在Wihdows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

21
src/docs/win32api/1/PostThreadMessage.html Normal file
View File

@ -0,0 +1,21 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将一个消息放入（寄送）到指定线程的消息队列里，不等待线程处理消息就返回。<br>
<h3>函数原型</h3>BOOL PostThreadMessage（DWORD idThread，UINT Msg，WPARAM wParam，LPARAM IParam）；<br>
参数<br>
idThread：其消息将被寄送的线程的线程标识符。如果线程没有消息队列，此函数将失败。当线程第一次调用一个Win 32 USER或GDI函数时，系统创建线程的消息队列。要得到更多的信息，参见备注。<br>
Msg：指定将被寄送的消息的类型。<br>
wParam：指定附加的消息特定信息。<br>
IParam：指定附加的消息特定信息。<br>
<h3>返回值</h3>如果函数调用成功，返回非零值。如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。如果idThread不是一个有效的线程标识符或由idThread确定的线程没有消息队<br>
列，GetLastError返回ERROR_INVALID_THREAD。<br>
备注：消息将寄送到的线程必须创建消息队列，否则调用PostThreadMessage会失败。用下列方法之一来处理这种情况：<br>
调用PostThreadMessage。如果失败，调用Sleep，再调用PostThreadMessage，反复执行，直到PostThreadMessage成功。<br>
创建一个事件对象，再创建线程。在调用PostThreadMessage之前，用函数WaitForSingleObject来等特事件被设置为被告知状态。消息将寄送到的线程调用PeedMessage（￡msg，NULL，WM_USER，WM_USER，PM_NOREMOVE）来强制系统创建消息队列。设置事件，表示线程已准备好接收寄送的消息。<br>
消息将寄送到的线程通过调用GetMesssge或PeekMesssge来取得消息。返回的MSG结构中的hwnd成员为NULL。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

15
src/docs/win32api/1/RegisterWindowsMessage.html Normal file
View File

@ -0,0 +1,15 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数定义一个新的窗口消息，该消息确保在系统中是唯一的。返回的消息值可在调用函数SendMessage或PostMessage时使用。<br>
<h3>函数原型</h3>UINT RegisterWindowsMessage（LPCTSTR lpString）；<br>
<h3>参数</h3>
lpString：指定将被注册的消息的以‘\O’结束的字符串指针。<br>
返回值:如果消息被成功注册，返回值是在范围OxCOOO到OxFFFF的消息标识符；如果函数调用失败，返回值是零。要得到更多的错误信息，调用函数GetLastError。<br>
备注：RegisterWindowMessage通常为合作应用程序间的通信注册消息。<br>
如果不同的应用程序注册同样的消息字符串，应用程序返回同样的消息值。消息保持注册，直到会话完成。<br>
当一个以上的应用程序必须处理同一个消息时，必须使用RegisterWindowMessage。要在窗口类里发送私有消息，应用程序可以使用UM_USER到OX7FFF范围内的任意整数。（在此范围的消息对窗口类私有，而不是对应用程序私有。如，预定义的控制类如BUTTON， EDIT LISTBOX和COMBOBOX可用此范围的值。）<br>
<h3>速查</h3>Windows NT： 3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

13
src/docs/win32api/1/ReleaseCapture.html Normal file
View File

@ -0,0 +1,13 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数从当前线程中的窗口释放鼠标捕获，并恢复通常的鼠标输入处理。捕获鼠标的窗口接收所有的鼠标输入（无论光标的位置在哪里），除非点击鼠标键时，光标热点在另一个线程的窗口中。<br>
<h3>函数原型</h3>BOOL ReleaseCapture（VOlD）<br>
<h3>参数</h3>无。<br>
<h3>返回值</h3>如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetlastError函数。<br>
备注：应用程序在调用函数SetCaPture之后调用此函数。<br>
Windows 95：调用ReleaseCapture会引起失去鼠标捕获的窗日接收一个WM_CAPTURECHANGED消息。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本：Windows CE：1.0及以上版本；头文件：winuser.h；输入库：User32.lib。<br>
</body>
</html>

14
src/docs/win32api/1/ReplyMessage.html Normal file
View File

@ -0,0 +1,14 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数用于应答由函数SendMessage发送的消息，不返回控制给调用SendMessage的函数。<br>
<h3>函数原型</h3>BOOLReplyMessage（LRESULTIResult）；<br>
<h3>参数</h3>
IResult：指定消息处理的结果。可能的值由所发送的消息确定。<br>
<h3>返回值</h3>如果调用线程正处理从其他线程或进程发送的消息，返回非零值。如果调用线程不是正处理从其他线程或进程发送的消息，返回值是零。<br>
备注：调用此函数，接收消息的窗口程序允许调用SendMessage的线程继续运行，尽管接收消息的线程已返回控制。调用ReplyMessage的线程也继续运行。<br>
如果消息不是通过SendMessage发送的，或者消息由同一个线程发送，ReplyMessage不起作用。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本：Windows CE：不支持：头文件：winuser.h；输入库，user32.lib。<br>
</body>
</html>

21
src/docs/win32api/1/ScrollDC.html Normal file
View File

@ -0,0 +1,21 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数水平和垂直滚动一个位矩形。<br>
<h3>函数原型</h3>BOOL ScrollDC（HDC hDC，int dx，int dy，CONST RECT ·IprcScroll，CONST★lprcClip，HRGN hrgnUpdateLPRECT IprcUpdate）；<br>
<h3>参数</h3>
hDC：含有要滚动位数的设备描述表句柄。<br>
dx：在设备单元中，指定水平滚动数量。在向左滚动时此参数必须为负。<br>
dy：在设备单元中，指定垂直滚动数量。在向上滚动时此参数必须为负。<br>
lprcScroll：指向包含与滚动矩形的同等之物的RECT结构。<br>
lprcClip：指向包含类似于剪下矩形之物的RECT结构。只有在剪辑矩形内部的图案才受影响。<br>
hrgnUpdate：处理滚动过程中位覆盖的区域。ScrollDC定义这个区域，它不一定是一个矩形。<br>
lprcUpdate：指向RECT结构，它接收到类似于被限制滚动更新区域矩形之物。这是所需求重画的最大的矩形区域。当函数返回时，不管指定设备内容映射的模式如何，结构中的值将在客户端对应结构中。<br>
<h3>返回值</h3>如果函数运行成功，返回值为非零；如果函数运行失败，返回值为零。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：如果参数lprcUpdate为空，系统将不再计算更新矩形。如果参数hrgnUpdate和IprcUpdate均为空，系统将不再计算更新区域。如果参数hrgnUpdate不为空，系统将好像拥有包含一个有效的未被滚动过程覆盖区域旬柄（由ScrollDC定义滚动过程）。当必须滚动窗体的整个客户区域，使用ScrollWindowEx函数。<br>
Windows CE：参数dx和dy中只有一个可以为非零。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95、windows CE1.0对以上，头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

21
src/docs/win32api/1/ScrollWindow.html Normal file
View File

@ -0,0 +1,21 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数滚动所指定的窗体客户区域内容。函数提供了向后兼容性，新的应用程序应使用ScrollWindowEX。<br>
<h3>函数原型</h3>BOOL ScrollWindow（HWND hWnd，int XAmount，int YAmount，CONST RECT★IpRect， CONST RECT★lpClipRect）；<br>
<h3>参数</h3>
hWnd：客户区域将被滚动的窗体句柄。<br>
XAmount：指定水平滚动以设备为单位的数量。如果窗体被滚动模式为CS_OWNDC或CS_CLASSDC，此参数则使用逻辑单位而不使用设备单位。当向左滚动窗体内容时，参数值必须为负。<br>
YAmount：指定垂直滚动设备单位数量。如果窗体被滚动模式为CS_OWNDC或CS_CLASSDC，此参数则使用逻辑单位而不使用设备单位。当向上滚动窗体内容时，参数值必须为负。<br>
lpRect：指向所指定将被滚动的客户区域部分的RECT结构。若此参数为NULL，则整个客户区域均被滚动。<br>
lpClipRect：指向包含类似于剪辑滚动条RECT结构。只有剪辑矩形条内部的位受影响。由外向内的滚动矩形内部被着色，而由矩形内向外的滚动将不被着色。<br>
<h3>返回值</h3>如果函数运行成功，返回值为非零；如果函数运行失败，返回值为零。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：如果在被滚动的窗体中由^符，滚动富体将自动隐藏起^符，以防止它被擦掉；当滚动结束后再恢复^符。^符的位置因而被调整过来。<br>
未被ScrollWindow覆盖的区域不再被重画，但它组合成窗体的更新区域。应用程序最终最终受到 WM_PAINT的消息，通知它区域必须被重画。为了在滚动过程的同时重画未覆盖区域，则应在调用ScrollWindow函数后马上调用UpdateWindow函数。<br>
如果参数lpRect为空，则窗体中的任何子窗体的位置由参数XAmount和Yamount种的数量决定偏移；窗体无效（未着色）的区域也进行偏移。IpRect为空时ScrollWindow则更快。<br>
如果参数lpRect不为空，则窗体中的子窗体的位置不改变，窗体中无效（未着色）的区域也不进行偏移。为了防止lpRect不为空时更新的问题，则在调用ScrollWindow之前先调用UpdateWindow函数重窗体。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95以上，头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

29
src/docs/win32api/1/ScrollWindowEx.html Normal file
View File

@ -0,0 +1,29 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数滚动指定窗体客户区域的目录。<br>
<h3>函数原型</h3>int ScrollWindowEx（HWND hWnd，int dx，int dyCONST RECT ·prcScroll，CONST RECT★prcCllp，HRGH hrgnUpdate，LPRECT prcUpdate，UINT flags）；<br>
<h3>参数</h3>
hWnd：客户区域将被滚动的窗体句柄。<br>
dx：在设备单元中，指定水平滚动数量。在向左滚动时此参数必须为负。<br>
dy：在设备单元中，指定垂直滚动数量。在向上滚动时此参数必须为负。<br>
prcScroll：指向RECT结构，它指定了将被滚动的客户区域部分。<br>
prcClip：指向包含了类似于被剪下矩形的RECT结构。只有在剪下内部的小块图形才受影响。从矩形外向内部的滚动部分将被着色；而从内向外的滚动部分将不再被着色。<br>
hrgnUpdate：处理已被修改的区域，保存这些由于滚动而无效的区域。此参数可以为空。<br>
prcUpdate：指向RECT结构，它接收由于滚动使得矩形无效部分的边界。此参数值可以为空。<br>
flags：指定控制滚动的标志。这个参数可以是下面的值：<br>
SW_ERASE：通过发送WM_ERASEBKGND消息给窗体。<br>
SW_INVALIDATE：在滚动后，使得由参数hrgnUpdate标识的无效区域被擦除。<br>
SW_SCROLLCHILDREN：动所有由参数prcScroll指出交叉重叠矩形的子窗体。子窗体按照dx和dy规定的像素个数滚动。系统发送消息给所有由prcScroll指出交叉重叠矩形的子窗体，即使他们不移动。<br>
SW_SMOOTHSCROLL：Windows NT 5.0或以上版本中：使用平滑滚动。利用flags参数中HIWORD部分简要说明所需平滑滚动操作的时间。<br>
<h3>返回值</h3>如果函数运行成功，返回值为SIMPLEREGION（矩形的无效区域），COMPLEXREGION（非矩形的无效区域）或NULLREGION（没有使无效的区域）如果函数运行成功，返回值为ERROR。若想获得更多的错误信息，请调用GetLastError函数。<br>
注意：如果SW_INVALIDATE和SW_ERASE标志没有被设定，那么函数ScrollWindowEx不能使滚动离开的区域失效。如果其中任意一个标志被设置，ScrollWindowEx函数就可以使区域无效。这块区域将不再被更新直到应用程序调用theUpdateWindow函数，调用theRedrawWindow函数（指定RDW_UPDATENOW或RDW_ERASENOW标志）或是从申请队列中找到WM_PAINT消息。<br>
如果窗体拥有WS_CLIPCHILDREN类型，那么由hrgnUpdate和prcUpdate指定的返回区域描述了必须更新的滚动窗体的全部区域，包括所需更新子窗体的任何区域。<br>
若SW_SCROLLCHILDREN标志被设置，在子窗体被滚动时，系统将不能完全更新屏幕。位于矩形外边的滚动子窗体部分不被擦除，也不在它的新方向上被重画。为了移动子窗体使之完全不在prcScroll指定的矩形条中，可使用DeferWindowPos函数。若标志SW_SCROLLCHILDREN被设置并且^符号交叉滚动矩形，则光标也重新设置。<br>
所有输入输出均被定义为客户端如果有必要，使用IptoDP和dptoLP函数转换逻辑相关性。<br>
Windows CE：参数flags不支持SW_SCROLLCHILDREN。参数dx和dy中只有一个为零。<br>
<h3>速查</h3>Windows NT 3.1、Windows 95、Windows CE 1.0以上，头文件：winuser.h；库文件：user32.lib。<br>
</body>
</html>

17
src/docs/win32api/1/SendAsyncProc.html Normal file
View File

@ -0,0 +1,17 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数是应用程序定义的回调函数，和SendMessageCallback一起使用。系统在将消息传给目标窗口程序后，将消息传给回调函数。类型SENDASYNCPROC定义了一个指向此回调函数的指针。SendAsyncProc是此应用程序定义的函数名的占位符。<br>
<h3>函数原型</h3>VOID CALLBACK SendAsyncProc（HWND hwnd，UINT uMsg，DWORD dwData，LRESULT IResult）；<br>
<h3>参数</h3>
hwnd；其窗口程序接收消息的窗口的句柄。如果将SendMessageCallback的参数hwnd设置为HWND_BROADCAST，系统为每个顶层窗口调用一次SendAsyncProc。<br>
uMsg：指定消息。<br>
dwData：指定从函数SendMessageCallback发送来的应用程序定义的值。<br>
IResult：指定消息处理的结果与消息。<br>
<h3>返回值</h3>此回调函数无返回值。<br>
备注：通过传一个SENDASYNCPROC指针给函数SendMessageCallback来安装一个SendAsyncProc应用程序定义的回调函数。<br>
此回调函数仅当调用SendMessageCallback的线程调用GetMessage，PeekMessage或WaitMessage时调用。<br>
<h3>速查</h3>Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件： winuser.h；输入库：user32.lib。<br>
</body>
</html>

18
src/docs/win32api/1/SendMessage.html Normal file
View File

@ -0,0 +1,18 @@
<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数将指定的消息发送到一个或多个窗口。此函数为指定的窗口调用窗口程序，直到窗口程序处理完消息再返回。而函数PostMessage不同，将一个消息寄送到一个线程的消息队列后立即返回。<br>
<h3>函数原型</h3>LRESULT SendMessage（HWND hWnd，UINT Msg，WPARAM wParam，LPARAM IParam）；<br>
<h3>参数</h3>
hWnd：其窗口程序将接收消息的窗口的句柄。如果此参数为HWND_BROADCAST，则消息将被发送到系统中所有顶层窗口，包括无效或不可见的非自身拥有的窗口、被覆盖的窗口和弹出式窗口，但消息不被发送到子窗口。<br>
Msg：指定被发送的消息。<br>
wParam：指定附加的消息指定信息。<br>
IParam：指定附加的消息指定信息。<br>
<h3>返回值</h3>返回值指定消息处理的结果，依赖于所发送的消息。<br>
备注：需要用HWND_BROADCAST通信的应用程序应当使用函数RegisterWindowMessage来为应用程序间的通信取得一个唯一的消息。<br>
如果指定的窗口是由调用线程创建的，则窗口程序立即作为子程序调用。如果指定的窗口是由不同线程创建的，则系统切换到该线程并调用恰当的窗口程序。线程间的消息只有在线程执行消息检索代码时才被处理。发送线程被阻塞直到接收线程处理完消息为止。<br>
Windows CE：Windows CE不支持Windows桌面平台支持的所有消息。使用SendMesssge之前，要检查发送的消息是否被支持。<br>
<h3>速查</h3>Windows NT：3.1及以上版本：Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。<br>
</body>
</html>

Some files were not shown because too many files have changed in this diff Show More