如果此窗口是可见的,则将此窗口置于前端,并可以将其设为焦点 window。
将此窗口放在堆栈顺序的顶层,并在此虚拟机中显示在所有其他窗口的上面。如果此窗口不可见,则不会发生任何操作。有些平台不允许拥有其他窗口的窗口显示在它所拥有的窗口之上。有些平台可能不允许此虚拟机将其窗口放在本机应用程序窗口或其他虚拟机窗口之上。此权限可能取决于此虚拟机中的窗口是否已被设为焦点窗口。将进行所有尝试来移动此窗口,使其位于堆栈顺序中尽可能靠前的位置;但是,开发人员不应假定此方法在所有情况下都可以将此窗口移到所有其他窗口之上。
由于本机窗口系统多种多样,因此无法保证对焦点窗口和活动窗口的更改能够实现。在此窗口接收 window_gained_focus 或 window_activated 事件之前,开发人员不得假定此窗口是焦点窗口或活动窗口。在顶层窗口是焦点窗口的平台上,此方法可能使此窗口成为焦点窗口(如果它还不是焦点窗口)。在堆栈顺序通常不影响焦点窗口的平台上,此方法可能维持焦点窗口和活动窗口不变。
如果此方法导致此窗口成为焦点窗口,而且此窗口是一个 frame 或 dialog,则它也将被激活。如果此窗口是焦点窗口,但它不是一个 frame 或 dialog,则拥有此窗口的第一个 frame 或 dialog 将被激活。
如果此窗口被模式对话框 (modal dialog) 阻塞,则阻塞对话框将置于最前端,仍然处于被阻塞窗口的前方。
- 另请参见:
toback()