apiexam.dat

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

    GetFileTitle函数返回一个串，系统应用此串为用户显示文件名。这就意味着如果返回串应用在文件系统函数的调用中不可能准确地标识文件。

    如果证IpszTitle缓冲区太小，GetFile Title返回的大小需要含有显示名。在IpszFile缓冲区指定的需要的大小和字符之间没有许可的联系。

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


==========

==========
GetSaveFileName
函数原型：BOOL GetSaveFileName（LPOPENFILENAME Ipofn）；

    参数：

    Ipofn：指向一个包含初始化对话框信息的OPENFILENAME结构。当GetsaveFileName函数返回时，此结构含有关于用户文件选择的信息。

    返回值：如果用户指定了一个文件名且点击OK按钮，返回值为非零值。由OPENFILENAME结构中的归IpstrFile成员指向的缓冲区含有全路径和用户指定的文件名。如果用户取消或关闭Save对话框或错误出现，返回值为零。若想获得有关更多的错误信息，请调用CommDlgExtendError函数，其返回值同GetOpenFileName返回值。

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


==========

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

    参数：

    hdlg：指向Open或Save as对话框的子对话框的句柄。用GetParent函数可得到指向Open或Save As对话框窗口的句柄。

    uiMsg．标识存放的消息。

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

    IParam；指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。如果uiMsg参数显示了WM_INITDIALOG消息，IParam是一个指向OPENFILENAME结构的指针。该结构含有创建对话框时指定的值。

    返回值：如果挂钩函数返回零，缺省对话框函数处理消息。如果挂钩函数返回非零值，缺省对话框函数忽略消息。对于CDN_SHAREVIOLATION和CDN_FILEOK通告消息，挂钩函数应该返回非零值，以表明已经利用SetWindowLong函数设置了一个非零DWL_MSGRESULT值。

    备注：当用GetOpenFileName或GetSaveFileName函数创建浏览器风格的Open或Save As公共对话框时，可以提供一个OFNHookProc挂钩函数。为使挂钩函数生效，须应用传递到对话创建函数的OPENFILENAME结构，且须指定一个指向PfnHook成员中的挂钩函数的指针，及指定Flags成员中OFN_ENABLEHOOK标识。

    如果为浏览器风格的公共对话框提供了一个挂钩函数，系统创建了一个缺省对话框的子对话框，挂钩函数为子对话框作为对话函数，此子对话框以OPENHLENAME结构指定的模块为基础，或如果没有指定模板，对话框是一个缺省的子对话框。当缺省对话框函数正在创建WM_INITDALOG消息时，创建了子对话框。在子对话框处理它本身的WM_INITDIALOG消息时，缺省对话函数删除掉标准控制面板，如果需要，可为子对话框的其他的任何一个控制面板提供空间，然后系统将CDN_INITDONE通告消息发送给挂钩函数。

    挂钩函数不接收指定给缺省对话框的标准控制面板的消息。可以对控制面板进行子分类，但是如果控制面板使应用程序与公共对话框将来的版本不一致，那么不能进行子分类。但浏览器风格的公共对话框提供了一套消息，此挂钩函数可利用此消息来最小化和控制对话框。它包括了从对话框发送来的一组通知消息，还有可以发送到从对话框检取信息的消息。关于这些消息的全部列表，参见EXplorer-Style HookProcedures。如果挂钩函数处理WM_CTLCOLORDLG信息，它必须返回一个有效的刷子句柄，以刷对话的背景。总之，如果挂钩函数处理任何一个WM_CTLCOLOR消息，那么必须返回一个有效刷子句柄，以绘制指定控制背景。不须从挂钩函数调用EndDialog函数。相反，挂钩能调用PostMessage函数把带有IDABORT值的一个WM_COMMAND信息，传送给对话框函数Posting IDABORT来关闭对话框，使对话框函数返回FALSE值。若要了解为什么挂钩函数关闭对话框，必须提供挂钩函数和应用程序之间的联系机理。

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


==========

