| 1 | Note regarding ENABLE_EXTENDED_FLAGS (2016-05-30)
|
| 2 |
|
| 3 | There is a complicated interaction between the ENABLE_EXTENDED_FLAGS flag
|
| 4 | and the ENABLE_QUICK_EDIT_MODE and ENABLE_INSERT_MODE flags (presumably for
|
| 5 | backwards compatibility?). I studied the behavior on Windows 7 and Windows
|
| 6 | 10, with both the old and new consoles, and I didn't see any differences
|
| 7 | between versions. Here's what I seemed to observe:
|
| 8 |
|
| 9 | - The console has three flags internally:
|
| 10 | - QuickEdit
|
| 11 | - InsertMode
|
| 12 | - ExtendedFlags
|
| 13 |
|
| 14 | - SetConsoleMode psuedocode:
|
| 15 | void SetConsoleMode(..., DWORD mode) {
|
| 16 | ExtendedFlags = (mode & (ENABLE_EXTENDED_FLAGS
|
| 17 | | ENABLE_QUICK_EDIT_MODE
|
| 18 | | ENABLE_INSERT_MODE )) != 0;
|
| 19 | if (ExtendedFlags) {
|
| 20 | QuickEdit = (mode & ENABLE_QUICK_EDIT_MODE) != 0;
|
| 21 | InsertMode = (mode & ENABLE_INSERT_MODE) != 0;
|
| 22 | }
|
| 23 | }
|
| 24 |
|
| 25 | - Setting QuickEdit or InsertMode from the properties dialog GUI does not
|
| 26 | affect the ExtendedFlags setting -- it simply toggles the one flag.
|
| 27 |
|
| 28 | - GetConsoleMode psuedocode:
|
| 29 | GetConsoleMode(..., DWORD *result) {
|
| 30 | if (ExtendedFlags) {
|
| 31 | *result |= ENABLE_EXTENDED_FLAGS;
|
| 32 | if (QuickEdit) { *result |= ENABLE_QUICK_EDIT_MODE; }
|
| 33 | if (InsertMode) { *result |= ENABLE_INSERT_MODE; }
|
| 34 | }
|
| 35 | }
|
| 36 |
|
| 37 | Effectively, the ExtendedFlags flags controls whether the other two flags
|
| 38 | are visible/controlled by the user application. If they aren't visible,
|
| 39 | though, there is no way for the user application to make them visible,
|
| 40 | except by overwriting their values! Calling SetConsoleMode with just
|
| 41 | ENABLE_EXTENDED_FLAGS would clear the extended flags we want to read.
|
| 42 |
|
| 43 | Consequently, if a program temporarily alters the QuickEdit flag (e.g. to
|
| 44 | enable mouse input), it cannot restore the original values of the QuickEdit
|
| 45 | and InsertMode flags, UNLESS every other console program cooperates by
|
| 46 | keeping the ExtendedFlags flag set.
|