- java.lang.Object
-
- javafx.stage.Window
-
- All Implemented Interfaces:
-
EventTarget
- 已知直接子类:
-
PopupWindow
,Stage
public class Window extends Object implements EventTarget
托管场景的顶层窗口,用户与之交互的顶级窗口。 一个窗口可能是Stage
,PopupWindow
,或其他这样的顶级水平。 窗口也用于基于浏览器插件的部署。必须在JavaFX应用程序线程上构建和修改窗口对象。
JavaFX应用程序线程是作为JavaFX运行时启动过程的一部分而创建的。 有关详细信息,请参阅
Application
类和Platform.startup(Runnable)
方法。- 从以下版本开始:
- JavaFX 2.0
-
-
Property Summary
-
构造方法摘要
构造方法 Modifier Constructor 描述 protected
Window()
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 <T extends Event>
voidaddEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
向此节点注册事件过滤器。<T extends Event>
voidaddEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
向此节点注册事件处理程序。EventDispatchChain
buildEventDispatchChain(EventDispatchChain tail)
为此窗口构建事件调度链。void
centerOnScreen()
在此窗口中设置x和y属性,以便它在curent屏幕上居中。ObjectProperty<EventDispatcher>
eventDispatcherProperty()
指定此节点的事件分派器。void
fireEvent(Event event)
触发指定的事件。ReadOnlyBooleanProperty
focusedProperty()
该Window
是否具有键盘或输入焦点。BooleanProperty
forceIntegerRenderScaleProperty()
当相关的输出比例有变化时,控制系统默认情况下是否设置整数渲染比例的布尔属性。EventDispatcher
getEventDispatcher()
获取属性eventDispatcher的值。double
getHeight()
获取属性高度的值。EventHandler<WindowEvent>
getOnCloseRequest()
获取属性onCloseRequest的值。EventHandler<WindowEvent>
getOnHidden()
获取属性onHidden的值。EventHandler<WindowEvent>
getOnHiding()
获取属性onHiding的值。EventHandler<WindowEvent>
getOnShowing()
获取属性onShowing的值。EventHandler<WindowEvent>
getOnShown()
获取onShown属性的值。double
getOpacity()
获取属性不透明度的值。double
getOutputScaleX()
获取属性outputScaleX的值。double
getOutputScaleY()
获取属性outputScaleY的值。ObservableMap<Object,Object>
getProperties()
返回此节点上属性的可观察图,主要由应用程序开发人员使用。double
getRenderScaleX()
获取属性renderScaleX的值。double
getRenderScaleY()
获取属性renderScaleY的值。Scene
getScene()
获取属性场景的值。Object
getUserData()
返回先前设置的Object属性,如果没有使用setUserData(java.lang.Object)
方法设置此属性,则返回null。double
getWidth()
获取属性宽度的值。static ObservableList<Window>
getWindows()
返回一个包含对当前显示的JavaFX窗口的引用的列表。double
getX()
获取属性x的值。double
getY()
获取属性y的值。boolean
hasProperties()
测试窗口是否具有属性。ReadOnlyDoubleProperty
heightProperty()
这个高度Window
。void
hide()
尝试通过将可见性设置为false来隐藏此窗口。boolean
isFocused()
获取关注的属性的值。boolean
isForceIntegerRenderScale()
获取属性forceIntegerRenderScale的值。boolean
isShowing()
获取显示的属性的值。ObjectProperty<EventHandler<WindowEvent>>
onCloseRequestProperty()
当有外部请求关闭此Window
。ObjectProperty<EventHandler<WindowEvent>>
onHiddenProperty()
在窗口被隐藏之后调用。ObjectProperty<EventHandler<WindowEvent>>
onHidingProperty()
在Window被隐藏之前调用。ObjectProperty<EventHandler<WindowEvent>>
onShowingProperty()
在窗口显示之前调用。ObjectProperty<EventHandler<WindowEvent>>
onShownProperty()
在窗口显示之后调用。DoubleProperty
opacityProperty()
将Window
的不透明度定义为0.0和1.0之间的值。ReadOnlyDoubleProperty
outputScaleXProperty()
Window
将在渲染和将输出合成到屏幕或其他目标设备的所有阶段中应用于水平场景坐标的比例。ReadOnlyDoubleProperty
outputScaleYProperty()
Window
将在渲染和将输出合成到屏幕或其他目标设备的所有阶段中应用于垂直场景坐标的比例。<T extends Event>
voidremoveEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
从此节点注销先前注册的事件过滤器。<T extends Event>
voidremoveEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
从此节点注销先前注册的事件处理程序。DoubleProperty
renderScaleXProperty()
当渲染其Scene
到渲染缓冲区时,Window
将使用的水平刻度。DoubleProperty
renderScaleYProperty()
当渲染Scene
到渲染缓冲区时,Window
将使用的垂直刻度。void
requestFocus()
要求这个Window
得到输入焦点。ReadOnlyObjectProperty<Scene>
sceneProperty()
Scene
将在此呈现Window
。void
setEventDispatcher(EventDispatcher value)
设置属性eventDispatcher的值。protected <T extends Event>
voidsetEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
设置要用于此事件类型的处理程序。void
setForceIntegerRenderScale(boolean forced)
设置属性forceIntegerRenderScale的值。void
setHeight(double value)
设置属性高度的值。void
setOnCloseRequest(EventHandler<WindowEvent> value)
设置属性onCloseRequest的值。void
setOnHidden(EventHandler<WindowEvent> value)
设置属性onHidden的值。void
setOnHiding(EventHandler<WindowEvent> value)
设置属性onHiding的值。void
setOnShowing(EventHandler<WindowEvent> value)
设置属性onShowing的值。void
setOnShown(EventHandler<WindowEvent> value)
设置属性onShown的值。void
setOpacity(double value)
设置属性不透明度的值。void
setRenderScaleX(double scale)
设置属性renderScaleX的值。void
setRenderScaleY(double scale)
设置属性renderScaleY的值。protected void
setScene(Scene value)
设置属性场景的值。void
setUserData(Object value)
用于设置可以在以后检索的单个Object属性的便利方法。void
setWidth(double value)
设置属性宽度的值。void
setX(double value)
设置属性x的值。void
setY(double value)
设置属性y的值。protected void
show()
尝试通过将可见性设置为true来显示此窗口ReadOnlyBooleanProperty
showingProperty()
该Window
是否显示(即在用户系统上打开)。void
sizeToScene()
设置此窗口的宽度和高度以匹配此窗口场景的内容大小。ReadOnlyDoubleProperty
widthProperty()
该宽度为Window
。ReadOnlyDoubleProperty
xProperty()
这个Window
在屏幕上的水平位置。ReadOnlyDoubleProperty
yProperty()
这个Window
在屏幕上的垂直位置。
-
-
-
Property Detail
-
outputScaleX
public final ReadOnlyDoubleProperty outputScaleXProperty
Window
将在渲染和将输出合成到屏幕或其他目标设备的所有阶段中应用于水平场景坐标的比例。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在将窗口移动到
Screen
之前的某个时间点,可能是在更新Screen
属性之前或之后。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
- 另请参见:
-
getOutputScaleX()
-
outputScaleY
public final ReadOnlyDoubleProperty outputScaleYProperty
Window
将适用于垂直场景坐标在渲染和合成输出到屏幕或其他目标设备的所有阶段的规模。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在将窗口移动到新的
Screen
某个时间点,可能在更新Screen
属性之前或之后。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
- 另请参见:
-
getOutputScaleY()
-
forceIntegerRenderScale
public final BooleanProperty forceIntegerRenderScaleProperty
当相关的输出比例有变化时,控制系统默认情况下是否设置整数渲染比例的布尔属性。renderScale
属性将直接更新,并与相关的outputScale
属性中的任何更改同时更新,但可以通过后续调用setRenderScale
设置器或通过适当使用绑定来覆盖这些值。 此属性不会阻止直接使用renderScale
属性对象或方便设置器方法设置非整数值。- Default value:
- 假
- 从以下版本开始:
- 9
- 另请参见:
-
isForceIntegerRenderScale()
,setForceIntegerRenderScale(boolean)
-
renderScaleX
public final DoubleProperty renderScaleXProperty
Window
将其Scene
渲染到渲染缓冲区时将使用的水平刻度。 每当outputScaleX
属性发生更改时,此属性将自动更新,并且可以通过调用setRenderScaleX()
响应outputScaleX
属性上的侦听器或通过适当绑定来覆盖该属性。- Default value:
- outputScaleX
- 从以下版本开始:
- 9
- 另请参见:
-
getRenderScaleX()
,setRenderScaleX(double)
-
renderScaleY
public final DoubleProperty renderScaleYProperty
当渲染其Scene
到渲染缓冲区时,Window
将使用的垂直刻度。 每当outputScaleY
属性发生更改时,该属性将自动更新,可以通过调用setRenderScaleY()
响应outputScaleY
属性上的侦听器或通过适当绑定来覆盖该属性。- Default value:
- outputScaleY
- 从以下版本开始:
- 9
- 另请参见:
-
getRenderScaleY()
,setRenderScaleY(double)
-
x
public final ReadOnlyDoubleProperty xProperty
这个Window
在屏幕上的水平位置。 更改此属性将水平移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。- 另请参见:
-
getX()
,setX(double)
-
y
public final ReadOnlyDoubleProperty yProperty
这个Window
在屏幕上的垂直位置。 更改此属性将垂直移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。- 另请参见:
-
getY()
,setY(double)
-
width
public final ReadOnlyDoubleProperty widthProperty
该宽度为Window
。 更改此属性将缩小或扩大Window
的宽度。 该值包括可由操作系统添加的任何和所有装饰,例如可调整大小的框架句柄。 典型应用将会改变Scene
的宽度。 如果应用程序从未设置此Window
将从场景中获取宽度。 最终用户调整窗口大小不会被视为设置应用程序的宽度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
getWidth()
,setWidth(double)
-
height
public final ReadOnlyDoubleProperty heightProperty
这个高度Window
。 更改此属性将缩小或提高Window
的高度。 该值包括操作系统可能添加的任何和所有装饰,例如标题栏。 典型应用将设置Scene
高度。 如果应用程序从未设置此窗口,则此窗口将从场景中取出高度。 最终用户调整此窗口大小并不算作应用程序设置的高度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
getHeight()
,setHeight(double)
-
focused
public final ReadOnlyBooleanProperty focusedProperty
该Window
是否具有键盘或输入焦点。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
isFocused()
-
scene
public final ReadOnlyObjectProperty<Scene> sceneProperty
Scene
要呈现在这个Window
。 只能有一个Scene
上Window
的时间,并且Scene
只能是一个Window
一次。 设置一个Scene
在不同Window
将导致旧Window
到新的收益之前失去了参考。 您可以Scene
在Window
上互换Scene
,即使是Stage
的实例,并将fullScreen
设置为true。 如果Window
的宽度或高度未被应用程序设置,则设置场景将导致该Window
从该场景中取走其宽度或高度。 最终用户调整此窗口大小并不算作应用程序设置宽度或高度。 如果此属性设置在JavaFX应用程序线程之外的线程上,则抛出一个IllegalStateException
。- Default value:
- 空值
- 另请参见:
-
getScene()
,setScene(Scene)
-
opacity
public final DoubleProperty opacityProperty
将Window
的不透明度定义为0.0和1.0之间的值。 不透明度反映在Window
,其Decoration
及其Scene
内容中。 在不支持不透明度的JavaFX运行时平台上,为此变量分配一个值将没有明显差异。 具有0%不透明度的Window
是完全半透明的。 通常,具有0%不透明度的Window
将不会收到任何鼠标事件。- Default value:
- 1.0
- 另请参见:
-
getOpacity()
,setOpacity(double)
-
onCloseRequest
public final ObjectProperty<EventHandler<WindowEvent>> onCloseRequestProperty
当有外部请求关闭这个Window
。 安装的事件处理程序可以通过消耗接收的事件来阻止关闭窗口。
-
onShowing
public final ObjectProperty<EventHandler<WindowEvent>> onShowingProperty
在窗口显示之前调用。
-
onShown
public final ObjectProperty<EventHandler<WindowEvent>> onShownProperty
在窗口显示之后调用。- 另请参见:
-
getOnShown()
,setOnShown(EventHandler)
-
onHiding
public final ObjectProperty<EventHandler<WindowEvent>> onHidingProperty
在Window被隐藏之前调用。
-
onHidden
public final ObjectProperty<EventHandler<WindowEvent>> onHiddenProperty
在窗口被隐藏之后调用。 当隐藏Window
,调用此事件处理程序,允许开发人员在Window
关闭时清理资源或执行其他任务。
-
showing
public final ReadOnlyBooleanProperty showingProperty
该Window
是否显示(即,在用户系统上打开)。 窗口可能是“显示”,但是由于窗口被渲染在另一个窗口后面或由于窗口被放置在监视器之外,用户可能无法看到它。- Default value:
- 假
- 另请参见:
-
isShowing()
-
eventDispatcher
public final ObjectProperty<EventDispatcher> eventDispatcherProperty
指定此节点的事件分派器。 默认事件调度程序将接收的事件发送到已注册的事件处理程序和过滤器。 当使用新的EventDispatcher
替换值时,新的调度程序应将事件转发到替换的调度程序,以维护节点的默认事件处理行为。
-
-
方法详细信息
-
getWindows
public static ObservableList<Window> getWindows()
返回一个包含对当前显示的JavaFX窗口的引用的列表。 该列表是不可修改的 - 尝试修改此列表将导致在运行时抛出一个UnsupportedOperationException
。- 结果
- 包含当前显示的所有窗口的列表。
- 从以下版本开始:
- 9
-
sizeToScene
public void sizeToScene()
设置此窗口的宽度和高度以匹配此窗口场景的内容大小。
-
centerOnScreen
public void centerOnScreen()
在此窗口中设置x和y属性,以便它在curent屏幕上居中。 当前屏幕是从当前窗口边界和所有屏幕的视觉界限的交集确定的。
-
getOutputScaleX
public final double getOutputScaleX()
获取属性outputScaleX的值。- Property description:
-
Window
将在渲染和将输出合成到屏幕或其他目标设备的所有阶段中应用于水平场景坐标的比例。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在将窗口移动到新的
Screen
,可能在更新Screen
属性之前或之后。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
-
outputScaleXProperty
public final ReadOnlyDoubleProperty outputScaleXProperty()
Window
将在渲染和将输出合成到屏幕或其他目标设备的所有阶段中应用于水平场景坐标的比例。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在将窗口移动到新的
Screen
,可能在更新Screen
属性之前或之后。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
- 另请参见:
-
getOutputScaleX()
-
getOutputScaleY
public final double getOutputScaleY()
获取属性outputScaleY的值。- Property description:
-
Window
将适用于垂直场景坐标在渲染和合成输出到屏幕或其他目标设备的所有阶段的规模。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在移动窗口的某个时候,
Screen
可能在更新Screen
属性之前或之后。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
-
outputScaleYProperty
public final ReadOnlyDoubleProperty outputScaleYProperty()
Window
将适用于垂直场景坐标在渲染和合成输出到屏幕或其他目标设备的所有阶段的规模。 该属性在不同时间由系统异步更新,包括:- 窗口创建
- 在移动窗口的某个
Screen
,可能在更新Screen
属性之前或之后的新的Screen
。 - 响应于输出缩放的用户偏好的变化。
- 从以下版本开始:
- 9
- 另请参见:
-
getOutputScaleY()
-
setForceIntegerRenderScale
public final void setForceIntegerRenderScale(boolean forced)
设置属性forceIntegerRenderScale的值。- Property description:
-
当相关的输出比例有变化时,控制系统默认情况下是否设置整数渲染比例的布尔属性。
renderScale
属性将直接更新,并与相关联的outputScale
属性中的任何更改同时更新,但可以通过后续调用setRenderScale
设置器或通过适当使用绑定来覆盖这些值。 该属性不会直接使用renderScale
属性对象或方便设置器方法来阻止设置非整数。 - Default value:
- 假
- 从以下版本开始:
- 9
-
isForceIntegerRenderScale
public final boolean isForceIntegerRenderScale()
获取属性forceIntegerRenderScale的值。- Property description:
-
当相关的输出比例有变化时,控制系统默认情况下是否设置整数渲染比例的布尔属性。
renderScale
属性将直接更新,并与相关联的outputScale
属性中的任何更改同时更新,但可以通过后续调用setRenderScale
设置器或通过适当使用绑定来覆盖这些值。 此属性不会阻止直接使用renderScale
属性对象或方便设置器方法设置非整数级别。 - Default value:
- 假
- 从以下版本开始:
- 9
-
forceIntegerRenderScaleProperty
public final BooleanProperty forceIntegerRenderScaleProperty()
当相关的输出比例有变化时,控制系统默认情况下是否设置整数渲染比例的布尔属性。renderScale
属性将直接更新,并与相关联的outputScale
属性中的任何更改同时更新,但可以通过后续调用setRenderScale
设置器或通过适当使用绑定来覆盖这些值。 该属性不会阻止直接使用renderScale
属性对象或方便设置器方法设置非整数级别。- Default value:
- 假
- 从以下版本开始:
- 9
- 另请参见:
-
isForceIntegerRenderScale()
,setForceIntegerRenderScale(boolean)
-
setRenderScaleX
public final void setRenderScaleX(double scale)
设置属性renderScaleX的值。- Property description:
-
当渲染
Scene
到渲染缓冲区时,Window
将使用的水平刻度。 每当outputScaleX
属性发生更改时,该属性将自动更新,并且可以通过调用setRenderScaleX()
响应outputScaleX
属性上的侦听器或通过适当绑定来覆盖该属性。 - Default value:
- outputScaleX
- 从以下版本开始:
- 9
-
getRenderScaleX
public final double getRenderScaleX()
获取属性renderScaleX的值。- Property description:
-
当渲染其
Scene
到渲染缓冲区时,Window
将使用的水平刻度。 每当outputScaleX
属性发生更改时,该属性将自动更新,并且可以通过调用setRenderScaleX()
以响应outputScaleX
属性上的侦听器或通过适当绑定来覆盖该属性。 - Default value:
- outputScaleX
- 从以下版本开始:
- 9
-
renderScaleXProperty
public final DoubleProperty renderScaleXProperty()
当渲染其Scene
到渲染缓冲区时,Window
将使用的水平刻度。 只要outputScaleX
属性发生更改,该属性就会自动更新,并且可以通过调用setRenderScaleX()
响应outputScaleX
属性上的侦听器或通过适当绑定来覆盖该属性。- Default value:
- outputScaleX
- 从以下版本开始:
- 9
- 另请参见:
-
getRenderScaleX()
,setRenderScaleX(double)
-
setRenderScaleY
public final void setRenderScaleY(double scale)
设置属性renderScaleY的值。- Property description:
-
Window
将其Scene
渲染到渲染缓冲区时将使用的垂直刻度。 每当outputScaleY
属性发生更改时,该属性将自动更新,并且可以通过调用setRenderScaleY()
以响应outputScaleY
属性上的侦听器或通过适当绑定来覆盖该属性。 - Default value:
- outputScaleY
- 从以下版本开始:
- 9
-
getRenderScaleY
public final double getRenderScaleY()
获取属性renderScaleY的值。- Property description:
-
当渲染其
Scene
到渲染缓冲区时,Window
将使用的垂直刻度。 只要outputScaleY
属性发生更改,该属性就会自动更新,可以通过调用setRenderScaleY()
响应outputScaleY
属性上的侦听器或通过适当绑定来覆盖outputScaleY
属性。 - Default value:
- outputScaleY
- 从以下版本开始:
- 9
-
renderScaleYProperty
public final DoubleProperty renderScaleYProperty()
当渲染Scene
到渲染缓冲区时,Window
将使用的垂直刻度。 每当outputScaleY
属性发生更改时,该属性将自动更新,并且可以通过调用setRenderScaleY()
响应outputScaleY
属性上的侦听器或通过适当绑定来覆盖该属性。- Default value:
- outputScaleY
- 从以下版本开始:
- 9
- 另请参见:
-
getRenderScaleY()
,setRenderScaleY(double)
-
setX
public final void setX(double value)
设置属性x的值。- Property description:
-
这个
Window
在屏幕上的水平位置。 更改此属性将水平移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。
-
getX
public final double getX()
获取属性x的值。- Property description:
-
这个水平位置的这个
Window
在屏幕上。 更改此属性将水平移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。
-
xProperty
public final ReadOnlyDoubleProperty xProperty()
这个水平位置的这个Window
在屏幕上。 更改此属性将水平移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。- 另请参见:
-
getX()
,setX(double)
-
setY
public final void setY(double value)
设置属性y的值。- Property description:
-
这个
Window
在屏幕上的垂直位置。 更改此属性将垂直移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。
-
getY
public final double getY()
获取属性y的值。- Property description:
-
这个
Window
在屏幕上的垂直位置。 更改此属性将垂直移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。
-
yProperty
public final ReadOnlyDoubleProperty yProperty()
这个Window
在屏幕上的垂直位置。 更改此属性将垂直移动Window
。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。- 另请参见:
-
getY()
,setY(double)
-
setWidth
public final void setWidth(double value)
设置属性宽度的值。- Property description:
-
这个宽度
Window
。 更改此属性将缩小或扩大Window
的宽度。 该值包括可由操作系统添加的任何和所有装饰,例如可调整大小的框架句柄。 典型的应用将会改变Scene
的宽度。 如果Window
从应用程序未设置,则将从场景中获取宽度。 最终用户调整窗口大小不会被视为设置应用程序的宽度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
-
getWidth
public final double getWidth()
获取属性宽度的值。- Property description:
-
这个宽度
Window
。 更改此属性将缩小或扩大Window
的宽度。 该值包括可由操作系统添加的任何和所有装饰,例如可调整大小的框架句柄。 典型应用将会改变Scene
的宽度。 如果Window
从应用程序未设置,它将从场景中获取宽度。 最终用户调整窗口大小不会被视为设置应用程序的宽度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
-
widthProperty
public final ReadOnlyDoubleProperty widthProperty()
这个宽度Window
。 更改此属性将缩小或扩大Window
的宽度。 该值包括可由操作系统添加的任何和所有装饰,例如可调整大小的框架句柄。 典型的应用将会改变Scene
的宽度。 如果应用程序从未设置,此Window
将从场景中获取宽度。 最终用户调整窗口大小不会被视为设置应用程序的宽度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
getWidth()
,setWidth(double)
-
setHeight
public final void setHeight(double value)
设置属性高度的值。- Property description:
-
这个高度
Window
。 更改此属性将缩小或提高Window
的高度。 该值包括操作系统可能添加的任何和所有装饰,例如标题栏。 典型的应用将会改变Scene
的高度。 如果应用程序从未设置此窗口,则此窗口将从场景中取出高度。 最终用户调整此窗口大小并不算作应用程序设置的高度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
-
getHeight
public final double getHeight()
获取属性高度的值。- Property description:
-
这个高度
Window
。 更改此属性将缩小或提高Window
的高度。 该值包括操作系统可能添加的任何和所有装饰,例如标题栏。 典型应用将设置Scene
高度。 如果应用程序从未设置此窗口,则此窗口将从场景中取出高度。 最终用户调整此窗口大小并不算作应用程序设置的高度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
-
heightProperty
public final ReadOnlyDoubleProperty heightProperty()
这个高度Window
。 更改此属性将缩小或提高Window
的高度。 该值包括操作系统可能添加的任何和所有装饰,例如标题栏。 典型的应用将会改变Scene
的高度。 如果应用程序从未设置此窗口,则此窗口将从场景中取出高度。 最终用户调整此窗口大小并不算作应用程序设置的高度。 如果这个Window
是实例Stage
,改变这个属性不会在视觉上影响Window
而fullScreen
是真的,但会被兑现Window
一次fullScreen
为假。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
getHeight()
,setHeight(double)
-
requestFocus
public final void requestFocus()
要求这个Window
得到输入焦点。
-
isFocused
public final boolean isFocused()
获取关注的属性的值。- Property description:
-
该
Window
是否具有键盘或输入焦点。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
-
focusedProperty
public final ReadOnlyBooleanProperty focusedProperty()
该Window
是否具有键盘或输入焦点。该属性是只读的,因为它可以由底层平台外部更改,因此不能绑定。
- 另请参见:
-
isFocused()
-
getProperties
public final ObservableMap<Object,Object> getProperties()
返回此节点上属性的可观察图,主要由应用程序开发人员使用。- 结果
- 该节点上属性的可观察地图主要由应用程序开发人员使用
- 从以下版本开始:
- JavaFX 8u40
-
hasProperties
public boolean hasProperties()
测试窗口是否具有属性。- 结果
- 如果节点有属性,则为true。
- 从以下版本开始:
- JavaFX 8u40
-
setUserData
public void setUserData(Object value)
用于设置可以在以后检索的单个Object属性的便利方法。 这在功能上等同于调用getProperties()。put(Object key,Object value)方法。 这可以稍后通过调用getUserData()
来检索。- 参数
-
value
- 要存储的值 - 以后可以通过调用getUserData()
检索。 - 从以下版本开始:
- JavaFX 8u40
-
getUserData
public Object getUserData()
返回先前设置的Object属性,如果没有使用setUserData(java.lang.Object)
方法设置此属性,则返回null。- 结果
- 先前设置的对象,如果没有设置属性或设置为null,则为null。
- 从以下版本开始:
- JavaFX 8u40
-
setScene
protected void setScene(Scene value)
设置属性场景的值。- Property description:
-
要在
Scene
上呈现Window
。 只能有一个Scene
上Window
的时间,并且Scene
只能是一个Window
一次。 设置一个Scene
在不同Window
将导致旧Window
到新的收益之前失去了参考。 您可以Scene
在Window
上互换Scene
,即使它是Stage
一个实例,而fullScreen
设置为true。 如果这个Window
的宽度或高度从未被应用程序设置,则设置场景将导致该Window
从该场景中取走其宽度或高度。 最终用户调整此窗口大小并不算作应用程序设置宽度或高度。 如果此属性设置在JavaFX应用程序线程之外的线程上,则抛出一个IllegalStateException
。 - Default value:
- 空值
-
getScene
public final Scene getScene()
获取属性场景的值。- Property description:
-
要在
Scene
上呈现Window
。 只能有一个Scene
上Window
的时间,并且Scene
只能是一个Window
一次。 在不同的Scene
上设置Window
将导致旧的Window
在新的获取之前丢失参考。 您可以Scene
在Window
上互换Scene
,即使是Stage
的实例,并将fullScreen
设置为true。 如果Window
的宽度或高度从未被应用程序设置,则设置场景将导致Window
从该场景中取走其宽度或高度。 最终用户调整此窗口大小并不算作应用程序设置宽度或高度。 如果此属性设置在除JavaFX应用程序线程之外的线程上,则抛出一个IllegalStateException
。 - Default value:
- 空值
-
sceneProperty
public final ReadOnlyObjectProperty<Scene> sceneProperty()
Scene
要呈现在这个Window
。 只能有一个Scene
上Window
的时间,并且Scene
只能是一个Window
一次。 设置一个Scene
在不同Window
将导致旧Window
到新的收益之前失去了参考。 您可以Scene
在Window
上互换Scene
,即使是Stage
的实例,并将fullScreen
设置为true。 如果Window
的宽度或高度未被应用程序设置,则设置场景将导致该Window
从该场景中取走其宽度或高度。 最终用户调整此窗口大小并不算作应用程序设置宽度或高度。 如果此属性设置在JavaFX应用程序线程之外的线程上,则抛出一个IllegalStateException
。- Default value:
- 空值
- 另请参见:
-
getScene()
,setScene(Scene)
-
setOpacity
public final void setOpacity(double value)
设置属性不透明度的值。- Property description:
-
将
Window
的不透明度定义为0.0和1.0之间的值。 不透明度反映在Window
,其Decoration
及其Scene
内容中。 在不支持不透明度的JavaFX运行时平台上,为此变量分配一个值将没有明显差异。 具有0%不透明度的Window
是完全半透明的。 通常,具有0%不透明度的Window
将不会收到任何鼠标事件。 - Default value:
- 1.0
-
getOpacity
public final double getOpacity()
获取属性不透明度的值。- Property description:
-
将
Window
的不透明度定义为0.0和1.0之间的值。 不透明度反映在Window
,其Decoration
及其Scene
内容中。 在不支持不透明度的JavaFX运行时平台上,为此变量分配一个值将没有明显差异。 具有0%不透明度的Window
是完全半透明的。 通常,具有0%不透明度的Window
将不会收到任何鼠标事件。 - Default value:
- 1.0
-
opacityProperty
public final DoubleProperty opacityProperty()
将Window
的不透明度定义为0.0和1.0之间的值。 不透明度反映在Window
,其Decoration
及其Scene
内容中。 在不支持不透明度的JavaFX运行时平台上,为此变量分配一个值将没有明显差异。 具有0%不透明度的Window
是完全半透明的。 通常,具有0%不透明度的Window
将不会收到任何鼠标事件。- Default value:
- 1.0
- 另请参见:
-
getOpacity()
,setOpacity(double)
-
setOnCloseRequest
public final void setOnCloseRequest(EventHandler<WindowEvent> value)
设置属性onCloseRequest的值。- Property description:
-
当有外部请求关闭此
Window
。 安装的事件处理程序可以通过消耗接收的事件来阻止关闭窗口。
-
getOnCloseRequest
public final EventHandler<WindowEvent> getOnCloseRequest()
获取属性onCloseRequest的值。- Property description:
-
当有外部请求关闭这个
Window
。 安装的事件处理程序可以通过消耗接收的事件来阻止关闭窗口。
-
onCloseRequestProperty
public final ObjectProperty<EventHandler<WindowEvent>> onCloseRequestProperty()
当有外部请求关闭此Window
。 安装的事件处理程序可以通过消耗接收的事件来阻止关闭窗口。
-
setOnShowing
public final void setOnShowing(EventHandler<WindowEvent> value)
设置属性onShowing的值。- Property description:
- 在窗口显示之前调用。
-
getOnShowing
public final EventHandler<WindowEvent> getOnShowing()
获取属性onShowing的值。- Property description:
- 在窗口显示之前调用。
-
onShowingProperty
public final ObjectProperty<EventHandler<WindowEvent>> onShowingProperty()
在窗口显示之前调用。
-
setOnShown
public final void setOnShown(EventHandler<WindowEvent> value)
设置属性onShown的值。- Property description:
- 在窗口显示之后调用。
-
getOnShown
public final EventHandler<WindowEvent> getOnShown()
获取onShown属性的值。- Property description:
- 在窗口显示之后调用。
-
onShownProperty
public final ObjectProperty<EventHandler<WindowEvent>> onShownProperty()
在窗口显示之后调用。- 另请参见:
-
getOnShown()
,setOnShown(EventHandler)
-
setOnHiding
public final void setOnHiding(EventHandler<WindowEvent> value)
设置属性onHiding的值。- Property description:
- 在Window被隐藏之前调用。
-
getOnHiding
public final EventHandler<WindowEvent> getOnHiding()
获取属性onHiding的值。- Property description:
- 在Window被隐藏之前调用。
-
onHidingProperty
public final ObjectProperty<EventHandler<WindowEvent>> onHidingProperty()
在Window被隐藏之前调用。
-
setOnHidden
public final void setOnHidden(EventHandler<WindowEvent> value)
设置属性onHidden的值。- Property description:
-
在窗口被隐藏之后调用。
当隐藏
Window
,将调用此事件处理程序,以允许开发人员在Window
关闭时清理资源或执行其他任务。
-
getOnHidden
public final EventHandler<WindowEvent> getOnHidden()
获取属性onHidden的值。- Property description:
-
在窗口被隐藏之后调用。
当隐藏
Window
,将调用此事件处理程序,以允许开发人员在Window
关闭时清理资源或执行其他任务。
-
onHiddenProperty
public final ObjectProperty<EventHandler<WindowEvent>> onHiddenProperty()
在窗口被隐藏之后调用。 当隐藏Window
,将调用此事件处理程序,以允许开发人员在Window
关闭时清理资源或执行其他任务。
-
isShowing
public final boolean isShowing()
获取显示的属性的值。- Property description:
-
该
Window
是否显示(即在用户系统上打开)。 窗口可能是“显示”,但是由于窗口被渲染在另一个窗口后面或由于窗口被放置在监视器之外,用户可能无法看到它。 - Default value:
- 假
-
showingProperty
public final ReadOnlyBooleanProperty showingProperty()
该Window
是否显示(即,在用户系统上打开)。 窗口可能是“显示”,但是由于窗口被渲染在另一个窗口后面或由于窗口被放置在监视器之外,用户可能无法看到它。- Default value:
- 假
- 另请参见:
-
isShowing()
-
show
protected void show()
尝试通过将可见性设置为true来显示此窗口- 异常
-
IllegalStateException
- 如果在除JavaFX应用程序线程之外的线程上调用此方法。
-
hide
public void hide()
尝试通过将可见性设置为false来隐藏此窗口。- 异常
-
IllegalStateException
- 如果在除JavaFX应用程序线程之外的线程上调用此方法。
-
setEventDispatcher
public final void setEventDispatcher(EventDispatcher value)
设置属性eventDispatcher的值。- Property description:
-
指定此节点的事件分派器。
默认事件调度程序将接收的事件发送到已注册的事件处理程序和过滤器。
当使用新的
EventDispatcher
替换值时,新的分派器应将事件转发到替换的分派器,以维护节点的默认事件处理行为。
-
getEventDispatcher
public final EventDispatcher getEventDispatcher()
获取属性eventDispatcher的值。- Property description:
-
指定此节点的事件分派器。
默认事件调度程序将接收的事件发送到已注册的事件处理程序和过滤器。
当使用新的
EventDispatcher
替换值时,新的调度程序应将事件转发到已替换的调度程序,以维护节点的默认事件处理行为。
-
eventDispatcherProperty
public final ObjectProperty<EventDispatcher> eventDispatcherProperty()
指定此节点的事件分派器。 默认事件调度程序将接收的事件发送到已注册的事件处理程序和过滤器。 当使用新的EventDispatcher
替换值时,新的调度程序应将事件转发到替换的调度程序,以维护节点的默认事件处理行为。
-
addEventHandler
public final <T extends Event> void addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
向此节点注册事件处理程序。 当事件传送的冒泡阶段节点收到指定类型的Event
时,调用处理程序。- 参数类型
-
T
- 处理程序的特定事件类 - 参数
-
eventType
- 由处理程序接收的事件的类型 -
eventHandler
- 要注册的处理程序 - 异常
-
NullPointerException
- 如果事件类型或处理程序为空
-
removeEventHandler
public final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
从此节点注销先前注册的事件处理程序。 一个处理程序可能已被注册用于不同的事件类型,因此调用者需要指定特定的事件类型,从中注销处理程序。- 参数类型
-
T
- 处理程序的特定事件类 - 参数
-
eventType
- 要注销的事件类型 -
eventHandler
- 要注销的处理程序 - 异常
-
NullPointerException
- 如果事件类型或处理程序为空
-
addEventFilter
public final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
向此节点注册事件过滤器。 当事件传送的捕获阶段,当节点接收到指定类型的Event
时,将调用该过滤器。- 参数类型
-
T
- 过滤器的特定事件类 - 参数
-
eventType
- 过滤器接收的事件的类型 -
eventFilter
- 要注册的过滤器 - 异常
-
NullPointerException
- 如果事件类型或过滤器为空
-
removeEventFilter
public final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
从此节点注销先前注册的事件过滤器。 一个过滤器可能已被注册用于不同的事件类型,因此调用者需要指定特定的事件类型,从中注销过滤器。- 参数类型
-
T
- 过滤器的特定事件类 - 参数
-
eventType
- 要注销的事件类型 -
eventFilter
- 要注销的过滤器 - 异常
-
NullPointerException
- 如果事件类型或过滤器为空
-
setEventHandler
protected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
设置要用于此事件类型的处理程序。 一次只能有一个这样的处理程序。 这个处理程序被保证被首先调用。 这用于注册用户定义的onFoo事件处理程序。- 参数类型
-
T
- 处理程序的特定事件类 - 参数
-
eventType
- 与给定eventHandler关联的事件类型 -
eventHandler
- 要注册的处理程序,或者取消注册为null - 异常
-
NullPointerException
- 如果事件类型为空
-
fireEvent
public final void fireEvent(Event event)
触发指定的事件。必须在FX用户线程上调用此方法。
- 参数
-
event
- 事件触发
-
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
为此窗口构建事件调度链。- Specified by:
-
buildEventDispatchChain
在接口EventTarget
- 参数
-
tail
- 建立起来的初始链 - 结果
- the resulting event dispatch chain for this window
-
-