apiexam.dat

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

    备注：用户可以使用控制面板来设置闪烁时间。应用程序应遵守用户的设置。只有允许用户设置闪烁时间的应用程序（例如控制面板）才应该使用SetCaretBlinkTime函数。

    如果改变了闪烁时间，那么后续激活的应用程序会使用修改后的闪烁时间，即使在键盘焦点消失或为非活动时，恢复前一个闪烁时间值，这是由于多线程环境的缘故，在这种环境中，禁止使用一个应用程序与激活另一个应用程序并不同步。这种特性允许系统即使在当前应用程序挂起时也可以激活另一个应用程序。

    对于Windows CE：在Windows CE系统中，在一个应用程序中改变插入标记的闪烁时间不会影响后续加载的应用程序中的闪烁时间。

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


==========

==========
SetCaretPos
函数原型：BOOL SetCaretPos（int X，int Y）；

    参数：

    X：指定插入标记新的X坐标。

    Y：指定插入标记新的Y坐标。

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

    备注：函数SetCaretPos不管插入标记是否隐藏都将移动它。系统为每个队列提供一个插入标记。窗口只能对自己拥有的插入标记进行位置的设置。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：Winuser.h；库文件：user32.lib。


==========

==========
ShowCaret
函数原型：BOOL ShowCaret（HWND hWnd）；

    参数：

    hWnd：标识拥有插入标记的窗口。如果该参数为NULL，那么ShowCaret搜索当前任务以发现有插入标记的窗口。

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

    备注：只有指定的窗口拥有插入标记，并且该插入标记具有形状，没有连续隐藏2次或多次时，ShowCaret才能显示该插入标记。如果这几个条件中的一个或多个没满足，那么ShowCaret函数什么也不做，并且返回FALSE。

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


==========

==========
CCHookProc
LPCEHOOPROC类型定义了一个指向此回调函数的指针。CCHOOkProc是一个应用程序定义的函数名的位置占有者。

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

    参数：

    hdlg：指向信息指定的Color对话框的句柄。

    uiMag：标识存放的信息。

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

    IParam：指定有关消息的其他信息。精确意义由uiMsg参数的值米决定。如果uiMsg多数表明WM_IMTDIALOG消息，IParam是一个指向含有当对话框创建时指定的值的CHOOSECOLOR结构的指针。

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

    备注当用ChooseColor函数创建一个Color对话框时，应用程序可以为对话框函数提供CCHookProc挂钩函数来处理消息。应用传送到对话创建函数中的CHOOSECOLOR结构可使挂钩函数生效，也可指定IpfnHook成员中挂钩函数的地址和指定Flags成员中CC_ENABIEHOOK标志。缺省对话框函数把消息WM_INITDIALOG传送到挂钩函数之前先处理此消息。对于其他所有的消息，挂钩函数首先存放消息。然后其返回值决定此缺省对话函数是处理消息或忽略消息。如果挂钩函数处理WM_CTLCOLORDIG消息，那么必须返回一个有效的刷子句柄以绘制对话框的背景。总之，如果挂钩函数处理任何一种WM_CTLCOLOR消息，它必须返回一个有效的刷了句柄以刷指定的控制板的背景。

    不要从挂钩函数中调用EndDialog函数。相反地挂钩函数能调用PostMessage函数来把带有IDABORT值的WMCOMMAND消息传送到对话框枢函数中。传送LDABORT消息使对话框关闭并使对话框返回值为FALSE。如果要知道为什么挂钩函数关闭对话框，必须在挂钩函数和应用程序之间提供自身联系机理。

    可以对公共对话框的标准控制面板进行子分类。但是公共对话框函数也可以对控制面板子分类、正因如此，在挂钩函数处理消息时必须对控制面板进行子分类。这就保证在对话框函数设置于分类函数之前，子分类函数存放了指定的控制消息。

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


==========

