apiexam.dat

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

==========
SOUNDSENTRYProc
函数原型：LRESULT CALLBACK SOUNDSENTRYProc（DWORD dwMillisec，DWORD fdwEffect）；

    参数：

    Millisec：指定可视化消息的持续时间，以毫秒为单位。该消息是在一个基于win32的应用程序（或运行在窗口的应用程序）发声时显示出来的。

    tdwEffect：指定要显示的可视化消息的类型。当前值通常应为SSWF_CUSTOM。

    返回值：如果可视化消息已经或将要正确显示，那么返回值为TRUE，如果消息异步，并当调用该函数时其状态无效，那么应该返回TRUE。如果出错使得消息无法显示，那么返回值为FALSE。若想获得更多错误信息，请调用GetLastError函数。

    备注：包含SOUNDSENTRYProc函数的库必须是一个32位的DLL，并且该 DLL必须导出名为SOUNDSENTRYProc的函数，即供外部调用和连接。SOUNDSENTRYProc函数只是在应用程序或库调用SystemParameterslnfo函数之后才调用。SystemParameterslnfo函数指定SPI_SETSOUNDSENTRY项的值以及SOUNDSENTRY结构的地址，在SOUNDSENTRY结构中，成员iWindowsEffect的值设为SSWF_CUSTOM。

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


==========

==========
SystemParametersinfo
函数原型：B00L SystemParametersinfo（UINT uiAction，UINT uiParam，PVOID pvParam，UINT fWinlni）；

    参数：

    uiAction：该参数指定要查询或设置的系统级参数。其取值如下；

    SPI_GETACCESSTIMEOUT：检索与可访问特性相关联的超时段的信息，PvParam参数必须指向某个ACCESSTIMEOUT结构以获得信息，并将该结构中的cbSjze成员和ulParam参数的值设为sizeof（ACCESSTIMEOUT）。

    SPI_GETACTIVEWINDOWTRACKING：用于Windows 98和Windows NT 5.0及以后的版本。它表示是否打开活动窗口跟踪（激活该窗口时鼠标置为开状态），pvParam参数必须指向一个BOOL型变量（打开时接收值为TRUE，关闭时为FALSE）。

    SPI_GETACTIVEWNDTRKZORDER；用于Windows 98和Windows NT 5.0及以后版本。它表示通过活动窗口跟踪开关激活的窗口是否要置于最顶层。pvParam参数必须指向一个BOOL型变量，如果要置于顶层，那么该变量的值为TRUE，否则为FALSE。

    SPI_GETACTIVEWNDTRKTIMEOUT：用于Windows 98和 Windows NT 5.0及以后版本。它指示活动窗口跟踪延迟量，单位为毫秒。pvParam参数必须指向DWORD类型变量，以接收时间量。

    SPI_GETANIMATION：检索与用户活动有关的动画效果。pvParam参数必须指向ANIMATIOINFO结构以接收信息。并将该结构的cbSize成员和ulParam参数置为sizeof（ANIMATIONINFO）。

    SPI_GETBEEP：表示警告蜂鸣器是否是打开的。pvParam参数必须指向一个BOOL类型变量，如果蜂鸣器处于打开状态，那么该变量的值为TRUE，否则为FALSE。

    
==========

==========
CheckDlgButton
函数原型：BOOL CheckDlgButton（HWNDhDlg，int nlDButton,UINT uCheck）；

    参数：

    hDlg：指向含有该按钮的对话框的句柄。

    nlDButton：标识要修改的按钮。

    uCheck：给定该按钮的选中状态。该参数可取下列值，这些值的含义如下：

    BST_CHECKED：设置按钮状态为己选中（checked）。

    BST_INDETERMINATE：设置按钮状态变灰，表示不确定状态。只有在该按钮具有BS_3STATE或BS_AUTO3STATE样式时才能使用该值。

    BST_UNCHECKED：设置按钮为未选中状态（unchecked）。

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

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


==========

==========
CheckRadioButtoh
函数原型：BOOL CheckRadioButtoh（HWNDhDlg， intnlDFirstButton， intnlDLastBUtton， intnlDCheckButton）；

    参数：

    hDlg：指向包含单选按钮的对话框的句柄。

    nlDFirstButton：指定组中第1个单选按钮的标识符。

    nlDLastButton：指定组中最后一个单选按组的标识符。

    nlDCheckButton：指出要选中的那个单选按钮的标识符。

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

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


==========

