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.