==========
CFHookProc
LPCFHOOKPROC类型定义了一个指向这种回调函数的指针。CFHOOKProc是一个由应用程序定义的函数名的位置占有者。

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

    参数：

    hdlg：指向消息所指的Font对话框窗口的句柄。

    uiMsg：指定存放的消息。

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

    IParam：指定有关消息的其他信息。精确的意义根据uiMSg参数的值来决定。如果uiMsg参数表明WM_INITDIALOG消息，则IParam是一个指向CHOOSEFONT结构的指针，该结构含有创建公共对话框时指定的值。

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

    备注：用ChooseFont函数创建一个Font对话框时，可以为对话框函数提供挂钩函数来处理消息。

    为使挂钩函数生效，要用传送到对话创建函数的CHOOSEFONT结构，指定IpfnHook成员中挂钩函数的地址和Flags成员中CF_ENABLEHOOK标志。

    缺省的对话框函数处理WM_INTDIALOG消息后，把它传送给挂钩函数。对于其他消息，挂钩函数首先存放此消息。然后挂钩函数的返回值决定缺省对话函数是否处理消息或忽略它。

    如果挂钩函数处理 WM_CTLCOLORDLG信息，它必须返回一个有效的刷子句柄，以刷对话的背景。

    总之，如果挂钩函数处理任何一个WM_CTLCOLOR消息，那么必须返回一个有效刷子句柄，以绘制指定控制的背景不须从挂钩函数调用EndDialog函数。相反，挂钩函数能调用PostMessage函数，把带有IDABORT值的一个WM_CDOMMAND信息传送给对话框函数Posting IDABORT关闭对话框，使对话框函数退回FALSE值，若要了解为什么挂钩函数关闭对话框，必须提供挂钩函数和应用程序之间的联系机理。

    可以对公共对话框的标准控制面板进行子分类。但是公共对话框函数也可以对控制面板进行子分类。正因如此，必须在挂钩函数WM_INTDIALDG处理消息时对控制面板子分类。这就保证对话框函数设置子分类函数之前，子分类函数接收指定的控制消息。

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


==========

==========
ChooseColor
函数原型：BOOL ChooseColor（LPCHOOSECOLOR IpCC）；

    参数：

    lpCC：指向一个包括初始化对话框信息的CHOOSECOLOR结构。当ChooseColor函数返回时，此结构含有有关用户颜色选择的信息。

    返回值：如果用户点击对话框中的OK按钮，返回值为非零值。CHOOSECOLOR结构中的rgbResult成员含有用户选择的颜色的RGB颜色值。如果用户取消或关闭Color对话框或错误出现，返回值为零。若想获得更多错误信息，请调用CommDlgExtondedError函数，此函数的返回值为下列中的一个：

    CDERR_FINDRESFAILURE；CDERR_MEMLOCKFAILURE；CDERR_INITIALIZATION；

    CDERR_NOHINSTANCE；CDERR_LOCKRESFAILURE；CDERR_NOHOOK

    CDERR_LOADRESFAILURE；CDERR_NOTEMPLATE；CDERR_LOADSTRFAlLURE；

    CDERR_STRUCTSIZE；CDERR_MEMALLOCFAILURE

    备注Color对话框不支持彩色调色板，对话框提供的颜色的选择仅限于系统颜色和这些颜色的混合值，可以为对话框提供一个CCHOOKProc程序，此挂钩程序能处理发送给对话框的信息。通过建立CHOOSECOLOR结构中Flags成员的CC_ENABLEHOOK标志和指定IpfnHook成员中挂钩程序的地址，可使挂钩程序生效。

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


==========

==========
ChooseFont
函数原型：BOOL ChooseFont（LPCHOOSEFONT Ipcf）；

    参数：

    Ipcf：指向一个含有初始化对话框信息的CHOOSEFONT结构。当返回ChooseFont函数时，此结构含有用户对字体选择的信息。

    返回值：如果用户点击对话框的OK按钮，返回值为非零值，CHOOSEFONT结构中的成员表明用户的选择。如果用户取消或关闭Font对话框或出现错误信息，返回值为零。若想获得更多错误信息。请调用CommDlgExtendedError函数，其返回值如下：

    CDERR_FINDRESFAILURE；CDERR_NOHINSTANCE；CDERR_INITIALIZATION；CDERR_NOHOOK

    CDERR_LOCKRESFAILURE；CDERR_NOTEMPLATE；CDERR_LOADRESFAILURE；

    CDERR_STRUCTSIZE；CDERR_LOADSTRFAILURE；CDERR_MAXLESSTHANMIN

    CDERR_MEMALLOCFAILURE；CDERR_NOFONTS；CDERR_MEMLOCKFAILURE

    备注：可以为Font对话框提供一个CFHOOKProc挂钩程序。此挂钩程序能够处理发送给对话框的信息。

    通过建立CHOOSEFONT结构中Flags成员的CE ENABLEHOOK标志和指定IPfn Hook成员中挂钩程序的地址可以使挂钩程序有效。

    挂钩程序可以把信息WM_CHOOSEFONT_GETLOGLONT，WM_CHOOSEFONT_SETFLAGS和

    WM_CHOOSEFONT_SETLOGFONT消息发送给对话框以便得到和创建当前值和对话框的图标。

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


