apiexam.dat

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

    POERR_NODEFAULTPRN：不存在缺省打印机。

    POERR_NODEVKES：未发现打印机驱动程序。

    PDERR_PARAEFAILURE：PrintDlg函数在分析WIN.INI文件中的[devces]部分的字符串时出错。

    PDERR_PRINTERNOTFOUND；WIN.INI文件的[device]部分不包含所请求打印机的入口

    PDERR_RETDEFFAILURE_PD：RETURNDEFAULT标志被指定在PRINTDLG结构的Flags成员中。但hDevMode或hDevNames成员不是NULL。

    PDERR_SETUPFAILURE：PrintDlg函数在装载所需要的资源时出错。

    下面是ChooseFont函数的返回值。

    CFERR_MAXLESSTHANMIN：CHOOSEFONT结构中的nSizeMax成员所给定的大小小于nSizeMin成员给定的大小。

    CFERR_NOFONTS：不存在字体。

    下面是GetOpenFileName和GetSaveFileName函数的返回值。

    FNERR_BUFFERTOOSMALL：由OPENFILENAME结构的lpstrFile成员指向的缓冲区对由用户指定的文件名来说太小。前两种IpstrFile缓冲区的字节含有一个指定大小的整型值。用来存放全文件名。

    FNERR_INVAIDFILENAME：文件名无效。

    FNERR_SUBASSFAILIIRE：由于没有足够内存，在对列表框分类时出错。

    下面是FindText和ReplaceText函数的返回值。

    FRERR_BUFFERLENGTHZERO：结构FINDREPLACE中的一个成员指向一个无效的缓冲区。

    在Windows CE中Windows CE支持另外的四种返回值，如下：

    CDERR_REGISTRYFAILURE 公共对话框函数无法读注册表。

    下面的一些返回值只适用于PrintDlg函数。

    PDERR_NOPORTS：没有注册的端口PDERR_NOPRINTERS：没有注册的打印机

    PDERR_CREATEDCFAILURE：CreateDC调用失败

    Windows CE不支持CDERR_LOADSTRFAILURE、CDERR_MEMLOCKFAILURE或CDERR_REGISTERMSGFAIL返回值。Windows CE也不支持任何PDERR_错误值。

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


==========

==========
DlgDirListComboBox
函数原型：int DlgDirListComboBox（HWND hDlg，LPTSTR lpPathSpec，int nlDComboBox，int nlDStaticPath，UINT uFiletype）；

    参数：

    hDlg：包含组合框的对话框句柄。

    lpPathSpel：指向一个以NULL结束的字符串，格式为 [driver][/][directory/][.][filename]

    如果指定的串包括一个驱动器或目录路径，在填充列表之前，DlgDirListComboBox函数改变当前驱动

    器和目录。在列表被填充之后，驱动器和目录路径从lpPathspec参数标识的串中移出来。

    nlDComboBox：指定对话框中组合框的标识符。如果hlDComboBox为零，则DlgDirlistComboBox函数没有组合框存在或不试图填充它。

    hlDStatic Path：指定静态控制的标识符，此静态控制用于显示当前目录。如果nlDStasticPath为零，DlgDirListComboBox函数认为没有这样的控制。

    uFiletype：指定被显示的文件的属性。它可以是下列的任意组合：

    DDL_ARDIVE：包括档案文件。

    DDL_DIRECTORY：包括子目录，子目录名必须用方括号括起来（[]）。

    DDL_DRIVES：包括驱动器，驱动器列在格式[-X-]中，其中X为驱动器字母名。

    DDL_EXCIUSIVE：包括仅带指定属性的文件，缺省时，写保护文件被引出，即使DDL_READ WRITE没有被指定。

    DDL_HIDBEN：包括隐含文件。DDL_READONLY：包括只读文件。

    DDL_READWRITE：包括读写文件且不带有别的属性。DDL_SYSTEM：包括系统文件。

    DDL_POSTMSGS：把信息传递到应用信息队列，缺省时，DlgDirlist函数把信息直接发送给对话框过程。

    返回值：如果函数调用成功，返回值为非零值，否则返回值为零。例如，如果tpPatbSpec指定的串不是一个有效路径，函数调用失败。若想获得更多错误信息，请调用GetLastError函数。

    备注；如果参数lpszPatbSpec指向一个零字节串或一个指定驱动器目录，或两者的串，但没有文件名，那么认为文件名为"."。

    Windows NT：如果有目录列表的话，则显示长文件名。

    Windows 95：目录列表显示短文件名（为8.3形式）。可以用SHGetFilelnfo或GetFullPathName函数来得到相应的长文件名。

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


