Creating a non-modal window from wxHtmlHelpController about wxwidgets

[solemnwarning]

I've done a bit more testing and I think this is due to a misunderstanding I had regarding modal dialogs in wxWidgets - I thought creating a modal dialog only blocked input to the parent window heirarchy, however they generally seem to actually block interaction with all other windows in the application (tested on GTK, Windows and macOS).

So I suppose the wxHtmlHelpController window having to also be modal relative to the creating modal dialog is an unfortunate side-effect of that design... still feels a bit like a bug for both the event binding reason above and not allowing the user to interact with the modal they are trying to read the manual for.

I've changed my settings dialog to be non-modal instead as a workaround. In my unqualified opinion, the best outcome here would be for the help window itself to somehow be a non-modal window which still allows setting up event bindings and the user to interact with modal windows in the program.

[vadz]

This is known as app-model vs window-modal and default modality is app modal because it's expected that ShowModal() only returns when the dialog is dismissed. There is wxDialog::ShowWindowModal() but you'd have to use it for the dialog itself and not (just) the help window.

[solemnwarning]

Thanks for the tip about wxDialog::ShowWindowModal() - I thought that was the behaviour of ShowModal().

I already worked around this problem in my application by making my dialog non-modal, so this is no longer an issue for me, but I tried using ShowWindowModal() and on GTK at least, the resulting dialog is still app-modal rather than window-modal, and the call to wxHTMLHelpController::Display() continues to block until the help window is closed (and blocks interaction with the previous modal dialog).