==========

==========
CommDlgExtendedError
函数原型：DWORD CommDlgExtendedError（VOID）

    参数：无。

    返回值：如果最近一次对话框函数调用成功，返回值不确定，如果对话框函数因为用户关闭或取消对话框而返回FALSE，则返回值为零。否则返回值是非零错误代码。有关更多的信息，参见下列说明部分。

    备注：CommDlgExtendedError函数可以返回公共对话框函数中的一般的错误代码。

    另外，也返回某一具体公共对话框的错误代码。由CommDlgExtendedError返回的错误代码在CDERR.H文件里定义：

    下面是CommDlgExtendedError的返回错误代码值。

    CDERR_DIALOGFAILURE：对话框不能创建。DialogBox函数对对话框函数的调用失败，例如如果公共对话框的调用指定一个无效的窗口句柄，则此种错误产生。

    CDERR_FINDRESFAILURE：公共对话框函数没能找到指定资源。

    CDERR_INITIALIZATION：公共对话框函数在初始化过程中失败。当没有足够内存时此错误出现。

    CDERR_LOADRESFAILURE：公共对话框函数没能调出指定的资源。

    CDERR_LOADSTRFAILURE：公共对话框函数没能调出指定的串。

    CDERR_LOCKRESFAILURE：公共对话框函数没能销定指定的资源。

    CDERR_EMAILCOLFAILURE；公共对话框函数不能为内部结构分配内存。

    CDERR_NOHINSTANCE：在对应的公共对话框初始化结构Flags成员中设置ENABLETEMPLATE标志，但是在提供相应的事例句柄时出错。

    CDERR_NOHOOK：在对应的公共对话框初始化结构Flags成员中设置ENABLEHOOK标志，但是在提供相应的挂钩程序指针时出错。

    CDERR_NOTEMPLATE：在对应的公共对话框初始化结构Flag成员中设置ENABLETEMPLATE标志，但是在提供相应的模板时出错。

    CDERR_REGISTERMSGFAIL：当RegisterWindowMessage函数被公共对话框函数调用时，该函数返回错误代码。

    CDERR_STRUCTSIZE：对应的公共对话框初始化结构旧IStructSize成无效成员。

    下列为Print Dlg函数的返回值。

    PDERR_CREATEICFAILURE：当PrintDlg函数想创建一个信息表时出错。

    PDERR_DEFAIKTDFFERENT：利用在DEVNAMES结构中wDefault成员指定的DN_DEFAULTPRN标志，可以调用PrintDlg函数。但是被另外一个结构成员描述的打印机与当前缺省的打印机不匹配。（此错误发生在储存DEVNAMES结构和用户利用控制面板改变缺省打印机时）。要使用DEVNAMES结构所描述的缺省打印机，必须清空DN_DEFAULTPRN标志并且要再一次调用PrintDlg。要使用缺省打印机，必须用NULL取代DEVNAMES结构俐DEVMODE结构，如果此结构存在的话），并且要再一次调用PrintDlg函数。

    PDERR_DNDMMISMATCH：OEVMOOE和DEVNAMFS结构中的数据描述了两种不同的打印机。

    PDERR_GETDEVMODEFAIL；打印机驱动程序不能初始化一个DEVMODE结构（这种错误代码只用于Windows 3.0及以上版本的打印机驱动程序）。

    PDERR_INITFAILURE：PrintDlg函数不能初始化，并且没有更多的错误代码来描述此错误。

    PDERR_LOADDRVFAILURE：PrinDlg函数不能为指定的打印机装备设备驱动器。