==========
OFNHookProcOldStyle
OFNHookProcOldStyle是应用程序定义的或库定义的函数名的位置占有者。当创建一个Open或Save As公共对话框时，如果指定OFN_EXPLORER标志且需一个挂钩函数，那么必须应用一个Explorer_style的OFNHookProc挂钩函数。

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

    参数：

    hdlg：指向消息指定的Open或Save As对话框窗口。

    uiMsg：标识接收的消息。

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

    IParam：指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。如果uiMsg参数显示了WM_INITDIALOG消息，IParam是一个指向OPENFILENAME结构的指针。该结构含有创建对话框时指定的值。

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

    备注：当用GetOpenFileName或GetSaveFileName函数创建一个旧式的Open或Save As对话框时。可以提供一个OFNHookProcOldStyle挂钩函数。为使挂钩函数生效，须应用传递到对话创建函数的OPENHLENAME结构，且须指定一个指向IpnHook成员中的挂钩函数的指针，及指定Flags成员中OFN_ENABLEHOOK标识。如果挂钩函数处理WM_CTLCOLORDLG消息，那么必须返回一个有效的刷子句柄，以便绘制对话框的背景。总之，如果挂钩函数处理任何一种WM_CTLCOLOR信息，那么必须返回一个有效的刷子句柄以绘制指定控制的背景。不须从挂钩函数调用EndDialog函数。相反，挂钩函数能调用PostMessage函数，把带有IDABORT值的一个WM_COMMAND信息传送给对话框函数PostingIDABORT，并关闭对话框，使对话框函数返回 FALSE值，若要了解为什么挂钩函数关闭对话框，必须提供挂钩函数和应用程序之间的联系机理。可以对公共对话框的标准控制面板进行子分类。但是公共对话框函数也可以对控制面板进行子分类。正因如此，必须在挂钩函数WM_INTDIALDG处理消息时对控制面板子分类。这就保证对话框函数设置子分类函数之前，子分类函数接收指定的控制消息。

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


==========

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

    参数：

    hdlg：指向pagesetup对话枢窗口的句柄。

    uiMsg：标识接收的消息。

    wparam：指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。

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

    返回值：如果挂钩函数对前三个绘图顺序消息中的任何一个返回值为TRUE。且前三个消息为WM_PSD_PAGESETUPDLG，WM_PSD_FULLPAGERECT或WM_PSD_MINMARGINRECT），对话框不再发送消息。且直到下一次系统需要重画样本页时才绘出样本页。如果对所有的三个消息。挂钩函数返回FALSE，对话框发送给图顺序的保留的消息。

    如果挂钩函数对绘图顺序中保留消息的任何一个，返回值为TRUE，那么对话框不绘样本页对应的部分，如果挂钩函数对这些信息中的任何一个返回值为FALSE，对话框绘样本页部分。

    备注PageSetup对话框含有一个样本页的构想。此构想展示了用户选择如何影响打印输出的外观。构想由代表选择页或信封类型的长方形组成，点线长方形代表当前页边。部分字母展示了文本在打印出的页中的状况。当用PageSetupDlg函数创建Page Setup Dialog对话框时，可提供一个PagePaintHook挂钩函数来制作样本页的表观。

    为使挂钩函数生效，须用传递到创建对话函数的PAGESETUPDLG结构，且指定一个指向

    IpfnPagePrintHook成员中挂钩函数的指针和指定Flags成员中PSD_ENABLEPAGEPAINTHOOK标志。

    无论何时，只要对话框将要绘样本页的内容，那么挂钩函数就接受以下列顺序列表的消息：WM_PSD_PAGESETUPDLG：对话框将要绘样本页，挂钩函数利用此消息准备给样本页里的内容。

    WM_PSD_FULLPAGERECT：对话框要绘样本页，此信息指定样本页的长方形边。

    WM_PSD_MINMARGINRECT：对话框将要绘样本页，此信息指定空白长方形。

    WM_PSD_MARGINRECT：对话框将要绘空白长方形。

    WM_PSD_REEKTEXTRECT：对话框将要在空白长方形内绘Greek文本。

    WM_PSD_ENVSTAMPRECT：对话框将要在信封样本页上绘邮票长方形。此消息仅发向信封。

    WM_PSD_YAFULLPAGERECT：对话框将要绘信封样本页的返回地址部分。此消息仅发向信封和其他纸张大小。

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


