ShowCaret 函式 (winuser.h)
在插入號目前位置的畫面上顯示插入號。 當插入號變成可見時，它會自動開始閃爍。
語法
BOOL ShowCaret(
[in, optional] HWND hWnd
);
參數
[in, optional] hWnd
類型： HWND
擁有插入號之視窗的控制碼。 如果此參數為 Null， ShowCaret 會搜尋目前的工作，尋找擁有插入號的視窗。
傳回值
類型： BOOL
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
ShowCaret 只有在指定的視窗擁有插入號、插入號具有圖案，而且插入號在資料列中未隱藏兩次或多次時，才會顯示插入號。 如果不符合其中一或多個條件， ShowCaret 不會執行任何動作，並傳回 FALSE。
隱藏是累計的。 如果您的應用程式在資料列中呼叫 HideCaret 五次，它也必須在插入號重新出現前呼叫 ShowCaret 5 次。
系統會針對每個佇列提供一個插入號。 只有在視窗具有鍵盤焦點或作用中時，才會建立插入號。 視窗應該會在失去鍵盤焦點或變成非作用中之前終結插入號。
範例
如需範例，請參閱 建立和顯示插入號。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
| API 集合 | ext-ms-win-ntuser-caret-l1-1-0 (在 Windows 8) |
另請參閱
概念
參考