CreateCaret

該函數為系統插入標記創建一個新的形狀，並且將插入標記的屬主關係指定給特定的窗口。插入標記的形狀。可以是線、塊或點陣圖。

函數原型：BOOL CreateCaret（HWND hWnd，HBIBMAP hBitmap，int nHeight）；

hWnd：指定佣有插入標記的窗口。

hBitmap：標識用於定義插入標記形狀的點陣圖。如果該參數為NULL，那麼插入標記是實心的（原色），如果該參數為（HBITMAP）1，那麼插入標記是灰色的。如果該參數是點陣圖句柄，那麼插入標記就是指定的點陣圖。點陣圖句棲必須已中由CreateBitmap、CreatDIBitmap或LoadBitmap函數創建。

如果hBitmap為點陣圖句棲，那麼CreateCaret函數將忽略參數nWidth和nHeight，因為該點陣圖定義了自己的寬度和高度。

nWidth：按邏輯單位指定插入標記的寬度，如果該參數為零，那麼寬度就設為系統定義的窗口邊界寬度。如果hBitmap是點陣圖句柄，那麼函數CreateCaret忽略該參數。

nHeight：按邏輯單位指定插入標記的高度。如果該參數為零，那麼高度就設為系統定義的窗口邊界高度如果hBitmap是點陣圖句柄，那麼函數CreateCaret忽略該參數。

返回值：如果函數執行成功，返回值為非零；如果函數執行失敗，那麼返回值為零。若想獲取更多錯誤 信息，請調用GetLastError函數。

備註：參數nWidth和nHeight指定了插入標記的寬度和高度，這些值按邏輯單位表示；按像素表示的真正 寬度和高度與窗口的映射模式有關。

CreateCaret函數自動清除前一個插入標記的形狀，不考慮擁有該插入標記的窗口。新創建的插入標記一直隱藏，直到應用程序調用ShowCaret函數使該插入標記可見為止。

系統為每個隊列提供一個插入標記。窗口只有在它有鍵盤焦點（focus）或者它是活動窗口時才創建插入標記。該窗口應在鍵盤焦點消失或窗口變為不活動之前，清除插入標記。

可以通過使用GetSystemMetrics函數，並指定SM_CXBORDER和SM_CYBORDER值來檢索系統窗口邊界的寬度或高度。使用窗口邊界的寬度或高度可以保證插入標記在高解析度屏幕上可見。

對於Windows CE：Windows CE不支持hBitmap參數，並且該參數應設為NULL。Windows CE預設的是實心（Solid）插入標記。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本；Windows CE:1.0及以上版本；頭文件：winuser.h；庫文件:user32.lib。