==========

==========
ageSetupDlg
函数原型：BOOL PageSetupDlg（LPPAGESETUPDLGI ppsd）；

    参数：

    Ippsd：指向一个包含初始化对话框信息的PAGESETUPDLG结构。当函数返回时，该结构存放有关用户选择的信息。

    返回值：如果用户点击OK钮，返回值为非零值，Ippsp参数指向的PAGESETUPDLG结构中的成员显示用户的选择。如果用户取消或关闭PageSetup对话框或错误出现，返回值为零。若想获得更多的错误信息，请调用CommDlgExtendedError函数

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


==========

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

    参数：

    hdlg：指向消息指定给Page Setup对话框窗口的句柄。

    uiMsg：标识接收的消息。

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

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

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

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


==========

==========
PrintDIg
打印设置对话框不能应用在新应用程序中，它已经被PageSetupDlg函数创建的打印设置公共对话框所替代。

    函数原型：BOOL PrintDIg（LPPRINTDLG Ippd）；

    参数：

    Ippd：指向一个含有初始化对话框信息的PRINTDLG结构。当PRINTDLG函数返回时，此结构含有关用户选择的信息。

    返回值：如果用户点击OK按钮，返回值为非零值。由lppd参数指向的PRINTDLG结构中的成员显示用户的选择。如果用户取消或关闭Print或PrinterSetup对话框或错误出现，返回值为零。若想获得更多的错误信息，请调用CommDlgError函数。如果用户取消或关闭对话框，函数返回零值：否则，返回值如下：

    CDERR_FINDRESFAILURE PDERR_CRETELCFAILUPE

    COERR_INITIALIZATION PDERR_DEFAULTDIFFERENT

    CDERR_LOADRESFAILURE PDERR_DNDMMISMATCH

    CDERR_LOADSTRFAILURE PDERR_GETDEVMODEFAIL

    CKERR_LOCKRESFAILURE PDERR_INITFAILURE

    CDERR_MEMALLOCFAILURE PDERR LOADDRVFAILURE

    CDERR_MEMLOCKFAILURE PDERR_NODEFAULTPRN

    CDERR_NOHINSTANCE PDERR_NODEVICES

    CDFRR_NOHOOK PDERR_PARSEFAILURE

    CDERR_NOTEMPLATE PDERR_PRINTERNOTFOUND

    CDERR_STRUCTSIZE PDERR_RETDEFFAILURE

    备注：如果挂钩函数（由PRINTDLG结构中的IpfnrintHOOk成员或IpfnSetupHOOk成员指向的）处理WM_CTLCOLORDLG信息，挂钩函数必须返回一个刷子句柄，此刷了用来刷控制背景。

    Windows NT 5.0以及以后的版本：可用PrintDlgEx函数来显示一个Print属性页，此属性页有一个含有Print公共对话框相似的控制的General页，其控制与Print公共对话框中的控制相似。

    Windows CE：PRINTDLG结构包含Windows CE中不同的成员。

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


==========

==========
PrintDlgEx
函数原型：HRESULT PrintDlgEx（LPPRINTDLGEX Ippd）；

    参数：

    Ippd：指向一个包括初始化属性页信息的PRINTDLGEX结构。当PrintDlgEx函数返回时，此结构含有关于用户选择的信息。

    返回值：如果函数调用成功，返回值为S_OK，且PRINTDLGEX结构中的dw ResuhltAction成员含有下列值：

    PD_RESULT_APPLY：用户点击Apply按钮，然后点击Cancel按钮，这显示出用户想应用在属性页中做的改变，但还不想打印。当Apply按钮被点击时，PRINTDLGEX结构包含用户指定的信息。

    PD_RESUCT_CANCEI：用户点击Cancel按钮，PRINTDLGEX结构中的信息未被改变。

    PD_RESUCT_PRINT：用户点击Print按钮，PRINTDLGEX结构含有用户指定的信息。

    如果函数调用成功，返回值可能是下列COM错误代码中的一个，有关更多的信息请参见ErrorHandling。

    E_OUTOFMEMORT：内存不足；E_INVALIDARG：一个或更多的参数无效。