apiexam.dat

来自「不用说了！看看就明白了！」· DAT 代码 · 共 1,100 行 · 第 1/5 页

    E_POINTER：指针失效；E_HANDLE：句柄失效；E_FAIL：不确定的错误。

    备注：有关更多的信息，请见Print Propertysheet。

    速查：Windows NT：5.0及以上版本；Windowss：不支持；Windows CE：不支持；头文件：commdlg.h，库文件。comdlg32.lib；Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。


==========

==========
PrintHookProc
函数接收指定给Print公共对话框的缺省对话框函数的消息和通知。LPPWTHOOKPROC类型定义了一个指向此回调函数的指针。PrintHookProc为由应用程序或库定义的函数名的位置占有者。

    函数原型：UINT CALLBACK PrintHookProc（HWND hdlg，UINT uiMsg，WPARAM wParam，LPARAM IParam）；

    参数：

    hdlg：指向消息指定给的Print公共对话框窗口的句柄。

    uiMsg：标识接收的消息。

    wParam：指定有关消息的其他信息、精确的意义由uiMsg参数的值来决定。

    IParam：指定有关消息的其他信息、精确的意义由uiMsg参数的值来决定。

    返回值：如果挂钩函数返回值为零，缺省对话框函数处理消息；返回非零值，将忽略消息。

    备注：当用PrintDlg函数创建一个Print公共对话框时，可以提供一个PrintHookProc挂钩函数来处理指定给对话框函数的消息或通知。

    为使挂钩函数生效，要用传递到创建对话框函数的PRINTDLG结构，且要指定IpfnPrintHook成员中挂钩函数的地址和指定Flags成员中PD_ENABLEPRINTHOOK标志。

    缺省对话框函数把消息WM_InITDIALOG传送到挂钩函数之前先处理此消息。对于其他所有的消息，挂钩函数首先存放消息。然后其返回值决定此缺省对话函数是处理消息或忽略消息。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；头文件：commdlg.h；库文件：用户自定义。


==========

==========
Replace Text 
函数原型：HWND Replace Text （LPFINDREPLACE Ipfr）；

    参数：

    Ipfr：指向一个包含初始化对话框的信息的FINDREPLACE结构。对话框应用此结构把用户输入的有关信息传送到应用程序。有关更多的信息，见卜列说明部分。

    返回值：如果函数调用成功，返回值为对话框的窗口句柄，可以用窗口句柄与对话框联系或关闭它。如果函数调用失败，返回值为NULL。若想获得更多的错误信息，调用CommDlgExError函数，其返回值如下：

    CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE

    CDERR_INITIALIZATION COERR_NOHINSTANCE

    CDERR_LOADRESFAILURE CDERR_NOHOOK

    CDERR_LOADSTRFAILURE CDERR_BITEMPLATE

    CDERR_LOCKRESFAILURE CDERR_STRUCTSIZE

    CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO

    备注：PepIACE Text函数不执行文本替代操作。相反，对话框把FINDSGSTRING 已登记的信息传送到对话框窗口的窗口函数。当创建对话框时，FINDREPLACE结构的hwndowner成员指定该对话框窗口。

    调用ReplaceText函数之前，必须调用RegisterWindowMessage函数为FINDSGSTRING信息登记标识。

    当用户击点Find Next，Replace ALL按钮时，或当关闭对话框时，对话框函数应用这些标识发送信息。

    FINDMSGSTRING信息中的IParam参数含有一个指向FINDREPLACE结构的指针。此结构的Flags成员表明了形式信息的事件。该结构中其他的成员表明用户的输入信息。

    如果创建了Replace对话框，必须应用应用程序信息链中的IsDialogMesssage函数来保证对话框能正确处理链盘输入信息，例如Tab键和Esc键。

    ISDialogMessage函数返回值表明Replace对话框是否处理信息。

    可以为Replace对话枢提供一个FRHookProc挂钩函数，此挂钩函数能处理发送到对话框中的信息。

    为使一个挂钩函数生效，可设置FINDREPLACE结构中Flags成员的FR_ENABLEHOOK标志且指定IpfnHook成员中挂钩函数的地址。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：commdlg.h；库文件：comdlg32.lib：Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。


==========

==========
SetupHookProc
函数原型：UINT CALLBACK SetupHookProc（HWND hdlg，UINT uiMsg，WPARAM wParam，LPARAM IParam）；

    参数：

    hdlg：指向消息指定给的Print公共对话框窗口的句柄。

    UiMsg：标识接收的消息。

    wParam：指定有关消息的其他信息、精确的意义由uiMSg参数的值来决定。

    IParam：指定有关消息的其他信息、精确的意义由uiMsg参数的值来决定。

    返回值：如果挂钩函数返回值为零，缺省对话框函数处理消息；返回非零值，将忽略消息。

    备注；PrintSetup对话框函数已经被PageSetup对话框所取代。这需要用新的应用程序来使用。但是，为了一致性，PrintDlg函数仍支持Print Setup对话框的显示。可以提供一个SetupHookProc函数给PrintSetup对话框，从便处理指定给对话框函数的消息和通知。为使挂钩函数生效，要用传递到对话创建函数的PRINTDLG结构，且指定IpfnSetupHook成员中挂钩函数的地址和指定Flags成员中PD_ENABLESETUPHOOK标志。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：commdlg.h；库文件：用户自定义。