==========

==========
DlgDirSelectEx

    函数原型：BOOL DlgDirSelectEx（HWND hDlg，LPTSTR lpString，int nCount，int nlDListBox）；

    参数：

    hDlg：包括列表框的对话框句柄。

    lpString：指向存放选择路径的一个缓冲区。

    ncount：指定由lpString指向的缓冲区的字节长度。

    nlDListBox：指定对话框中列表框的整型标识符。

    返回值：如果当前选择为目录名，返回值为非零值。如果当前选择不是一个目录名，返回值为零，若想获得更多错误信息，请调用函数GetLastError函数。

    备往：DlgDirSelectEx函数把选择复制到由IpString参数指向的缓冲区，如果当前选择是一个目录名或驱动器字母，DlgDirSelectEx则删除方括号（对于驱动器字母，则删去破折号）。这样以便目录名或驱动器字母能插入一个新的路径。如果没有选择，lpString不改变。 DlgDirSelectEx函数把消息LB_GETCURSEL和消息LB_GETTEXT发送到列表框，函数禁止从列表框返回多于一个的文件名。列表框不应是复选的列表框，如果是的话，此函数不返回零值且Ipstring参数保持不变。

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


==========

==========
DlgDirSelectComboBox
函数原型：BOOL DlgDirSelectComboBox（HWND hDlg，LPTSTR lpString，int nCount，int nlDComboBox）；

    参数：

    hDlg：包括组合框的对话框的句柄。

    IpString：指向存放选择路径的缓冲区。

    nCount：指定IpString参数指向的缓冲区的字节长度。

    nlDComboBox：指定控制对话框的组合框的整型标识符。

    返回值：如果当前选择为一个目录名，返回值为非零值；否则，返回值为零值。若想获得更多错误信息，请调用GetLastError函数。

    备注：如果当前选择指定于一个目录名或驱动器字母，DlgDirSelectComboBoxEx函数则删方括号（对驱动器字母则删除破折号），以便使文件名或驱动器字母能插入新的路径或文件名，如果没有选择，IpString参数指向的缓冲区的内容没有改变。DlgDirselectComboBoxEx函数不允许从组合框返回多于一个的文件名。

    DlgDirSectectComboBoxEx把消息CB_GETCILRSEL和CB_GETLBTEXT发送到组合框。在Win32API中，可应用带有三种组合框的DlgDirSelectComboBoxEx函数（三种组合框为CBS_SIMPLE，CBS_DROPDOWN，与CBS_DROPDOWNLIST）。

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


==========

==========
FindText
函数原型：HWND FindText（LPFINDREPLACE lpfr）；

    参数：

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

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

    CDERR_FINDRESFAILURE；CDERR_MEMLOCKFAILURE；CDERR_INITIALIZATION

    CDERR_NOHINSTANCE；CDERR_LOCKRESFAILURE；CDERR_NOHOOK

    CDERR_LOADRESFAILURE；CDERR_NOTEMPLATE；CDERR_LOADSTRFAILURE

    CDERR_STRUCTSIZE；CDERR_MEMALLOCFAILURE；FRERR_BUFFERLENGTHZERO

    备注：FindText函数不执行查找操作，相反，对话框把FINDMSGSTRING己登记的信息传送到对话框窗口的窗口函数。当创建对话框时FINDReplace结构中的hwndCwner成员标识窗口。

    调用Find Text函数前，必须调用RegisterWindowMessage函数以得到FINDMSGSTRING信息的标识符，对话框函数在用户点击FindNext按钮或对话框被关闭时利用此标识符传送信息。FINDMSGSTRING信息的IParam参数包含一个指向FINDREPLACE结构的指针，此结构的Flags成员显示开诚信息的事件。

    其他成员显示用户的输入。

    若想创建对话框，必须利用应用程序的主信息链中的IsDialogMessage函数来保证对话框正确处理键盘输入，例如Tab和Esc键。IsDialogMessage返回值显示Find对话框是否处理信息。

    可以为Find对话框提供一个挂钩函数FRHookProc。挂钩函数可处理发送到对话框中的信息。为使挂钩函数生效，可设置HNDREPLACE结构的Flags成员的FR_ENABLEHOOK标志，且指定IpfnHook成员中挂钩函数的地址。

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


