共用方式為


關於插入符號

系統會為每個消息佇列提供一個插入號。 只有當視窗具備鍵盤焦點或為活躍狀態時,它才應該建立插入號。 窗口應該在失去鍵盤焦點或變成非使用中之前,先銷毀插入號。 如需鍵盤輸入的詳細資訊,請參閱 鍵盤輸入

使用 CreateCaret 函式來指定插入號的參數。 系統會透過反轉游標位置、寬度和高度所指定矩形內的像素色彩來形成游標。 寬度和高度是以邏輯單位指定的,因此,插入符的外觀受限於視窗的映射模式。

本節將討論下列主題。

光標可見度

定義插入號之後,使用 ShowCaret 函數來顯示插入號。 當插入號出現時,它會自動開始閃爍。 為了顯示實心插入號,系統會反轉矩形中的每個圖元;若要顯示灰色插入號,系統會反轉所有其他圖元:若要顯示點陣圖插入號,系統只會反轉點陣圖的白色位。

需要以毫秒為單位來反轉插入號所耗用的時間稱為 閃爍時間。 只要擁有消息佇列的線程有一個訊息幫浦處理消息,插入點就會閃爍。

使用者可以使用 [控制面板] 設定插入號的閃爍時間,而應用程式應該遵循使用者所選擇的設定。 應用程式可以使用 GetCaretBlinkTime 函式來確定插入號的閃爍時間。 如果您要撰寫可讓使用者調整閃爍時間的應用程式,例如控制面板小程式,請使用 SetCaretBlinkTime 函式,將閃爍時間的速率設定為指定的毫秒數。

閃爍時間 是顯示、反轉和還原插入號顯示器所需的耗用時間,以毫秒為單位。 游標閃爍的時間是閃動時間的兩倍。

插入點位置

您可以使用 getCaretPos函式來判斷插入號的位置。 在用戶端座標中的位置會被複製到由 GetCaretPos中的參數所指定的結構中。 應用程式可以使用 SetCaretPos 函式,在視窗中移動插入號。 只有當視窗已經擁有插入號時,視窗才能移動插入號。 SetCaretPos 可以移動游標,無論是否可見。

拿掉插入號

您可以藉由隱藏插入號來暫時移除插入號,也可以藉由終結插入號來永久移除插入號。 若要隱藏插入號,請使用 HideCaret 函式。 當您的應用程式在處理訊息時必須重新繪製畫面,避免插入點干擾,這非常有用。 當應用程式完成繪圖時,可以再次使用 ShowCaret 函式顯示插入號。 隱藏游標不會破壞其形狀或使插入點無效。 隱藏插入號是累計的;也就是說,如果應用程式呼叫 HideCaret 5 次,它也必須呼叫 showCaret 五次,才會重新出現插入號。

若要從畫面移除插入號並銷毀其形狀,請使用 DestroyCaret 函式。 DestroyCaret 只有在目前工作所涉及的視窗擁有插入號時,才會銷毀插入號。