==========

==========
CliepCursor
函数原型：BOOL CliepCursor（CONST RECT★ lpRect）；

    参数：

    IpRect：指向RECT结构的指针，该结构包含限制矩形区域左上角和右下角的屏幕坐标，如果该指针为NULL（空），则光标可以在屏幕的任何区域移动。

    返回值：如果成功，返回值非零；如果失败，返回值为零。若想获得更多错误信息，请调用GetLastError。

    备注：光标是一个共享资源，如果一个应用控制了光标，在将控制转向另一个应用之前，必须要使用ClipCursor来释放光标，该调用过程必须具有对窗口的WINSTA_WRITEATTRIBUTES访问权。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件；user32.lib。


==========

==========
CopyCursor
函数原型：HCURSOR CopyCursor（HCURSOR pcur）；

    参数：

    pcur：被复制光标的句柄

    返回值；如果成功，返回值是复制光标的句柄；如果失败，返回值为NULL（空）。若想获得更多错误信息，请调用GetLastError函数。

    备注；CopyCursor函数能使一个应用程序或一个动态连接库（OLL）得到一个属于另一模块的光标形状的句柄。如果另外一个模块被释放，则该应用程序仍然可以使用该光标形状。在关闭之前，一个应用程序必须调用DestroyCursor函数来释放任何与该光标有关的系统资源。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib


==========

==========
CreateCursor
函数原型：HCURSOR CreateCursor（HINSTANCE htnst，int xHotSpot；int yHotSpot；int nWidth；iut nHeight，CONST VOID ★pvANDPlane，CONST VOID ★pvXORPlane）；

    参数：

    hlnst：创建光标的应用程序的当前事例句柄。

    xHotSpot：指定光标热点的水平位置。

    yHotSpot：指定光标热点的垂直位置。

    nWidth：以像素为单位指定光标的宽度。

    nHeight：以像素为单位指定光标的高度。

    pvANDPlane：指向一个字节数组的指针，该数组包含光标AND掩码的位值，就象设备相关的单色位图一样。

    pvXORPlane：指向一个字节数组的指针，该数组包含光标XOR掩码的位值，就象设备相关的单色位图一样。

    返回值：如果成功，返回光标的值；如果失败，返回值为NULL（空），若想获得更多错误信息，调用GetLastError函数。

    备注：nWidth和nHeight参数必须指定一个当前显示驱动支持的宽度和高度，因为系统不能创建一个其他尺寸的光标，为了确定显示驱动所支持的宽度和高度，请使用GetSystemMetrics函数，指定SM_CXCUROR或SM_CYCURSOR值。在一个应用程序关闭之前，必须调用DestroyCursor函数来释放与光标有关的任何系统资源。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。


==========

==========
DestroyCUrsor
函数原型：8OOL DestroyCUrsor（HCURSOR hCursor）；

    参数：

    hCursor：要销毁的光标的句柄，该光标必须不在使用中。

    返回值：如果成功，返回非零；如果失败，返回值为零，若想获得更多错误信息，请调用GetLastError函数。

    备注：DestroyCursor函数销毁一个非共享的光标；不要用它销毁一个共享光标。一个共享光标只要调用它的模块仍在内存中，则该共享光标还是有效的，下面的函数可得到一个共享光标：LoadCursor；LoadCursorFronFile；Loadlmage（如果使用LR-SHARED标志）；

    Copylmage（如果使用LR_COPYRETURORG标志并且hlmags参数是一个共享光标）。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。


==========

==========
GetClipCursor
函数原型：BOOL GetClipCursor（LPRECT IpRect）；

    参数：

    IpRect：一个RECT结构的指针；接收限制矩形的屏幕坐标。如果该光标没有被限制在一个矩形区域内，则该RECT结构接收屏幕的尺寸。

    返回值：如果成功，返回非零；如果失败，返回值为零，若想获得更多错误信息，请调用GetLastError函数。

    备注：该光标是一个共享光标，如果一个应用程序使用ClipCursor函数来限制该光标，那么在它放弃控制转向另一个应用之前必须使用ClipCursor来释放该光标，该调用过程必须具有对窗口站的WINSTA_READATTRIBUTES访问权限。

    速查：Windows NT：3.1及以上下版本；Windows：95及以上版本；Windows CE：不支持；头文件：Winusre.h；库文件：user32。lib。


==========

==========
GetCursor
函数原型：HCURSOR GetCursor（VOID）；

    参数：无。

    返回值：返回值是当前光标的句柄，如果没有光标，返回值为NULL。

    速查：Windows NT：3.1及以上版本；Wjhdows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。


==========

==========
GetCursorPos
函数原型：BOOL GetC