==========

==========
FRHookProc
LPFRHOOKPROC类型定义了一个指向此回调函数的指针，FRHookProc是一个应用程序定义的函数名的位置持有者。数原型：UINT CALLBACK FRHookProc（HWND hdlg，UINT uiMsg WPARAM wParam，LPARAM IParam）；

    参数：

    hdlg：指向消息所传送到的Find或Replace公共对话框窗口的句柄。

    uiMsg：指定有放的消息。

    wParam：指定有关消息的另外的信息，精确的意义要根据uiMsg参数的值来定。

    IParam：指定有关消息的另外的信息，精确的意义要根据uiMsg参数的值来定。如果uiMsg参数表明WM_INItDIALOG消息。IParam是一个指向FINDREPLACE结构的指针，该结构包含公共对话框创建时指定的值。

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

    备注：当用FindText，或ReplaceText函数创建一个Find或Replace公共对话框时，可提供一个处理与公共对话框函数有关的信息和通告的FRHookProc挂钩函数。为使挂钩函数生效，应用传送到公共创建函数的FINDREPLACE结构且指定IpfnHook成员中挂钩函数的地址和指定Flags成员中FR_ENABLEHOOK标志的地址。缺省对话框函数处理WM_INTTDIALOG消息后，把它传递给挂钩函数，对于其他所有消息，挂钩函数首先接收消息，然后挂钩函数的返回值决定缺省对话框函数是处理消息或忽略它。如果挂钩函数处理WM_CTLCOLORDLG消息，那么必须返回一个有效的刷子句柄，以便绘制对话框的背景。总之如果挂钩函数处理任何一种WM_HLOLOR信息，那么必须返回一个有效的刷子句柄以绘制指定控制的背景。

    不须从挂钩函数调用EndDialog函数。相反，挂钩函数能调用PostMessage函数把带有IDABORT值的一个WM_COMMAND信息传送给对话框函数Posting IDABORT关闭对话框，使对话框函数返回FALSE值，若要了解为什么挂钩函数关闭对话框，必须提供挂钩函数和应用程序之间的联系机理。

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

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


==========

==========
GetFTitle
函数原型：short GetFTitle（LPCTSTR LPTSTR IpszTitle，WORD cbBuf）；

    参数：

    IpszFile：指向一个文件名或文件位置的指针。

    IpszTitle：指向一个缓冲区，在此缓冲区中函数复制文件名。

    chBuf：指定由IpszTitle函数指向的缓冲的字节长度。

    返回值：如果函数调用成功，返回值为零；如果文件名无效，返回值为一负值。如果由IpszTitle参数指向的缓冲区的太小，返回值为一正整数，其值指定了所需缓冲区的大小。所需缓冲区的大小还包括结尾的NULL字符。

    备注：如果由IpszFile参数指向的缓冲区包含下列任何一个成员，GetFileTitle函数返回一个错误信息值。

    一个空字符串；一个含有星号（）、开括号（［）、闭方括号（］）的串、一个以冒号（：）、斜杠（/）或倒斜杠结尾的串；一个长度超过缓冲区长度的串；一个无效字符（如，一个空格或一个不能打印的字母）：为得到文件名所需的缓冲区的大小，用设置为NULL的IpszTitle和设置为零的cbBuf调用函数。函数将返回所需的大小。