SetConsoleCursorPosition 함수

아티클
12/13/2023

Important

이 문서에서는 더 이상 에코시스템 로드맵의 일부가 되지 않는 콘솔 플랫폼 기능에 대해 설명합니다. 이 콘텐츠를 신제품에서 사용하지 않는 것이 좋지만, 무기한 앞으로도 기존 사용을 계속 지원할 것입니다. 선호하는 최신 솔루션은 플랫폼 간 시나리오에서 최대 호환성을 위해 가상 터미널 시퀀스에 중점을 둡니다. 이 디자인 결정에 대한 자세한 내용은 클래식 콘솔과 가상 터미널 문서에서 확인할 수 있습니다.

지정된 콘솔 화면 버퍼에서 커서 위치를 설정합니다.

구문

BOOL WINAPI SetConsoleCursorPosition(
  _In_ HANDLE hConsoleOutput,
  _In_ COORD  dwCursorPosition
);

매개 변수

hConsoleOutput [in]
콘솔 화면 버퍼에 대한 핸들입니다. 핸들에는 GENERIC_READ 액세스 권한이 있어야 합니다. 자세한 내용은 콘솔 버퍼 보안 및 액세스 권한을 참조하세요.

dwCursorPosition [in]
새 커서 위치를 문자 단위로 지정하는 COORD 구조체입니다. 좌표는 화면 버퍼 문자 셀의 열과 행입니다. 좌표는 콘솔 화면 버퍼의 경계 내에 있어야 합니다.

반환 값

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

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

설명

커서 위치는 WriteFile 또는 WriteConsole 함수에서 작성하거나 ReadFile 또는 ReadConsole 함수에 의해 에코되는 문자가 표시되는 위치를 결정합니다. 커서의 현재 위치를 확인하려면 GetConsoleScreenBufferInfo 함수를 사용합니다.

새 커서 위치가 콘솔 화면 버퍼 창의 경계 내에 없는 경우 창 원본이 변경되어 커서가 표시됩니다.

팁

이 API에는 간단한 커서 위치 지정 및 커서 위치 지정 섹션에 해당하는 가상 터미널이 있습니다. 줄 바꿈, 캐리지 리턴, 백스페이스 및 탭 컨트롤 시퀀스를 사용하면 커서 위치를 지정할 수도 있습니다.

예제

예를 들어 상위 수준 입력 및 출력 함수 사용을 참조 하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	ConsoleApi2.h(WinCon.h를 통해 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll