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)