==========
IsDlgButtonChecked
函数原型：UINT IsDlgButtonChecked（HWND hDlg，Int nlDBUtton）；

    参数：

    hDlg：指向包含按钮控制的对话框。

    nkDButtom：指定按钮控制的整型标识符。

    返回值：使用BS_AUTOCHECKBOX、BS_AUTORADIOBUTTON、BS_AUTO3STATE、BS_CHECKBOX、BS_RADIOBUTION或BS_3STATE样式创建的按钮的返回值可以是如下值之一：

    BST_CHECKED：表示按钮被选中。

    BST_INDETERMINATE：表示按钮是灰色的，即为不确定状态（只有具有BS_3STATE或BS_AUTO3STATE样式的按钮才使用该值）。

    BST_UNCHECKED：表示该按钮未选中（unckecked）。如果该按钮用其他任何样式，那么返回值为零。

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


==========

==========
CreateCaret
函数原型：BOOL CreateCaret（HWND hWnd，HBIBMAP hBitmap，int nHeight）； 

    参数：

    hWnd：指定佣有插入标记的窗口。

    hBitmap：标识用于定义插入标记形状的位图。如果该参数为NULL，那么插入标记是实心的（原色），如果该参数为（HBITMAP）1，那么插入标记是灰色的。如果该参数是位图句柄，那么插入标记就是指定的位图。位图句栖必须已中由CreateBitmap、CreatDIBitmap或LoadBitmap函数创建。

    如果hBitmap为位图句栖，那么CreateCaret函数将忽略参数nWidth和nHeight，因为该位图定义了自己的宽度和高度。

    nWidth：按逻辑单位指定插入标记的宽度，如果该参数为零，那么宽度就设为系统定义的窗口边界宽度。如果hBitmap是位图句柄，那么函数CreateCaret忽略该参数。

    nHeight：按逻辑单位指定插入标记的高度。如果该参数为零，那么高度就设为系统定义的窗口边界高度如果hBitmap是位图句柄，那么函数CreateCaret忽略该参数。

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

    备注：参数nWidth和nHeight指定了插入标记的宽度和高度，这些值按逻辑单位表示；按像素表示的真正 宽度和高度与窗口的映射模式有关。

    CreateCaret函数自动清除前一个插入标记的形状，不考虑拥有该插入标记的窗口。新创建的插入标记一直隐藏，直到应用程序调用ShowCaret函数使该插入标记可见为止。

    系统为每个队列提供一个插入标记。窗口只有在它有键盘焦点（focus）或者它是活动窗口时才创建插入标记。该窗口应在键盘焦点消失或窗口变为不活动之前，清除插入标记。

    可以通过使用GetSystemMetrics函数，并指定SM_CXBORDER和SM_CYBORDER值来检索系统窗口边界的宽度或高度。使用窗口边界的宽度或高度可以保证插入标记在高分辨率屏幕上可见。

    对于Windows CE：Windows CE不支持hBitmap参数，并且该参数应设为NULL。Windows CE缺省的是实心（Solid）插入标记。

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


==========

==========
DestroyCaret
函数原型:BOOL DestroyCaret（VOLD）

    参数:无。

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

    备注:只有当前任务中的窗口拥有插入标记时DestoryCaret才清除插入标记。如果插入标记不为当前任务中的窗口拥有，那么DestroyCaret不执行任何操作，并且返回FALSE。

    系统为每个队列提供一个插入标记。只有当窗口有键盘焦点或窗口是活动的时候，才创建插入记号。窗口应该在键盘焦点消失或窗口变为不活动之前清除插入标记。

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


==========

==========
GetCaretBlinkTime
函数原型：UINT GetCaretBlinkTime（VOLD）

    参数：无。

    返回值：如果该函数执行成功，那么返回值就是闪烁时间，单位为毫秒；如果函数执行失败，那么返回值为零。若想获取更多错误信息，请调用GetLastError函数。

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


==========

==========
GetCaretPos
函数原型：BOOL GetCaretPos（LPP0lNT IpPoint）；

    参数：

    IpPoint：指向POINT结构的指针。该结构接收插入标记的客户坐标信息。

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

    备注：插入标记位置通常是按包含该插入标记的窗口的客户坐标形式给出的。

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


==========

==========
HideCaret
函数原型：B00L HideCaret（HWND hWnd）；

    参数：

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

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

    备注：只有指定的窗口拥有插入标记时，HideCaret才隐藏插入标记。如果指定的窗口没有插入标记，那么函数HideCaret什么也不做，并且返回FALSE。

    隐藏操作是累计的，如果应用程序连续5次调用HideCaret，那么该程序也必须调用ShowCaret 5次才能显示插入标记。

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


==========

==========
SetCaretBlinkTime
函数原型：BOOL SetCaretBlinkTime（UINT uMSeconds）；

    参数：

    uMSeconds：指定新的闪烁时间，时间单位为毫秒。

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