ShowCaret 函数 (winuser.h)

使插入点在屏幕上的当前位置显示插入点。 当插入点变为可见时,它会自动开始闪烁。

语法

BOOL ShowCaret(
  [in, optional] HWND hWnd
);

参数

[in, optional] hWnd

类型:HWND

拥有插入符号的窗口的句柄。 如果此参数为 NULL则 ShowCaret 在当前任务中搜索拥有插入点的窗口。

返回值

类型: BOOL

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

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

注解

ShowCaret 仅当指定窗口拥有插入点、插入符号具有形状且插入点未在一行中隐藏两次或多次时才显示插入点。 如果未满足其中一个或多个条件, 则 ShowCaret 不执行任何操作,并返回 FALSE

隐藏是累积性操作。 如果应用程序连续调用 HideCaret 五次,则它还必须在插入点重新出现之前调用 ShowCaret 五次。

系统为每个队列提供一个插入点。 仅当窗口具有键盘焦点或处于活动状态时,才应创建插入点。 窗口应在失去键盘焦点或变为非活动状态之前销毁插入符号。

示例

有关示例,请参阅 创建和显示插入点

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8 中引入的 ext-ms-win-ntuser-caret-l1-1-0 ()

另请参阅

插入符号

概念性

CreateCaret

DestroyCaret

GetCaretPos

HideCaret

引用

SetCaretPos