FillConsoleOutputCharacter 함수

아티클
10/23/2023

Important

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

지정된 좌표에서 시작하여 지정된 횟수만큼 콘솔 화면 버퍼에 문자를 씁니다.

구문

BOOL WINAPI FillConsoleOutputCharacter(
  _In_  HANDLE  hConsoleOutput,
  _In_  TCHAR   cCharacter,
  _In_  DWORD   nLength,
  _In_  COORD   dwWriteCoord,
  _Out_ LPDWORD lpNumberOfCharsWritten
);

매개 변수

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

cCharacter [in]
콘솔 화면 버퍼에 쓸 문자입니다.

nLength [in]
문자를 쓸 문자 셀의 수입니다.

dwWriteCoord [in]
문자를 쓸 첫 번째 셀의 문자 좌표를 지정하는 COORD 구조체입니다.

lpNumberOfCharsWritten [out]
콘솔 화면 버퍼에 실제로 기록된 문자 수를 받는 변수에 대한 포인터입니다.

반환 값

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

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

설명

작성할 문자 수가 콘솔 화면 버퍼에서 지정된 행의 끝까지 확장되면 문자가 다음 행에 기록됩니다. 쓸 문자 수가 콘솔 화면 버퍼의 끝을 넘어 확장되는 경우 문자는 콘솔 화면 버퍼의 끝까지 기록됩니다.

작성된 위치의 특성 값은 변경되지 않습니다.

이 함수는 콘솔의 현재 코드 페이지에서 유니코드 문자 또는 8비트 문자를 사용합니다. 콘솔의 코드 페이지는 처음에 기본적으로 시스템의 OEM 코드 페이지로 설정됩니다. 콘솔의 코드 페이지를 변경하려면 SetConsoleCP 또는 SetConsoleOutputCP 함수를 사용합니다. 레거시 소비자는 chcp 또는 mode con cp select= 명령을 사용할 수도 있지만 새로운 개발에는 추천되지 않습니다.

팁

이 API는 권장되지 않으며 해당하는 특정 가상 터미널 이 없습니다. 볼 수 있는 창 외부의 지역 채우기는 지원되지 않으며 터미널의 기록 공간에 예약되어 있습니다. 표시되는 영역을 새 텍스트 또는 색으로 채우는 작업은 커서를 이동하고, 새 특성을 설정한 다음, 해당 영역에 대해 원하는 텍스트를 작성한 다음, 채우기 실행 길이에 필요한 경우 문자를 반복하여 수행됩니다. 직사각형 영역을 채우기 위해 원하는 텍스트를 작성하여 추가 커서 이동이 필요할 수 있습니다. 클라이언트 애플리케이션은 화면에 있는 내용에 대한 자체 메모리를 유지해야 하며 원격 상태를 쿼리할 수 없습니다. 자세한 내용은 클래식 콘솔과 가상 터미널 설명서에서 찾을 수 있습니다.

요구 사항


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