平台 SDK: Windows 用户接口

DestroyCaret

DestroyCaret函数销毁脱字符的当前形状,将脱字符从窗口中释放出来,并将脱字符从屏幕上移除。

如果插入符形状基于位图,则DestroyCaret不会释放位图。

BOOL DestroyCaret(VOID);

参数

该函数没有参数。

返回值

如果函数成功,返回值为非零。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

备注

DestroyCaret只有在当前任务中的窗口拥有该插入符号时才会销毁插入符号。 如果不在当前任务中的窗口拥有该插入符,DestroyCaret不执行任何操作并返回FALSE。

系统为每个队列提供一个插入符号。 一个窗口只有在键盘焦点或活动时才能创建插入符。 在丢失键盘焦点或变为不活动状态之前,窗口应该销毁插入符号。

示例代码

有关示例,请参阅销毁插入符号。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winuser.h; 包含于 Windows.h.
  库: 使用 User32.lib.