设置此窗口是否应该始终位于其他窗口上方。如果存在多个 always-on-top 窗口,则它们的相对顺序没有指定,该顺序与平台有关。
如果某个其他窗口已经是 always-on-top,则不指定这些窗口之间的相互顺序(与平台有关)。任何窗口都不会置于 always-on-top 窗口之上,除非它也是一个 always-on-top 窗口。
所有 always-on-top 窗口拥有的窗口将继承此状态,自动成为 always-on-top 窗口。如果某个窗口不再是 always-on-top 窗口,则它所拥有的窗口也不再是 always-on-top 窗口。当 always-on-top 窗口调用 toback
时,其 always-on-top 状态将设置为 false
。
如果对某个窗口调用此方法且参数值为 true
,并且该窗口可见,平台也支持此窗口为 always-on-top,那么该窗口将立即向前,“锁定”在最顶层位置。如果窗口当前不可见,那么此方法将 always-on-top 状态设置为 true
,但窗口不会向前。如果以后显示该窗口,那么它将 always-on-top。
如果 alwaysontop
为 true
,则此方法可使窗口 always-on-top。如果窗口是可见的(这包括将窗口前置,即 tofront
),则将其“锁定”在最顶层的位置。如果窗口不可见,则除了设置 always-on-top 的属性之外,不执行任何操作。如果以后窗口显示出来,则该窗口将 always-on-top。如果窗口已经位于顶层,则此调用不执行任何操作。
如果对某个窗口调用此方法且参数值为 false
,则 always-on-top 状态被设置为常规。该窗口保持在最顶层,但对于任何其他窗口来说,其 z-order 可以更改。对已经是常规状态的窗口调用此方法且参数值为 false
将无效。如果没有其他 always-on-top 窗口,将 always-on-top 状态设置为 false 对窗口的相对 z-order 没有影响。
注:有些平台可能不支持 always-on-top 窗口。要检测当前平台是否支持 always-on-top 窗口,请使用 toolkit.isalwaysontopsupported()
和 isalwaysontopsupported()
。如果工具包或此窗口不支持 always-on-top 模式,则调用此方法无效。
如果安装了 securitymanager,则必须授予调用线程 awtpermission "setwindowalwaysontop"
iis7站长之家,才能设置此属性值。如果未授予此权限,则此方法将抛出 securityexception,并且属性的当前值保持不变。
- 参数:
alwaysontop
- 如果窗口应该始终位于其他窗口上方,则该参数为 true
- 抛出:
securityexception
- 如果调用线程无权设置 always-on-top 属性值。- 从以下版本开始:
- 1.5
- 另请参见:
isalwaysontop()
,
tofront()
,
toback()
,
awtpermission
,
isalwaysontopsupported()
,
toolkit.isalwaysontopsupported()