상위 수준 콘솔 함수의 동작은 콘솔 입력 및 출력 모드의 영향을 받습니다. 콘솔을 만들 때 콘솔의 입력 버퍼에 대해 다음 콘솔 입력 모드를 모두 사용할 수 있습니다.
- 줄 입력 모드
- 처리된 입력 모드
- 에코 입력 모드
다음 콘솔 출력 모드는 모두 콘솔 화면 버퍼를 만들 때 사용하도록 설정됩니다.
- 처리된 출력 모드
- EOL 출력 모드에서 래핑
처리된 출력 모드와 함께 세 가지 입력 모드가 모두 함께 작동하도록 설계되었습니다. 이러한 모든 모드를 그룹으로 사용하거나 사용하지 않도록 설정하는 것이 가장 좋습니다. 모든 기능을 사용하도록 설정하면 애플리케이션이 "조리됨" 모드라고 합니다. 즉, 대부분의 처리가 애플리케이션에 대해 처리됩니다. 모두 사용하지 않도록 설정하면 애플리케이션이 "원시" 모드로 전환됩니다. 즉, 입력이 필터링되지 않고 모든 처리가 애플리케이션에 남아 있습니다.
애플리케이션은 GetConsoleMode 함수를 사용하여 콘솔의 입력 버퍼 또는 화면 버퍼의 현재 모드를 결정할 수 있습니다. SetConsoleMode 함수에서 다음 값을 사용하여 이러한 모드를 사용하거나 사용하지 않도록 설정할 수 있습니다. 한 화면 버퍼의 출력 모드를 설정해도 다른 화면 버퍼의 출력 모드에는 영향을 주지 않습니다.
hConsoleHandle 매개 변수가 입력 핸들인 경우 모드는 다음 값 중 하나 이상이 될 수 있습니다. 콘솔을 만들면 ENABLE_WINDOW_INPUT 및 ENABLE_VIRTUAL_TERMINAL_INPUT 제외한 모든 입력 모드가 기본적으로 사용하도록 설정됩니다.
| 가치 | 의미 |
|---|---|
| ENABLE_ECHO_INPUT 0x0004 | ReadFile 또는 ReadConsole 함수에서 읽은 문자는 콘솔에 입력될 때 활성 화면 버퍼에 기록됩니다. 이 모드는 ENABLE_LINE_INPUT 모드도 사용하도록 설정된 경우에만 사용할 수 있습니다. |
| ENABLE_INSERT_MODE 0x0020 | 사용하도록 설정하면 콘솔 창에 입력한 텍스트가 현재 커서 위치에 삽입되고 해당 위치 뒤의 모든 텍스트를 덮어쓰지 않습니다. 사용하지 않도록 설정하면 다음 텍스트를 모두 덮어씁니다. |
| ENABLE_LINE_INPUT 0x0002 | ReadFile 또는 ReadConsole 함수는 캐리지 리턴 문자를 읽을 때만 반환됩니다. 이 모드를 사용하지 않도록 설정하면 하나 이상의 문자를 사용할 수 있으면 함수가 반환됩니다. |
| ENABLE_MOUSE_INPUT 0x0010 | 마우스 포인터가 콘솔 창의 테두리 내에 있고 창에 키보드 포커스가 있는 경우 마우스 이동 및 단추 누름으로 생성된 마우스 이벤트가 입력 버퍼에 배치됩니다. 이러한 이벤트는 이 모드를 사용하는 경우에도 ReadFile 또는 ReadConsole에서 삭제됩니다. ReadConsoleInput 함수를 사용하여 입력 버퍼에서 MOUSE_EVENT 입력 레코드를 읽을 수 있습니다. |
| ENABLE_PROCESSED_INPUT 0x0001 | Ctrl+C는 시스템에서 처리되며 입력 버퍼에 배치되지 않습니다. ReadFile 또는 ReadConsole에서 입력 버퍼를 읽는 경우 다른 컨트롤 키는 시스템에서 처리되며 ReadFile 또는 ReadConsole 버퍼에서 반환되지 않습니다. ENABLE_LINE_INPUT 모드도 사용하도록 설정되면 백스페이스, 캐리지 리턴 및 줄 바꿈 문자가 시스템에서 처리됩니다. |
| ENABLE_QUICK_EDIT_MODE 0x0040 | 이 플래그를 사용하면 사용자가 마우스를 사용하여 텍스트를 선택하고 편집할 수 있습니다. 이 모드를 사용하려면 .를 사용합니다 ENABLE_QUICK_EDIT_MODE | ENABLE_EXTENDED_FLAGS. 이 모드를 사용하지 않도록 설정하려면 이 플래그 없이 ENABLE_EXTENDED_FLAGS 사용합니다. |
| ENABLE_WINDOW_INPUT 0x0008 | 콘솔 화면 버퍼의 크기를 변경하는 사용자 상호 작용은 콘솔의 입력 버퍼에 보고됩니다. 이러한 이벤트에 대한 정보는 ReadConsoleInput 함수를 사용하는 애플리케이션에서 입력 버퍼에서 읽을 수 있지만 ReadFile 또는 ReadConsole을 사용하는 경우에는 읽을 수 없습니다. |
| ENABLE_VIRTUAL_TERMINAL_INPUT 0x0200 | 이 플래그를 설정하면 가상 터미널 처리 엔진이 콘솔 창에서 받은 사용자 입력을 ReadFile 또는 ReadConsole 함수를 통해 지원 애플리케이션에서 검색할 수 있는 콘솔 가상 터미널 시퀀스로 변환합니다. 이 플래그의 일반적인 사용은 출력 핸들의 ENABLE_VIRTUAL_TERMINAL_PROCESSING 함께 가상 터미널 시퀀스를 통해서만 통신하는 애플리케이션에 연결하기 위한 것입니다. |
hConsoleHandle 매개 변수가 화면 버퍼 핸들인 경우 모드는 다음 값 중 하나 이상이 될 수 있습니다. 화면 버퍼가 만들어지면 기본적으로 두 출력 모드가 모두 사용하도록 설정됩니다.
| 가치 | 의미 |
|---|---|
| ENABLE_PROCESSED_OUTPUT 0x0001 | WriteFile 또는 WriteConsole 함수로 작성되거나 ReadFile 또는 ReadConsole 함수에 의해 에코되는 문자는 ASCII 컨트롤 시퀀스에 대해 구문 분석되며 올바른 작업이 수행됩니다. 백스페이스, 탭, 벨, 캐리지 리턴 및 줄 바꿈 문자가 처리됩니다. 컨트롤 시퀀스를 사용하거나 ENABLE_VIRTUAL_TERMINAL_PROCESSING 설정된 경우 사용하도록 설정해야 합니다. |
| ENABLE_WRAP_AT_EOL_OUTPUT 0x0002 | WriteFile 또는 WriteConsole로 쓰거나 ReadFile 또는 ReadConsole로 에코하는 경우 커서는 현재 행의 끝에 도달하면 다음 행의 시작 부분으로 이동합니다. 이렇게 하면 콘솔 창에 표시된 행이 커서가 창의 마지막 행을 넘어가면 자동으로 위로 스크롤됩니다. 또한 콘솔 화면 버퍼의 내용이 위로 스크롤됩니다(.). 콘솔 화면 버퍼의 맨 위 행 삭제) 커서가 콘솔 화면 버퍼의 마지막 행을 넘어가면 이 모드를 사용하지 않도록 설정하면 행의 마지막 문자를 후속 문자로 덮어씁니다. |
| ENABLE_VIRTUAL_TERMINAL_PROCESSING 0x0004 |
WriteFile 또는 WriteConsole을 사용하여 작성할 때 문자는 VT100 및 커서 이동, 색/글꼴 모드 및 기존 콘솔 API를 통해 수행할 수 있는 기타 작업을 제어하는 유사한 컨트롤 문자 시퀀스에 대해 구문 분석됩니다. 자세한 내용은 콘솔 가상 터미널 시퀀스를 참조하세요. 이 플래그를 사용할 때 ENABLE_PROCESSED_OUTPUT 설정되어 있는지 확인합니다. |
| DISABLE_NEWLINE_AUTO_RETURN 0x0008 |
WriteFile 또는 WriteConsole을 사용하여 쓸 때 커서 이동 및 버퍼 스크롤 작업을 지연시킬 수 있는 줄 끝 래핑에 추가 상태를 추가합니다. 일반적으로 ENABLE_WRAP_AT_EOL_OUTPUT 설정되고 텍스트가 줄 끝에 도달하면 커서가 즉시 다음 줄로 이동하고 버퍼의 내용이 한 줄 위로 스크롤됩니다. 이 플래그 집합과 달리 커서는 다음 줄로 이동하지 않으며 스크롤 작업이 수행되지 않습니다. 쓴 문자는 줄의 최종 위치에 인쇄되고 커서는 ENABLE_WRAP_AT_EOL_OUTPUT 꺼진 것처럼 이 문자 위에 남아 있지만 다음 인쇄 가능한 문자는 ENABLE_WRAP_AT_EOL_OUTPUT 있는 것처럼 인쇄됩니다. 덮어쓰기가 발생하지 않습니다. 특히 커서가 다음 줄로 빠르게 이동하고, 필요한 경우 스크롤이 수행되고, 문자가 인쇄되고, 커서가 한 개 더 앞으로 이동합니다. 이 플래그의 일반적인 사용은 화면에 최종 문자를 쓰는 터미널 에뮬레이터를 더 잘 에뮬레이트하기 위해 ENABLE_VIRTUAL_TERMINAL_PROCESSING 설정과 함께 사용됩니다(.). 바로 스크롤을 트리거하지 않고 오른쪽 아래 모서리에 있는 /in the desired 동작입니다. |
| ENABLE_LVB_GRID_WORLDWIDE 0x0010 |
WriteConsoleOutput 및 WriteConsoleOutputAttribute를 비롯한 문자 특성을 작성하기 위한 API를 사용하면 문자 특성의 플래그를 사용하여 텍스트의 전경색과 배경을 조정할 수 있습니다. 또한 DBCS 플래그의 범위는 COMMON_LVB 접두사로 지정되었습니다. 지금까지 이러한 플래그는 중국어, 일본어 및 한국어에 대한 DBCS 코드 페이지에서만 작동했습니다. 선행 바이트 및 후행 바이트 플래그를 제외하고 나머지 플래그는 선 그리기 및 역방향 비디오(.)를 설명합니다. /swap 전경색 및 배경색)은 다른 언어에서 출력 부분을 강조하는 데 유용할 수 있습니다. 이 콘솔 모드 플래그를 설정하면 모든 언어의 모든 코드 페이지에서 이러한 특성을 사용할 수 있습니다. 기본적으로 CJK가 아닌 컴퓨터에서 이러한 플래그를 무시하고 콘솔을 이용한 알려진 애플리케이션과의 호환성을 유지하여 자신의 목적이나 실수로 이러한 필드에 비트를 저장하는 것은 기본적으로 해제되어 있습니다. ENABLE_VIRTUAL_TERMINAL_PROCESSING 모드를 사용하면 연결된 애플리케이션이 콘솔 가상 터미널 시퀀스를 통해 밑줄 또는 역 비디오를 요청하는 경우 이 플래그가 꺼져 있는 동안 LVB 그리드 및 역방향 비디오 플래그가 설정될 수 있습니다. |