windows - 未记录的控制台输入模式标志

Question

我正在 Rust 中开发我的库，以便使用 Windows API 在终端中制作 GUI。

当我实现获取和设置控制台模式时，我注意到输入模式的默认值为 503。我去检查 documentation对于标志，但没有记录值 128 和 256，没有它们就无法获得 503。

无论哪种方式，它们都是默认启用的，如文档中所述:

When a console is created, all input modes except ENABLE_WINDOW_INPUT and ENABLE_VIRTUAL_TERMINAL_INPUT are enabled by default.

当包含 128 和 256 时，计算结果为 503，即我得到的值!

这两个标志是微软不想记住的过去的事情吗？他们的职能是什么？

我已经在互联网上查找过，但找不到有关文档中缺少的两个标志的任何注释。

Answer 1

模式是一个位掩码。整数值 503 包含以下标志，如 wincon.h 和 consoleapi.h 中定义:

0x0001 ENABLE_PROCESSED_INPUT
0x0002 ENABLE_LINE_INPUT
0x0004 ENABLE_ECHO_INPUT
0x0010 ENABLE_MOUSE_INPUT
0x0020 ENABLE_INSERT_MODE
0x0040 ENABLE_QUICK_EDIT_MODE
0x0080 ENABLE_EXTENDED_FLAGS
0x0100 ENABLE_AUTO_POSITION

您询问的两个标志是ENABLE_EXTENDED_FLAGS和ENABLE_AUTO_POSITION。

我在 MSDN 上能找到的唯一提及 ENABLE_EXTENDED_FLAGS 的内容是 SetConsoleMode()文档:

Value	Meaning
ENABLE_QUICK_EDIT_MODE 0x0040	This flag enables the user to use the mouse to select and edit text. To enable this mode, use ENABLE_QUICK_EDIT_MODE | ENABLE_EXTENDED_FLAGS. To disable this mode, use ENABLE_EXTENDED_FLAGS without this flag.

参见How to disable user selection in Windows console举个例子。

MSDN 上未记录

ENABLE_AUTO_POSITION。我在网上唯一能找到的就是以下简介:

https://txwizard.github.io/WizardWrx_NET_API/api/WizardWrx.ConsoleStreams.StandardHandleInfo.ConsoleModes.html

Name	Description
ENABLE_AUTO_POSITION	Though defined in WinCon.h, this flag is otherwise undocumented. My initial best guess is that it is related to the "Let system position window" check box on the property sheet of a CMD.EXE window, though I have yet to test this theory.

同一页面还提到了ENABLE_EXTENDED_FLAGS:

Name	Description
ENABLE_EXTENDED_FLAGS	Required to enable or disable extended flags. See ENABLE_INSERT_MODE and ENABLE_QUICK_EDIT_MODE.
ENABLE_INSERT_MODE	When enabled, text entered in a console window will be inserted at the current cursor location and all text following that location will not be overwritten. When disabled, all following text will be overwritten. To enable this mode, use ENABLE_INSERT_MODE | ENABLE_EXTENDED_FLAGS. To disable this mode, use ENABLE_EXTENDED_FLAGS without this flag.
ENABLE_QUICK_EDIT_MODE	This flag enables the user to use the mouse to select and edit text. To enable this mode, use ENABLE_QUICK_EDIT_MODE | ENABLE_EXTENDED_FLAGS. To disable this mode, use ENABLE_EXTENDED_FLAGS without this flag.