On Windows, it can be convenient to enable the QuickEdit Mode of a console to select and copy text using the mouse.
When running the Wrapper in a console, this mode should be used with caution, as it may cause your Java application to freeze while some text is highlighted.
This issue can be explained as follows: when a program prints its output, the console keeps scrolling and this makes it difficult for a user to select text. To help the user, the console will stop reading the stdout/stderr of the program as soon as the mouse cursor highlights some text in the console, and this will cause the scrolling to stop. In the case of the Wrapper, this will quickly fill the pipe that reads the output of the Java application, as nothing can be printed out to the console. When the pipe gets full, the Java application can in turn no longer print its output to the inbound of the pipe and then blocks.
In order to resume the reading of stdout/stderr and thus unblock this situation, the user would need to move the cursor out of the console. However, although the QuickEdit Mode can be activated by clicking any content of the console, it is not disabled when clicking out of the console window. The user has to either right click with the mouse or press a key of the keyboard. One might not be aware of the consequences of simply highlighting text in the console, and it is easy to forget to remove the selection properly...
To avoid undesired freezes, the Wrapper will by default deactivate this mode. It is, however, possible to configure a different behavior with the following properties:
This property is processed on startup and makes it possible to enable or disable the QuickEdit Mode of the console attached to the Wrapper process.
Possible values are:
to enable QuickEdit Mode.
to disable QuickEdit Mode.
to leave the mode of the console unchanged.
The default value is DISABLED.
Example (do not change the QuickEdit Mode of the console):
Once the Wrapper stops, the QuickEdit mode will be left as is. If you need to restore it, this can be done from the Properties window of the console.
Alternatively, you may set wrapper.console.quickedit to UNCHANGED and edit the mode from the Properties window after the Wrapper starts. The console will automatically restore it when the Wrapper process stops.
After processing the wrapper.console.quickedit property, the Wrapper will check the status of the QuickEdit Mode and log a warning if it is enabled. This property makes it possible to control the log level at which this warning is printed.