I am creating a plugin, and I want to be able to programmatically force one of its widgets to be made visible and brought to the front of all others widgets sharing the same docking space (i.e. I want its tab to become the active tab).
If I don’t do this, my plugin will have bad UX because when the user wants to trigger an action that they expect to open the widget, they will instead be confused for a while trying to figure out why the widget didn’t open, and then eventually they will figure out that they need to go and manually open it themselves.
An example of this kind of behaviour being implemented with built-in widgets is how pressing the Ctrl+Shift+F (Find All / Replace All hotkey) will bring the Find All / Replace All widget to the front. i.e. its tab will become the active tab in whatever docking space it is docked in.