CreateCaret

CreateCaret

CreateCaret函式原型OOL 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。

相關詞條

相關搜尋

熱門詞條

聯絡我們