CreatCaret

原文链接 -> 传送门

函数功能：

CreatCaret 函数为系统插入符创建一个新的形状，并且将插入符的所有权指定给特定的窗口。

插入符的形状可以是线条、方块或位图。


API 函数原型：

注释：_In_ 说明该参数是输入的，_In_opt_ 说明该参数是输入同时是可选的。

BOOL WINAPI CreateCaret(
  _In_     HWND    hWnd,
  _In_opt_ HBITMAP hBitmap,
  _In_     int     nWidth,
  _In_     int     nHeight
);

参数解析：
 

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。

若想获得更多的错误信息，请调用 GetLastError 函数。


备注：

1. nWidth 和 nHeight 参数是插入符的宽度和高度，逻辑单位；按像素表示的实际宽度和高度，由窗口的映射模式决定。

2. 如果有插入符的话，CreateCaret 函数自动销毁先前的插入符，对于任何一个拥有插入符的窗口，插入符号默认都是隐藏的，直到应用程序调用 ShowCaret 函数才使其可见。

3. 系统提供为每个队列提供一个插入符，仅当窗口拥有键盘焦点或者是活跃窗口时，插入符才应该被创建。窗口在丢失键盘焦点或变成非活跃窗口应该摧毁插入符。

4. 您可以通过调用 GetSystemMetrics 函数获取系统窗口边框的宽度和高度（指定参数值为 SM_CXBORDER 和 SM_CYBORDER）。使用窗口边框宽度或高度可以确保插入符在高分辨率的屏幕上依然可见。


需求：