CreateCaret

CreateCaret函式原型OOL CreateCaret，功能：為系統插入標記創建一個新的形狀，並且將插入標記的屬主關係指定給特定的視窗。

基本介紹

• 外文名：CreateCaret
• 函式原型：OOL CreateCaret
• hWnd：指定擁有插入標記的視窗。
• hBitmap：標識用於定義插入標記形狀的點陣圖

函式功能

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

函式原型：BOOL CreateCaret（HWND hWnd，HBITMAP hBitmap，int nWidth，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。