ShowCaret

  BOOL ShowCaret(hwnd)    
  HWND hwnd; /* handle of window with caret */

This function shows the caret on the display at the caret's current position. Once shown, the caret begins flashing automatically.

The ShowCaret function shows the caret only if it has a current shape and has not been hidden two or more times in a row. If the caret is not owned by the given window, the caret is not shown. If the hwnd parameter is NULL, the SetCaret function shows the caret only if it is owned by a window in the current task.

Hiding the caret is accumulative. If the HideCaret function has been called five times in a row, ShowCaret must be called five times to show the caret.

Parameters

hwnd

Identifies the window that owns the caret, or is NULL to specify indirectly the owner window in the current task.

Return Value

TRUE is returned for success, FALSE for failure.

Comments

The caret is a shared resource. A window should show the caret only when it has the keyboard focus or is active.

See Also

HideCaret, CreateCaret, DestroyCaret, GetCaretPos, SetCaretPos