ShowCaret 함수(winuser.h)

아티클
08/28/2023

caret의 현재 위치에 있는 화면에 캐리트를 표시합니다. 캐리트가 표시되면 자동으로 깜박이기 시작합니다.

구문

BOOL ShowCaret(
  [in, optional] HWND hWnd
);

매개 변수

[in, optional] hWnd

형식: HWND

캐리트를 소유하는 창에 대한 핸들입니다. 이 매개 변수가 NULL인 경우 ShowCaret 는 현재 작업에서 캐리트를 소유하는 창을 검색합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

ShowCaret 는 지정된 창이 캐리트를 소유하고, 캐리트에 셰이프가 있고, 캐리트가 한 행에 두 번 이상 숨겨지지 않은 경우에만 캐리트를 표시합니다. 이러한 조건 중 하나 이상이 충족되지 않으면 ShowCaret 에서 아무 것도 수행하지 않고 FALSE를 반환합니다.

숨기기는 누적됩니다. 애플리케이션이 HideCaret 를 5번 연속으로 호출하는 경우 캐리트가 다시 나타나기 전에 ShowCaret 를 5번 호출해야 합니다.

시스템은 큐당 하나의 케어를 제공합니다. 창은 키보드 포커스가 있거나 활성 상태인 경우에만 캐리트를 만들어야 합니다. 키보드 포커스를 잃거나 비활성 상태가 되기 전에 창에서 캐리트를 제거해야 합니다.

예제

예제는 Caret 만들기 및 표시를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-caret-l1-1-0(Windows 8에서 도입)