If this Window is visible, brings this Window to the front and may make
it the focused Window.
Places this Window at the top of the stacking order and shows it in
front of any other Windows in this VM. No action will take place if this
Window is not visible. Some platforms do not allow Windows which own
other Windows to appear on top of those owned Windows. Some platforms
may not permit this VM to place its Windows above windows of native
applications, or Windows of other VMs. This permission may depend on
whether a Window in this VM is already focused. Every attempt will be
made to move this Window as high as possible in the stacking order;
however, developers should not assume that this method will move this
Window above all other windows in every situation.
Because of variations in native windowing systems, no guarantees about
changes to the focused and active Windows can be made. Developers must
never assume that this Window is the focused or active Window until this
Window receives a WINDOW_GAINED_FOCUS or WINDOW_ACTIVATED event. On
platforms where the top-most window is the focused window, this method
will probably focus this Window, if it is not already focused. On
platforms where the stacking order does not typically affect the focused
window, this method will probably leave the focused and active
If this method causes this Window to be focused, and this Window is a
Frame it will also become activated. If this Window is
focused, but it is not a Frame then the first Frame that is an owner of this Window will be activated.