FillConsoleOutputAttribute 함수

아티클
10/23/2023

Important

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

화면 버퍼의 지정된 좌표에서 시작하여 지정된 수의 문자 셀에 대한 문자 특성을 설정합니다.

구문

BOOL WINAPI FillConsoleOutputAttribute(
  _In_  HANDLE  hConsoleOutput,
  _In_  WORD    wAttribute,
  _In_  DWORD   nLength,
  _In_  COORD   dwWriteCoord,
  _Out_ LPDWORD lpNumberOfAttrsWritten
);

매개 변수

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

wAttribute [in]
콘솔 화면 버퍼에 쓸 때 사용할 특성입니다. 자세한 내용은 문자 특성을 참조 하세요.

nLength [in]
지정된 색 특성으로 설정할 문자 셀의 수입니다.

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

lpNumberOfAttrsWritten [out]
특성이 실제로 설정된 문자 셀 수를 받는 변수에 대한 포인터입니다.

반환 값

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

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

설명

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

기록된 위치의 문자 값은 변경되지 않습니다.

팁

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

요구 사항


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