Files
uTools-Manuals/src/docs/win32api/CreateCaret.html
2020-06-06 20:39:00 +08:00

22 lines
2.7 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
函数功能;该函数为系统插入标记创建一个新的形状,并且将插入标记的属主关系指定给特定的窗口。插入标记的形状。可以是线、块或位图。<br>
<h3>函数原型</h3>BOOL CreateCaretHWND hWndHBIBMAP hBitmapint nHeight <br>
<h3>参数</h3>
hWnd指定佣有插入标记的窗口。<br>
hBitmap标识用于定义插入标记形状的位图。如果该参数为NULL那么插入标记是实心的原色如果该参数为HBITMAP1那么插入标记是灰色的。如果该参数是位图句柄那么插入标记就是指定的位图。位图句栖必须已中由CreateBitmap、CreatDIBitmap或LoadBitmap函数创建。<br>
如果hBitmap为位图句栖那么CreateCaret函数将忽略参数nWidth和nHeight因为该位图定义了自己的宽度和高度。<br>
nWidth按逻辑单位指定插入标记的宽度如果该参数为零那么宽度就设为系统定义的窗口边界宽度。如果hBitmap是位图句柄那么函数CreateCaret忽略该参数。<br>
nHeight按逻辑单位指定插入标记的高度。如果该参数为零那么高度就设为系统定义的窗口边界高度如果hBitmap是位图句柄那么函数CreateCaret忽略该参数。<br>
<h3>返回值</h3>如果函数执行成功,返回值为非零;如果函数执行失败,那么返回值为零。若想获取更多错误 信息请调用GetLastError函数。<br>
备注参数nWidth和nHeight指定了插入标记的宽度和高度这些值按逻辑单位表示按像素表示的真正 宽度和高度与窗口的映射模式有关。<br>
CreateCaret函数自动清除前一个插入标记的形状不考虑拥有该插入标记的窗口。新创建的插入标记一直隐藏直到应用程序调用ShowCaret函数使该插入标记可见为止。<br>
系统为每个队列提供一个插入标记。窗口只有在它有键盘焦点focus或者它是活动窗口时才创建插入标记。该窗口应在键盘焦点消失或窗口变为不活动之前清除插入标记。<br>
可以通过使用GetSystemMetrics函数并指定SM_CXBORDER和SM_CYBORDER值来检索系统窗口边界的宽度或高度。使用窗口边界的宽度或高度可以保证插入标记在高分辨率屏幕上可见。<br>
对于Windows CEWindows CE不支持hBitmap参数并且该参数应设为NULL。Windows CE缺省的是实心Solid插入标记。<br>
速查:Windows NT:3.1及以上版本;Windows:95及以上版本Windows CE:1.0及以上版本头文件winuser.h库文件:user32.lib。<br>
</body>
</html>