- java.lang.Object
-
- javafx.scene.Node
-
- All Implemented Interfaces:
-
Styleable
,EventTarget
- 已知直接子类:
-
Camera
,Canvas
,ImageView
,LightBase
,MediaView
,Parent
,Shape
,Shape3D
,SubScene
,SwingNode
@IDProperty("id") public abstract class Node extends Object implements EventTarget, Styleable
场景图节点的基类。 场景图是一组树数据结构,其中每个项目具有零个或一个父项,并且每个项目是具有零子项的“叶”或具有零个或多个子项的“分支”。场景图中的每个项目称为
Node
。 分支节点类型的Parent
,其具体的子类是Group
,Region
,和Control
,或它们的亚类。叶节点是类如
Rectangle
,Text
,ImageView
,MediaView
,或不能生育其它这种叶类。 每个场景图树中只有一个节点将没有父节点,这被称为“根”节点。场景图中可能有几棵树。 一些树木可能是
Scene
的一部分,在这种情况下,它们有资格被展示。 其他树木可能不属于任何Scene
的一部分。场景图中的任何地方最多可能出现节点。 具体而言,节点必须出现不超过一次在所有以下的:作为的根节点
Scene
,一个的儿童ObservableListParent
,或作为的夹子Node
。场景图不能有循环。 如果节点是树中的自身的祖先,则考虑到上述的
Group
内容ObservableList,Parent
children ObservableList和Node
剪辑关系,将存在一个循环。如果程序将一个子节点添加到父(包括组,区域等),并且该节点已经是不同父级或场景根的子节点,则该节点将自动(并且默认地)从其以前的父项中删除。 如果程序尝试以违反上述规则的任何其他方式修改场景图,则会抛出异常,修改尝试被忽略,场景图恢复到之前的状态。
可以重新排列场景图的结构,例如,将子树从场景图中的一个位置移动到另一个。 为了做到这一点,通常在将子树插入新位置之前,将其从旧位置移除。 但是,如果应用程序没有明确地删除它,子树将如上所述自动删除。
节点对象可以在任何线程上构造和修改,只要它们尚未附加到
Window
中的Window
,即showing
。 应用程序必须将节点附加到这样的场景或在JavaFX应用程序线程上进行修改。JavaFX应用程序线程是作为JavaFX运行时启动过程的一部分而创建的。 有关更多信息,请参阅
Application
类和Platform.startup(Runnable)
方法。应用程序不应直接扩展Node类。 否则可能导致抛出UnsupportedOperationException异常。
字符串ID
场景图中的每个节点都可以给出一个独特的
id
。 这个id就像HTML标签的“id”属性一样,由设计师和开发者来确保id
在场景图中是唯一的。 可以使用一个名为lookup(String)
的方便函数来查找场景图中具有唯一ID的节点,或场景图的子树。 id也可以用于标识节点应用样式; 请参阅下面的CSS部分。坐标系
Node
类定义了传统的计算机图形“局部”坐标系,其中x
轴向右增加,而y
轴向下增加。 形状的具体节点类提供了用于定义该局部坐标空间内形状和位置的变量。 例如,Rectangle
提供x
,y
,width
,height
变量而Circle
提供centerX
,centerY
,和radius
。在设备像素级别,整数坐标映射到角上,像素之间的裂纹和像素的中心之间出现在整数像素位置之间的中点处。 因为所有坐标值都用浮点数指定,所以坐标可以精确地指向这些角(浮点值具有精确的整数值)或像素上的任何位置。 例如,
(0.5, 0.5)
的坐标将指向(0.5, 0.5)
上左上角像素的Stage
。 类似地,在一个矩形(0, 0)
与尺寸10
通过10
将从上左上像素的左上角跨越Stage
到10号的扫描线的第10像素的右下角。 该矩形内的最后一个像素的像素中心将在坐标(9.5, 9.5)
。实际上,如下所述,大多数节点具有应用于其坐标系的变换。 结果,上述描述设备坐标对像素网格的对准的信息是相对于变换的坐标,而不是节点的局部坐标。
Shape
类描述了有关坐标映射的一些其他重要的上下文相关信息,以及它如何影响渲染。转换
任何
Node
都可以对其进行转换。 这些包括翻译,旋转,缩放或剪切。平移变换是沿x或y轴移动节点坐标空间的原点的变换。 例如,如果创建一个
Rectangle
,它在原点(x = 0,y = 0)绘制,宽度为100,高度为50,然后应用沿着x轴移动10的Translate
( x = 10),则矩形将出现在(x = 10,y = 0)处绘制,并保持100点宽和50高。 请注意,原点已移动,而不是矩形的x
变量。公共节点变换是整数距离的平移,最常用于在舞台上布置节点。 这样的整数翻译保持设备像素映射,使得整数的局部坐标仍然映射到像素之间的裂缝。
旋转变换是围绕指定“枢轴”点旋转节点的坐标空间的转换,导致节点出现旋转。 例如,如果创建一个
Rectangle
其在原点绘制(X = 0,Y = 0)和具有100和30高度的宽度和在应用一个Rotate
具有90度旋转(角度= 90)和一个在原点枢轴(pivotX = 0,pivotY = 0),则矩形将被绘制为其x和y为零,但其高度为100,宽度为-30。 也就是说,就好像一个针被卡在左上角,并且矩形围绕该针顺时针旋转90度。 如果将枢轴点放置在矩形的中心(在x = 50,y = 15),则矩形将以其中心为中心旋转。请注意,与所有变换一样,矩形的x,y,width和height变量(相对于局部坐标空间保留)没有改变,而是转换改变矩形的整个坐标空间。
缩放变换导致节点根据缩放因子看起来更大或更小。 缩放改变节点的坐标空间,使得沿着本地坐标轴的距离的每个单位乘以比例因子。 与旋转变换一样,对“枢轴”点应用缩放变换。 您可以将其视为节点周围的“缩放”点。 例如,如果创建
Rectangle
与strokeWidth
5,宽度和高度的50,和在应用一个Scale
在原点(pivotX = 0的比例因子(X = 2.0,Y = 2.0)和枢转, pivotY = 0),整个矩形(包括笔触)的大小将翻倍,从原点向右和向下生长。有时称为偏斜的剪切变换有效地旋转一个轴,使得x和y轴不再垂直。
可以通过指定转换的有序链来将多个变换应用于节点。 变换的应用顺序由
transforms
变量中指定的ObservableList定义。边界矩形
由于每个
Node
都有转换,所以每个节点的几何边界矩形可以根据转换是否被考虑而不同地进行描述。每个
Node
都有一个只读的boundsInLocal
变量,它指定未转换的局部坐标中的Node
的边界矩形。boundsInLocal
包括节点的形状几何,包括可能落在局部位置/大小变量之外的非零行程所需的任何空间及其clip
和effect
变量。每个
Node
还具有只读boundsInParent
变量,用于指定所述的外接矩形Node
已应用,包括那些在设置的所有的变换后transforms
, 二百七十○万七千一百五十五亿四千七百四十一万零七百八十四 / 二百七万七千一百五十五亿四千七百四十二万二千二百三十二 ,rotate
, 二百七万七千一百五十五亿四千七百八十六万九千八百八十七 / 二百七十○万七千一百五十五亿四千七百八十八万七千六百五十二 ,和二七�銎咭晃逦逅钠甙司啪虐税司� / 二百七十○万七千一百五十五亿四千七百九十一万零九百四十二 。 它被称为“boundsInParent”,因为矩形将相对于父协调系统。 这是节点的'视觉'边界。最后,
layoutBounds
变量定义了应该用作布局计算基础的Node
的矩形边界,并且可能与节点的可视边界不同。 对于形状,文本和ImageView的,默认情况下layoutBounds中仅包括几何形状,其中包括一个非零所需的空间strokeWidth
,但不包括的效果,夹子,或任何变换。 对于可调整大小的类(区域和控件),layoutBounds将始终映射到0,0 width x height
。该图像显示一个没有任何转换的节点,它的
如果我们将图像旋转20度,我们得到以下结果: 红色矩形在节点的父节点的坐标空间中表示boundsInLocal
:boundsInParent
。boundsInLocal
与第一张图像保持一致,此图像中的绿色矩形表示节点坐标空间中的boundsInLocal
。图像显示一个填充和抚摸的矩形及其边界。 第一个矩形
[x:10.0 y:10.0 width:100.0 height:100.0 strokeWidth:0]
具有以下界限:[x:10.0 y:10.0 width:100.0 height:100.0]
。 第二个矩形[x:10.0 y:10.0 width:100.0 height:100.0 strokeWidth:5]
具有以下界限:[x:7.5 y:7.5 width:105 height:105]
(笔画以默认为中心,因此只有一半在原始界限之外;也可以创建内部或外部笔画)。 由于两个矩形都不应用任何变换,boundsInParent
和boundsInLocal
都是相同的。CSS
该
Node
类包含id
,styleClass
,并style
了在造型从CSS这个节点使用的变量。 在CSS样式表中使用id
和styleClass
变量来标识应用哪些样式的节点。style
变量包含直接应用于此节点的样式属性和值。有关CSS的更多信息以及如何将CSS样式应用于节点,请参阅CSS Reference Guide 。
- 从以下版本开始:
- JavaFX 2.0
-
-
Property Summary
-
Field Summary
Fields Modifier and Type Field 描述 static double
BASELINE_OFFSET_SAME_AS_HEIGHT
这是getBaselineOffset()
可能返回的特殊值。
-
构造方法摘要
构造方法 Modifier Constructor 描述 protected
Node()
创建一个新的Node实例。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 ObjectProperty<String>
accessibleHelpProperty()
该Node
的可访问帮助文本。ObjectProperty<String>
accessibleRoleDescriptionProperty()
这个角色描述Node
。ObjectProperty<AccessibleRole>
accessibleRoleProperty()
这个Node
的可访问角色。ObjectProperty<String>
accessibleTextProperty()
该Node
的可访问文本。<T extends Event>
voidaddEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
向此节点注册事件过滤器。<T extends Event>
voidaddEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
向此节点注册事件处理程序。void
applyCss()
如果需要,将样式应用于此节点及其子节点(如果有)。void
autosize()
如果节点可调整大小,则将其布局边界设置为当前优选的宽度和高度。ObjectProperty<BlendMode>
blendModeProperty()
BlendMode
用于将此单个节点混合到其后面的场景中。ReadOnlyObjectProperty<Bounds>
boundsInLocalProperty()
该节点未转换的局部坐标空间中的Node
的矩形边界。ReadOnlyObjectProperty<Bounds>
boundsInParentProperty()
这个Node
的矩形边界包括它的变换。EventDispatchChain
buildEventDispatchChain(EventDispatchChain tail)
为此节点构造事件调度链。ObjectProperty<CacheHint>
cacheHintProperty()
控制位图缓存的其他提示。BooleanProperty
cacheProperty()
系统的性能提示表明,这个Node
应该被缓存为一个位图。ObjectProperty<Node>
clipProperty()
指定一个Node
用于定义此节点的剪切形状。double
computeAreaInScreen()
以像素为单位返回投影到物理屏幕上的Node
的区域。boolean
contains(double localX, double localY)
返回true
如果给定的点(指定在局部坐标的此空间Node
)包含在此的形状内Node
。boolean
contains(Point2D localPoint)
返回true
如果给定的点(指定在局部坐标的此空间Node
)包含在此的形状内Node
。ObjectProperty<Cursor>
cursorProperty()
为此Node
和子节点定义鼠标光标。ObjectProperty<DepthTest>
depthTestProperty()
指示在渲染此节点时是否使用深度测试。ReadOnlyBooleanProperty
disabledProperty()
指示此Node
是否被禁用。BooleanProperty
disableProperty()
定义此Node
的个人禁用状态。ReadOnlyObjectProperty<NodeOrientation>
effectiveNodeOrientationProperty()
节点的有效方向解决节点方向的继承,从左到右或从右到左返回。ObjectProperty<Effect>
effectProperty()
指定应用于此Node
的效果。ObjectProperty<EventDispatcher>
eventDispatcherProperty()
指定此节点的事件分派器。void
executeAccessibleAction(AccessibleAction action, Object... parameters)
该方法由辅助技术调用,请求执行由参数指示的动作。void
fireEvent(Event event)
触发指定的事件。ReadOnlyBooleanProperty
focusedProperty()
指示此Node
当前是否具有输入焦点。BooleanProperty
focusTraversableProperty()
指定此Node
应该是聚焦遍历周期的一部分。String
getAccessibleHelp()
获取属性accessibleHelp的值。AccessibleRole
getAccessibleRole()
获取属性accessibilityRole的值。String
getAccessibleRoleDescription()
获取属性accessibilityRoleDescription的值。String
getAccessibleText()
获取属性accessibleText的值。double
getBaselineOffset()
当基于与其他节点垂直对齐的节点的layoutBounds.minY位置时,“字母”(或“罗马”)基线偏移。BlendMode
getBlendMode()
获取属性blendMode的值。Bounds
getBoundsInLocal()
获取属性boundsInLocal的值。Bounds
getBoundsInParent()
获取属性boundsInParent的值。CacheHint
getCacheHint()
获取属性cacheHint的值。static List<CssMetaData<? extends Styleable,?>>
getClassCssMetaData()
Node
getClip()
获取属性剪辑的值。Orientation
getContentBias()
返回节点调整大小偏置的方向以进行布局。List<CssMetaData<? extends Styleable,?>>
getCssMetaData()
该方法应该委托给getClassCssMetaData()
,以便可以访问节点的CssMetaData而不需要反射。Cursor
getCursor()
获取属性游标的值。DepthTest
getDepthTest()
获取属性depthTest的值。Effect
getEffect()
获取属性效果的值。NodeOrientation
getEffectiveNodeOrientation()
获取属性effectiveNodeOrientation的值。EventDispatcher
getEventDispatcher()
获取属性eventDispatcher的值。String
getId()
这个id的这个Node
。protected Cursor
getInitialCursor()
返回此节点的初始游标状态,供JavaFX CSS引擎正确设置其初始值。protected Boolean
getInitialFocusTraversable()
返回此节点的初始焦点遍历状态,供JavaFX CSS引擎正确设置其初始值。InputMethodRequests
getInputMethodRequests()
获取属性inputMethodRequests的值。Bounds
getLayoutBounds()
获取属性layoutBounds的值。double
getLayoutX()
获取属性layoutX的值。double
getLayoutY()
获取属性layoutY的值。Transform
getLocalToParentTransform()
获取属性localToParentTransform的值。Transform
getLocalToSceneTransform()
获取属性localToSceneTransform的值。NodeOrientation
getNodeOrientation()
获取属性nodeOrientation的值。EventHandler<? super ContextMenuEvent>
getOnContextMenuRequested()
获取属性onContextMenuRequested的值。EventHandler<? super MouseEvent>
getOnDragDetected()
获取属性onDragDetected的值。EventHandler<? super DragEvent>
getOnDragDone()
获取属性onDragDone的值。EventHandler<? super DragEvent>
getOnDragDropped()
获取属性onDragDropped的值。EventHandler<? super DragEvent>
getOnDragEntered()
获取属性onDragEntered的值。EventHandler<? super DragEvent>
getOnDragExited()
获取属性onDragExited的值。EventHandler<? super DragEvent>
getOnDragOver()
获取属性onDragOver的值。EventHandler<? super InputMethodEvent>
getOnInputMethodTextChanged()
获取onInputMethodTextChanged属性的值。EventHandler<? super KeyEvent>
getOnKeyPressed()
获取属性onKeyPressed的值。EventHandler<? super KeyEvent>
getOnKeyReleased()
获取属性onKeyReleased的值。EventHandler<? super KeyEvent>
getOnKeyTyped()
获取属性onKeyTyped的值。EventHandler<? super MouseEvent>
getOnMouseClicked()
获取属性onMouseClicked的值。EventHandler<? super MouseDragEvent>
getOnMouseDragEntered()
获取属性onMouseDragEntered的值。EventHandler<? super MouseDragEvent>
getOnMouseDragExited()
获取属性onMouseDragExited的值。EventHandler<? super MouseEvent>
getOnMouseDragged()
获取属性onMouseDragged的值。EventHandler<? super MouseDragEvent>
getOnMouseDragOver()
获取属性onMouseDragOver的值。EventHandler<? super MouseDragEvent>
getOnMouseDragReleased()
获取属性onMouseDragReleased的值。EventHandler<? super MouseEvent>
getOnMouseEntered()
获取属性onMouseEntered的值。EventHandler<? super MouseEvent>
getOnMouseExited()
获取属性onMouseExited的值。EventHandler<? super MouseEvent>
getOnMouseMoved()
获取属性onMouseMoved的值。EventHandler<? super MouseEvent>
getOnMousePressed()
获取属性onMousePressed的值。EventHandler<? super MouseEvent>
getOnMouseReleased()
获取属性onMouseReleased的值。EventHandler<? super RotateEvent>
getOnRotate()
获取属性onRotate的值。EventHandler<? super RotateEvent>
getOnRotationFinished()
获取属性onRotationFinished的值。EventHandler<? super RotateEvent>
getOnRotationStarted()
获取属性onRotationStarted的值。EventHandler<? super ScrollEvent>
getOnScroll()
获取属性onScroll的值。EventHandler<? super ScrollEvent>
getOnScrollFinished()
获取属性onScrollFinished的值。EventHandler<? super ScrollEvent>
getOnScrollStarted()
获取属性onScrollStarted的值。EventHandler<? super SwipeEvent>
getOnSwipeDown()
获取属性onSwipeDown的值。EventHandler<? super SwipeEvent>
getOnSwipeLeft()
获取属性onSwipeLeft的值。EventHandler<? super SwipeEvent>
getOnSwipeRight()
获取属性onSwipeRight的值。EventHandler<? super SwipeEvent>
getOnSwipeUp()
获取属性onSwipeUp的值。EventHandler<? super TouchEvent>
getOnTouchMoved()
获取onTouchMoved属性的值。EventHandler<? super TouchEvent>
getOnTouchPressed()
获取onTouchPressed属性的值。EventHandler<? super TouchEvent>
getOnTouchReleased()
获取onTouchReleased属性的值。EventHandler<? super TouchEvent>
getOnTouchStationary()
获取属性onTouchStationary的值。EventHandler<? super ZoomEvent>
getOnZoom()
获取属性onZoom的值。EventHandler<? super ZoomEvent>
getOnZoomFinished()
获取属性onZoomFinished的值。EventHandler<? super ZoomEvent>
getOnZoomStarted()
获取属性onZoomStarted的值。double
getOpacity()
获取属性不透明度的值。Parent
getParent()
获取属性parent的值。ObservableMap<Object,Object>
getProperties()
返回此节点上属性的可观察图,主要由应用程序开发人员使用。ObservableSet<PseudoClass>
getPseudoClassStates()
返回此Styleable的伪类状态。double
getRotate()
获取属性旋转的值。Point3D
getRotationAxis()
获取属性rotateAxis的值。double
getScaleX()
获取属性scaleX的值。double
getScaleY()
获取属性scaleY的值。double
getScaleZ()
获取属性scaleZ的值。Scene
getScene()
获取属性场景的值。String
getStyle()
与此特定的Node
相关联的CSS样式的字符串表示Node
。Styleable
getStyleableParent()
返回此Styleable的父项,如果没有父项则返回null。ObservableList<String>
getStyleClass()
可用于逻辑组合节点的字符串标识符列表,专门用于外部样式引擎。ObservableList<Transform>
getTransforms()
定义的ObservableListTransform
个对象被应用到这个Node
。double
getTranslateX()
获取属性translateX的值。double
getTranslateY()
获取属性translateY的值。double
getTranslateZ()
获取属性translateZ的值。String
getTypeSelector()
这种Styleable
的类型用于选择器匹配。Object
getUserData()
返回先前设置的Object属性,如果没有使用setUserData(java.lang.Object)
方法设置此属性,则返回null。double
getViewOrder()
获取属性viewOrder的值。boolean
hasProperties()
测试节点是否具有属性。ReadOnlyBooleanProperty
hoverProperty()
这个Node
是否被徘徊。StringProperty
idProperty()
该Node
为Node
。ObjectProperty<InputMethodRequests>
inputMethodRequestsProperty()
属性保存InputMethodRequests。boolean
intersects(double localX, double localY, double localWidth, double localHeight)
返回true
如果给定的矩形(在指定在局部坐标的此空间Node
)相交此的形状Node
。boolean
intersects(Bounds localBounds)
返回true
如果给定的范围(在当地指定的坐标这个空间Node
)相交这个形状Node
。boolean
isCache()
获取属性缓存的值。boolean
isDisable()
获取属性禁用的值。boolean
isDisabled()
获取禁用的属性的值。boolean
isFocused()
获取关注的属性的值。boolean
isFocusTraversable()
获取属性focusTraversable的值。boolean
isHover()
获取属性悬停的值。boolean
isManaged()
获取管理的属性的值。boolean
isMouseTransparent()
获取属性mouseTransparent的值。boolean
isPickOnBounds()
获取属性pickOnBounds的值。boolean
isPressed()
获取按下的属性的值。boolean
isResizable()
指示该节点是否可以由父节点调整大小。boolean
isVisible()
获取属性的值可见。ReadOnlyObjectProperty<Bounds>
layoutBoundsProperty()
应该用于此节点的布局计算的矩形边界。DoubleProperty
layoutXProperty()
定义添加到此Node
的转换中用于布局目的的转换的x坐标。DoubleProperty
layoutYProperty()
定义添加到Node
的转换中用于布局目的的转换的y坐标。Point2D
localToParent(double localX, double localY)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。Point3D
localToParent(double x, double y, double z)
将一个点从该Node
的局部坐标空间转换为其父对象的坐标空间。Bounds
localToParent(Bounds localBounds)
将此Node
的局部坐标空间的Node
转换为其父节点的坐标空间。Point2D
localToParent(Point2D localPoint)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。Point3D
localToParent(Point3D localPoint)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。ReadOnlyObjectProperty<Transform>
localToParentTransformProperty()
保存计算的本地到父变换的仿射变换。Point2D
localToScene(double localX, double localY)
将一个点从该Node
的本地坐标空间Node
到其场景的坐标空间。Point2D
localToScene(double x, double y, boolean rootScene)
将一个点从该Node
的局部坐标空间转换为其场景的坐标空间。Point3D
localToScene(double x, double y, double z)
将一个点从该Node
的本地坐标空间Node
到其场景的坐标空间。Point3D
localToScene(double x, double y, double z, boolean rootScene)
将一个点从这个Node
的局部坐标空间Node
到其场景的坐标空间。Bounds
localToScene(Bounds localBounds)
将这个Node
的局部坐标空间的Node
转换为其场景的坐标空间。Bounds
localToScene(Bounds localBounds, boolean rootScene)
将这个Node
的局部坐标空间的边界变换到其场景的坐标空间。Point2D
localToScene(Point2D localPoint)
将一个点从该Node
的本地坐标空间转换为其场景的坐标空间。Point2D
localToScene(Point2D localPoint, boolean rootScene)
将一个点从该Node
的局部坐标空间转换为其场景的坐标空间。Point3D
localToScene(Point3D localPoint)
将一个点从该Node
的局部坐标空间转换为其场景的坐标空间。Point3D
localToScene(Point3D localPoint, boolean rootScene)
将此Node
的局部坐标空间的Node
转换为其场景的坐标空间。ReadOnlyObjectProperty<Transform>
localToSceneTransformProperty()
拥有计算的局部到场景变换的仿射变换。Point2D
localToScreen(double localX, double localY)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。Point2D
localToScreen(double localX, double localY, double localZ)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。Bounds
localToScreen(Bounds localBounds)
将这个Node
的局部坐标空间的Node
转换为其Screen
的坐标空间。Point2D
localToScreen(Point2D localPoint)
将一个点从该Node
的本地坐标空间转换为其Screen
的坐标空间。Point2D
localToScreen(Point3D localPoint)
将一个点从该Node
的本地坐标空间转换为其Screen
的坐标空间。Node
lookup(String selector)
根据给定的CSS选择器,找到这个Node
或第一个子节点。Set<Node>
lookupAll(String selector)
查找所有Node
s,包括这个和任何孩子,匹配给定的CSS选择器。BooleanProperty
managedProperty()
定义该节点的布局是否由父节点管理。double
maxHeight(double width)
返回节点在布局计算中使用的最大高度。double
maxWidth(double height)
返回节点在布局计算中使用的最大宽度。double
minHeight(double width)
返回节点在布局计算中使用的最小高度。double
minWidth(double height)
返回节点在布局计算中使用的最小宽度。BooleanProperty
mouseTransparentProperty()
如果是true
,这个节点(与其所有子节点一起)对鼠标事件是完全透明的。ObjectProperty<NodeOrientation>
nodeOrientationProperty()
属性保存NodeOrientation。void
notifyAccessibleAttributeChanged(AccessibleAttribute attributes)
该方法由应用程序调用,以通知辅助技术属性的值已更改。ObjectProperty<EventHandler<? super ContextMenuEvent>>
onContextMenuRequestedProperty()
定义在Node
上请求上下文菜单时要调用的函数。ObjectProperty<EventHandler<? super MouseEvent>>
onDragDetectedProperty()
定义检测到拖动手势时要调用的功能。ObjectProperty<EventHandler<? super DragEvent>>
onDragDoneProperty()
定义当这个Node
在其数据放在放置目标上之后是拖放手势源时要调用的函数。ObjectProperty<EventHandler<? super DragEvent>>
onDragDroppedProperty()
定义当在拖放手势时释放Node
鼠标按钮时要调用的功能。ObjectProperty<EventHandler<? super DragEvent>>
onDragEnteredProperty()
定义拖动手势进入Node
时要调用的功能。ObjectProperty<EventHandler<? super DragEvent>>
onDragExitedProperty()
定义当拖动手势退出Node
时要调用的函数。ObjectProperty<EventHandler<? super DragEvent>>
onDragOverProperty()
定义当这个Node
拖动手势进度时要调用的函数。ObjectProperty<EventHandler<? super InputMethodEvent>>
onInputMethodTextChangedProperty()
当这个Node
具有输入焦点并且输入法文本已经改变时,定义要调用的函数。ObjectProperty<EventHandler<? super KeyEvent>>
onKeyPressedProperty()
定义当Node
或其子项Node
具有输入焦点并按下了一个键时要调用的函数。ObjectProperty<EventHandler<? super KeyEvent>>
onKeyReleasedProperty()
定义当这个Node
或其子代Node
具有输入焦点并且键已被释放时要调用的函数。ObjectProperty<EventHandler<? super KeyEvent>>
onKeyTypedProperty()
定义当这个Node
或其子代Node
具有输入焦点并键入了一个键时要调用的函数。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseClickedProperty()
定义在此Node
上单击(按下并释放)鼠标按钮时调用的功能。ObjectProperty<EventHandler<? super MouseDragEvent>>
onMouseDragEnteredProperty()
定义当完全按下 - 释放手势进入Node
时要调用的功能。ObjectProperty<EventHandler<? super MouseDragEvent>>
onMouseDragExitedProperty()
定义当完全按下 - 拖动释放手势离开这个Node
时要调用的功能。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseDraggedProperty()
定义当在此Node
上按下鼠标按钮然后拖动时要调用的功能。ObjectProperty<EventHandler<? super MouseDragEvent>>
onMouseDragOverProperty()
定义当这个Node
内完全按下 - 拖动释放手势时,要调用的功能。ObjectProperty<EventHandler<? super MouseDragEvent>>
onMouseDragReleasedProperty()
定义当完全按下 - 拖动释放手势结束(通过释放鼠标按钮)在该Node
内时Node
。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseEnteredProperty()
定义当鼠标进入Node
时要调用的功能。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseExitedProperty()
定义当鼠标退出Node
时调用的函数。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseMovedProperty()
定义当这个Node
内的鼠标光标移动时调用的功能,但没有按钮被按下。ObjectProperty<EventHandler<? super MouseEvent>>
onMousePressedProperty()
定义当这个Node
按下鼠标按钮时要调用的功能。ObjectProperty<EventHandler<? super MouseEvent>>
onMouseReleasedProperty()
定义在Node
上释放鼠标按钮时要调用的功能。ObjectProperty<EventHandler<? super RotateEvent>>
onRotateProperty()
定义当用户执行旋转操作时要调用的函数。ObjectProperty<EventHandler<? super RotateEvent>>
onRotationFinishedProperty()
定义旋转手势结束时要调用的功能。ObjectProperty<EventHandler<? super RotateEvent>>
onRotationStartedProperty()
定义检测到旋转手势时要调用的功能。ObjectProperty<EventHandler<? super ScrollEvent>>
onScrollFinishedProperty()
定义当滚动手势结束时要调用的函数。ObjectProperty<EventHandler<? super ScrollEvent>>
onScrollProperty()
定义当用户执行滚动操作时要调用的函数。ObjectProperty<EventHandler<? super ScrollEvent>>
onScrollStartedProperty()
定义检测到滚动手势时要调用的函数。ObjectProperty<EventHandler<? super SwipeEvent>>
onSwipeDownProperty()
定义当在该节点上居中的向下滑动手势发生时要调用的功能。ObjectProperty<EventHandler<? super SwipeEvent>>
onSwipeLeftProperty()
定义当以该节点为中心的向左滑动手势发生时要调用的功能。ObjectProperty<EventHandler<? super SwipeEvent>>
onSwipeRightProperty()
定义当以该节点为中心的向右滑动手势发生时要调用的功能。ObjectProperty<EventHandler<? super SwipeEvent>>
onSwipeUpProperty()
定义当在该节点上居中的向上滑动手势发生时要调用的功能。ObjectProperty<EventHandler<? super TouchEvent>>
onTouchMovedProperty()
定义当触摸点移动时要调用的函数。ObjectProperty<EventHandler<? super TouchEvent>>
onTouchPressedProperty()
定义当按下新的触摸点时要调用的功能。ObjectProperty<EventHandler<? super TouchEvent>>
onTouchReleasedProperty()
定义触发点释放时要调用的功能。ObjectProperty<EventHandler<? super TouchEvent>>
onTouchStationaryProperty()
定义当触摸点保持按下并静止时要调用的功能。ObjectProperty<EventHandler<? super ZoomEvent>>
onZoomFinishedProperty()
定义当缩放手势结束时要调用的功能。ObjectProperty<EventHandler<? super ZoomEvent>>
onZoomProperty()
定义当用户执行缩放操作时要调用的函数。ObjectProperty<EventHandler<? super ZoomEvent>>
onZoomStartedProperty()
定义检测到缩放手势时要调用的功能。DoubleProperty
opacityProperty()
指定Node
不透明(即固体)。ReadOnlyObjectProperty<Parent>
parentProperty()
Node
Point2D
parentToLocal(double parentX, double parentY)
将一个点从母体的坐标空间转换为此Node
的局部坐标空间。Point3D
parentToLocal(double parentX, double parentY, double parentZ)
将一个点从母体的坐标空间转换为这个Node
的局部坐标空间。Bounds
parentToLocal(Bounds parentBounds)
将矩形从母体的坐标空间转换为此Node
的局部坐标空间。Point2D
parentToLocal(Point2D parentPoint)
将一个点从母体的坐标空间转换为此Node
的局部坐标空间。Point3D
parentToLocal(Point3D parentPoint)
将一个点从母体的坐标空间转换为Node
的局部坐标空间。BooleanProperty
pickOnBoundsProperty()
定义当由MouseEvent
或contains
函数调用触发时,如何为此节点完成拣选计算。double
prefHeight(double width)
返回节点的首选高度,用于布局计算。double
prefWidth(double height)
返回节点在布局计算中使用的首选宽度。ReadOnlyBooleanProperty
pressedProperty()
是否按下Node
。void
pseudoClassStateChanged(PseudoClass pseudoClass, boolean active)
用于指定此节点的伪类已更改。Object
queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
该方法由辅助技术调用以请求属性的值。void
relocate(double x, double y)
设置节点的layoutX和layoutY转换属性,以便将该节点重定位到父节点的x,y位置。<T extends Event>
voidremoveEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
从此节点注销先前注册的事件过滤器。<T extends Event>
voidremoveEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
从此节点注销先前注册的事件处理程序。void
requestFocus()
要求这个Node
得到输入焦点,而这个Node
的顶级祖先成为焦点窗口。void
resize(double width, double height)
如果节点可调整大小,将其布局边界设置为指定的宽度和高度。void
resizeRelocate(double x, double y, double width, double height)
如果节点可调整大小,将其布局边界设置为指定的宽度和高度。DoubleProperty
rotateProperty()
定义关于Node
中心的旋转角度,以度为单位。ObjectProperty<Point3D>
rotationAxisProperty()
定义Node
的旋转轴。DoubleProperty
scaleXProperty()
定义坐标按照该Node
沿着X轴的对象中心进行缩放的因子。DoubleProperty
scaleYProperty()
定义坐标按照该Node
的Y轴的对象中心进行缩放的因子。DoubleProperty
scaleZProperty()
定义坐标按照该Node
的Z轴的对象中心进行缩放的因子。ReadOnlyObjectProperty<Scene>
sceneProperty()
这Scene
是这个Node
的一部分。Point2D
sceneToLocal(double sceneX, double sceneY)
将一个点从场景的坐标空间转换为这个Node
的局部坐标空间。Point2D
sceneToLocal(double x, double y, boolean rootScene)
将一个点从场景的坐标空间转换为Node
的局部坐标空间。Point3D
sceneToLocal(double sceneX, double sceneY, double sceneZ)
将一个点从场景的坐标空间转换为Node
的局部坐标空间。Bounds
sceneToLocal(Bounds sceneBounds)
将矩形从场景的坐标空间转换为Node
的局部坐标空间。Bounds
sceneToLocal(Bounds bounds, boolean rootScene)
将场景的坐标空间的边界转换为Node
的局部坐标空间。Point2D
sceneToLocal(Point2D scenePoint)
将一个点从场景的坐标空间转换为此Node
的局部坐标空间。Point2D
sceneToLocal(Point2D point, boolean rootScene)
将点从场景的坐标空间转换为此Node
的局部坐标空间。Point3D
sceneToLocal(Point3D scenePoint)
将一个点从场景的坐标空间转换为Node
的局部坐标空间。Point2D
screenToLocal(double screenX, double screenY)
将一个点从Screen
的坐标空间转换为此Node
的本地坐标空间。Bounds
screenToLocal(Bounds screenBounds)
将矩形从Screen
的坐标空间转换为此Node
的局部坐标空间。Point2D
screenToLocal(Point2D screenPoint)
将来自该坐标空间中的点Screen
这个局部坐标空间Node
。void
setAccessibleHelp(String value)
设置属性accessibleHelp的值。void
setAccessibleRole(AccessibleRole value)
设置属性accessibilityRole的值。void
setAccessibleRoleDescription(String value)
设置属性accessibilityRoleDescription的值。void
setAccessibleText(String value)
设置属性accessibleText的值。void
setBlendMode(BlendMode value)
设置blendMode属性的值。void
setCache(boolean value)
设置属性缓存的值。void
setCacheHint(CacheHint value)
设置属性cacheHint的值。void
setClip(Node value)
设置属性剪辑的值。void
setCursor(Cursor value)
设置属性游标的值。void
setDepthTest(DepthTest value)
设置属性depthTest的值。void
setDisable(boolean value)
设置属性的值禁用。protected void
setDisabled(boolean value)
设置禁用属性的值。void
setEffect(Effect value)
设置属性效果的值。void
setEventDispatcher(EventDispatcher value)
设置属性eventDispatcher的值。protected <T extends Event>
voidsetEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
设置要用于此事件类型的处理程序。protected void
setFocused(boolean value)
设置集中的属性的值。void
setFocusTraversable(boolean value)
设置focusTraversable属性的值。protected void
setHover(boolean value)
设置属性悬停的值。void
setId(String value)
设置属性id的值。void
setInputMethodRequests(InputMethodRequests value)
设置属性inputMethodRequests的值。void
setLayoutX(double value)
设置属性layoutX的值。void
setLayoutY(double value)
设置属性layoutY的值。void
setManaged(boolean value)
设置管理的属性的值。void
setMouseTransparent(boolean value)
设置属性mouseTransparent的值。void
setNodeOrientation(NodeOrientation orientation)
设置属性nodeOrientation的值。void
setOnContextMenuRequested(EventHandler<? super ContextMenuEvent> value)
设置属性onContextMenuRequested的值。void
setOnDragDetected(EventHandler<? super MouseEvent> value)
设置属性onDragDetected的值。void
setOnDragDone(EventHandler<? super DragEvent> value)
设置属性onDragDone的值。void
setOnDragDropped(EventHandler<? super DragEvent> value)
设置属性onDragDropped的值。void
setOnDragEntered(EventHandler<? super DragEvent> value)
设置属性onDragEntered的值。void
setOnDragExited(EventHandler<? super DragEvent> value)
设置属性onDragExited的值。void
setOnDragOver(EventHandler<? super DragEvent> value)
设置属性onDragOver的值。void
setOnInputMethodTextChanged(EventHandler<? super InputMethodEvent> value)
设置属性onInputMethodTextChanged的值。void
setOnKeyPressed(EventHandler<? super KeyEvent> value)
设置属性onKeyPressed的值。void
setOnKeyReleased(EventHandler<? super KeyEvent> value)
设置属性onKeyReleased的值。void
setOnKeyTyped(EventHandler<? super KeyEvent> value)
设置属性onKeyTyped的值。void
setOnMouseClicked(EventHandler<? super MouseEvent> value)
设置属性onMouseClicked的值。void
setOnMouseDragEntered(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragEntered的值。void
setOnMouseDragExited(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragExited的值。void
setOnMouseDragged(EventHandler<? super MouseEvent> value)
设置属性onMouseDragged的值。void
setOnMouseDragOver(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragOver的值。void
setOnMouseDragReleased(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragReleased的值。void
setOnMouseEntered(EventHandler<? super MouseEvent> value)
设置属性onMouseEntered的值。void
setOnMouseExited(EventHandler<? super MouseEvent> value)
设置属性onMouseExited的值。void
setOnMouseMoved(EventHandler<? super MouseEvent> value)
设置属性onMouseMoved的值。void
setOnMousePressed(EventHandler<? super MouseEvent> value)
设置属性onMousePressed的值。void
setOnMouseReleased(EventHandler<? super MouseEvent> value)
设置属性onMouseReleased的值。void
setOnRotate(EventHandler<? super RotateEvent> value)
设置属性onRotate的值。void
setOnRotationFinished(EventHandler<? super RotateEvent> value)
设置属性onRotationFinished的值。void
setOnRotationStarted(EventHandler<? super RotateEvent> value)
设置属性onRotationStarted的值。void
setOnScroll(EventHandler<? super ScrollEvent> value)
设置属性onScroll的值。void
setOnScrollFinished(EventHandler<? super ScrollEvent> value)
设置属性onScrollFinished的值。void
setOnScrollStarted(EventHandler<? super ScrollEvent> value)
设置属性onScrollStarted的值。void
setOnSwipeDown(EventHandler<? super SwipeEvent> value)
设置属性onSwipeDown的值。void
setOnSwipeLeft(EventHandler<? super SwipeEvent> value)
设置属性onSwipeLeft的值。void
setOnSwipeRight(EventHandler<? super SwipeEvent> value)
设置属性onSwipeRight的值。void
setOnSwipeUp(EventHandler<? super SwipeEvent> value)
设置属性onSwipeUp的值。void
setOnTouchMoved(EventHandler<? super TouchEvent> value)
设置属性onTouchMoved的值。void
setOnTouchPressed(EventHandler<? super TouchEvent> value)
设置属性onTouchPressed的值。void
setOnTouchReleased(EventHandler<? super TouchEvent> value)
设置属性onTouchReleased的值。void
setOnTouchStationary(EventHandler<? super TouchEvent> value)
设置属性onTouchStationary的值。void
setOnZoom(EventHandler<? super ZoomEvent> value)
设置Zoom上的属性值。void
setOnZoomFinished(EventHandler<? super ZoomEvent> value)
设置属性onZoomFinished的值。void
setOnZoomStarted(EventHandler<? super ZoomEvent> value)
设置属性onZoomStarted的值。void
setOpacity(double value)
设置属性不透明度的值。void
setPickOnBounds(boolean value)
设置属性pickOnBounds的值。protected void
setPressed(boolean value)
设置按下的属性的值。void
setRotate(double value)
设置属性rotate的值。void
setRotationAxis(Point3D value)
设置属性rotateAxis的值。void
setScaleX(double value)
设置属性scaleX的值。void
setScaleY(double value)
设置属性scaleY的值。void
setScaleZ(double value)
设置属性scaleZ的值。void
setStyle(String value)
与此特定的Node
相关联的CSS样式的字符串表示Node
。void
setTranslateX(double value)
设置属性translateX的值。void
setTranslateY(double value)
设置属性translateY的值。void
setTranslateZ(double value)
设置属性translateZ的值。void
setUserData(Object value)
用于设置可以在以后检索的单个Object属性的便利方法。void
setViewOrder(double value)
设置属性viewOrder的值。void
setVisible(boolean value)
设置属性的值可见。WritableImage
snapshot(SnapshotParameters params, WritableImage image)
获取该节点的快照,并在渲染图像准备就绪时返回。void
snapshot(Callback<SnapshotResult,Void> callback, SnapshotParameters params, WritableImage image)
在下一帧获取该节点的快照,并在映像准备就绪时调用指定的回调方法。Dragboard
startDragAndDrop(TransferMode... transferModes)
确认一个潜在的拖放手势,在这Node
被认可。void
startFullDrag()
开始一个完整的按下 - 拖动释放手势与该节点作为手势源。StringProperty
styleProperty()
与此特定Node
相关联的CSS样式的字符串表示Node
。void
toBack()
按照z顺序将此Node
移动到其兄弟节点的后面。void
toFront()
将这个Node
按照z顺序移动到其兄弟节点的前面。String
toString()
返回对象的字符串表示形式。DoubleProperty
translateXProperty()
定义添加到此Node
的转换的转换的x坐标。DoubleProperty
translateYProperty()
定义添加到此Node
的转换中的转换的y坐标。DoubleProperty
translateZProperty()
定义添加到此Node
的转换坐标的转换的Z坐标。boolean
usesMirroring()
确定当节点方向是从右到左时是否应该镜像节点。DoubleProperty
viewOrderProperty()
定义其父项中的Node
的呈现和拣配顺序。BooleanProperty
visibleProperty()
指定此Node
和任何子节点是否应呈现为场景图的一部分。-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface javafx.css.Styleable
getStyleableNode
-
-
-
-
Property Detail
-
parent
public final ReadOnlyObjectProperty<Parent> parentProperty
这是Node
的父母。 如果此Node
尚未添加到场景图中,则父级将为空。- Default value:
- 空值
- 另请参见:
-
getParent()
-
scene
public final ReadOnlyObjectProperty<Scene> sceneProperty
该Scene
,这Node
是一部分。 如果节点不是场景的一部分,则该变量将为空。- Default value:
- 空值
- 另请参见:
-
getScene()
-
id
public final StringProperty idProperty
这个id的这个Node
。 这个简单的字符串标识符可用于在场景图中查找特定的节点。 虽然节点的ID在场景图中应该是唯一的,但是这种唯一性不会被强制执行。 这类似于HTML元素( CSS ID Specification )上的“id”属性。例如,如果节点的ID为“myId”,则可以使用查找方法查找此节点,如下所示:
scene.lookup("#myId");
。- Default value:
- 空值
- 另请参见:
-
getId()
,setId(String)
-
style
public final StringProperty styleProperty
与此特定的Node
相关联的CSS样式的字符串表示Node
。 这类似于HTML元素的“样式”属性。 请注意,像HTML样式属性一样,此变量包含样式属性和值,而不包含样式规则的选择器部分。- Default value:
- 空字符串
- 另请参见:
-
getStyle()
,setStyle(String)
-
visible
public final BooleanProperty visibleProperty
指定此Node
和任何子节点是否应呈现为场景图的一部分。 节点可能是可见的,但是如果例如它离开屏幕或被另一个节点遮蔽,则可以在渲染的场景中显示。 隐形节点永远不会接收鼠标事件或键盘焦点,并且在不可见时不会保持键盘焦点。- Default value:
- 真正
- 另请参见:
-
isVisible()
,setVisible(boolean)
-
cursor
public final ObjectProperty<Cursor> cursorProperty
为此Node
和子节点定义鼠标光标。 如果为空,则将使用具有非空游标的第一个父节点的游标。 如果场景图中没有节点定义了游标,则将使用Scene
的游标。- Default value:
- 空值
- 另请参见:
-
getCursor()
,setCursor(Cursor)
-
opacity
public final DoubleProperty opacityProperty
指定Node
不透明(即固体)。 0%不透明度的节点是完全半透明的。 也就是说,虽然它仍然是visible
并呈现,你通常将无法看到它。 此规则的例外情况是当Node
与混合模式和混合效果结合使用时,半透明节点可能仍然对渲染有影响。 50%的不透明度将使节点呈现50%的透明度。具有任何不透明度设置的
visible
节点仍然接收鼠标事件并可以接收键盘焦点。 例如,如果要在场景图中有一个大的不可见矩形覆盖所有Node
s,以截取鼠标事件,但用户不可见,则可以创建一个不透明度为0%的大型Rectangle
。不透明度被指定为介于0和1之间的值。小于0的值被视为0,大于1的值被视为1。
在某些平台上,ImageView可能不支持opacity变量。
有一个已知的混合不透明度<1.0与3D变换的限制。 不透明度/混合本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的不透明度<1.0的结果将导致其孩子被顺序渲染,而不会在这些孩子之间施加Z缓冲。- Default value:
- 1.0
- 另请参见:
-
getOpacity()
,setOpacity(double)
-
blendMode
public final ObjectProperty<BlendMode> blendModeProperty
BlendMode
用于将这个单独的节点混合到其后面的场景中。 如果这个节点恰好是一个组,那么所有的子节点都将使用自己的混合模式单独合成一个临时缓冲区,然后临时缓冲区将使用指定的混合模式合成到场景中。 值null
被视为通过,虽然这意味着对单个节点等父类(如组)和等效的SRC_OVER无影响。- Default value:
- 空值
- 另请参见:
-
getBlendMode()
,setBlendMode(BlendMode)
-
clip
public final ObjectProperty<Node> clipProperty
指定一个Node
用于定义此节点的剪切形状。 这个剪辑节点不是这个Node
在场景图形中的一个孩子。 相反,它用于定义此Node
的剪辑。例如,您可以使用
ImageView
节点作为掩码来表示剪辑。 或者您可以使用几何形状节点之一,如Rectangle
或Circle
。 或者您可以使用Text
节点来表示剪辑。有关设置剪辑的场景图结构限制,请参阅
Node
的类文档。 如果对clip变量的更改违反了这些限制,则忽略该更改,并恢复剪辑变量的先前值。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SHAPE_CLIP
。将Clip与3D Transform混合存在一个已知的限制。 剪切本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置Clip的结果将导致其孩子被顺序渲染,而不会在这些孩子之间施加Z缓冲。- Default value:
- 空值
- 另请参见:
-
getClip()
,setClip(Node)
-
cache
public final BooleanProperty cacheProperty
系统的性能提示表明,这个Node
应该被缓存为一个位图。 在许多情况下,渲染节点的位图表示将比渲染图元更快,特别是在应用了效果的图元的情况下(如模糊)。 但是,它也增加了内存使用量。 这个提示表明这种权衡(增加的性能的内存使用增加)是否值得。 还要注意,在某些平台上,如GPU加速平台,使用模糊和其他效果时,将节点缓存为位图几乎没有什么好处,因为它们在GPU上渲染速度非常快。cacheHintProperty()
变量提供了更多选项来实现更积极的位图缓存。对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。
- Default value:
- 假
- 另请参见:
-
isCache()
,setCache(boolean)
-
cacheHint
public final ObjectProperty<CacheHint> cacheHintProperty
控制位图缓存的其他提示。在某些情况下,例如对于呈现非常昂贵的动画节点,希望能够在节点上执行转换而不必重新生成缓存的位图。 在这种情况下,选项是对缓存位图本身进行转换。
这种技术可以显着提高动画性能,但也可能导致视觉质量下降。
cacheHint
变量为系统提供了关于如何以及何时可以接受折衷(动画性能的视觉质量)的提示。只有在您的节点动画化的时候才能启用cacheHint。 以这种方式,昂贵的节点可以出现在屏幕上,具有完整的视觉质量,但仍然是平稳的动画。
例:
expensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();
cacheHint
只是系统的一个提示。 根据节点或变换的细节,此提示可能会被忽略。如果
Node.cache
为false,则将忽略cacheHint。 对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。- Default value:
- CacheHint.DEFAULT
- 另请参见:
-
getCacheHint()
,setCacheHint(CacheHint)
-
effect
public final ObjectProperty<Effect> effectProperty
指定应用于此Node
的效果。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.EFFECT
。混合效果与3D变换有一个已知的限制。 效果本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置效果的结果将导致其孩子被顺序呈现,而不会在这些孩子之间施加Z缓冲。- Default value:
- 空值
- 另请参见:
-
getEffect()
,setEffect(Effect)
-
depthTest
public final ObjectProperty<DepthTest> depthTestProperty
指示在渲染此节点时是否使用深度测试。 如果depthTest标志为DepthTest.DISABLE
,则该节点的深度测试被禁用。 如果depthTest标志为DepthTest.ENABLE
,则对该节点启用深度测试。 如果depthTest标志为DepthTest.INHERIT
,则如果为父节点启用了深度测试,则父节点为null。所述depthTest标志仅用于当深度缓存中标志为
Scene
为真(意味着Scene
具有相关联的深度缓冲器)深度测试比较仅在启用了depthTest的节点之间进行。 禁用depthTest的节点不读取,测试或写入深度缓冲区,也就是说,其Z值不会被考虑用于与其他节点的深度测试。
请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。使用depthBuffer查看Scene中的构造函数作为其输入参数之一。
- Default value:
- 继承
- 另请参见:
-
getDepthTest()
,setDepthTest(DepthTest)
-
disable
public final BooleanProperty disableProperty
定义此Node
的个人禁用状态。 将disable
设置为true将导致此Node
和任何子节点成为禁用。 该属性应仅用于设置禁用状态为Node
。 对于查询的禁用状态Node
,该disabled
财产应改为使用,因为它可能是一个Node
作为祖先的结果被禁用即使个别被禁用disable
在这种状态下Node
为false
。- Default value:
- 假
- 另请参见:
-
isDisable()
,setDisable(boolean)
-
pickOnBounds
public final BooleanProperty pickOnBoundsProperty
定义当由MouseEvent
或contains
函数调用触发时,如何为此节点完成拣选计算。 如果pickOnBounds
为真,则通过与该节点的边界相交来计算拾取,否则通过与该节点的几何形状相交来计算拾取。- Default value:
- 假
- 另请参见:
-
isPickOnBounds()
,setPickOnBounds(boolean)
-
disabled
public final ReadOnlyBooleanProperty disabledProperty
指示此Node
是否被禁用。 如果disable
在其本身或场景图中的其祖先之一上设置为true
,则Node
将被禁用。禁用的
Node
应该呈现不同的方式,以指示其对用户的禁用状态。 这种禁用渲染取决于Node
的实现。javafx.scene.shape
包含的形状类默认情况下不实现此类渲染,因此使用形状处理输入的应用程序必须实现适当的禁用渲染本身。 然而,javafx.scene.control
定义的用户界面控件将实现禁用敏感的渲染。禁用的
Node
不会接收鼠标或键事件。- Default value:
- 假
- 另请参见:
-
isDisabled()
,setDisabled(boolean)
-
onDragEntered
public final ObjectProperty<EventHandler<? super DragEvent>> onDragEnteredProperty
定义当拖动手势进入Node
时要调用的功能。
-
onDragExited
public final ObjectProperty<EventHandler<? super DragEvent>> onDragExitedProperty
定义当拖动手势退出Node
时要调用的函数。
-
onDragOver
public final ObjectProperty<EventHandler<? super DragEvent>> onDragOverProperty
定义当这个Node
拖动手势进度时要调用的函数。
-
onDragDropped
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty
定义当在拖放手势时释放鼠标按钮Node
时要调用的功能。 在DragEvent
的dragboard
中传输数据应该发生在此功能中。
-
onDragDone
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty
定义当这个Node
是一个拖放手势源后,它的数据被放在放置目标上之后被调用的函数。 该事件的transferMode
显示刚刚发生的下降目标。 如果transferMode
具有值MOVE
,则源可以清除其数据。 清除源的数据给用户通过拖放手势移动了数据的适当外观。 甲transferMode
具有值NONE
指示拖放手势期间没有数据被转移。
-
managed
public final BooleanProperty managedProperty
定义该节点的布局是否由父节点管理。 如果节点被管理,那么它的父节点会将节点的几何因子归因于其自己的首选大小和layoutBounds
计算,并将在场景的布局过程中进行排列。 如果受管节点的layoutBounds更改,它将自动触发将场景图转发到最近的布局根(通常是场景的根节点)。如果节点不受管理,其父级将忽略两个首选大小的计算和布局中的子节点。 layoutBounds中的更改将不会在其上方触发中继。 如果非托管节点的类型为
Parent
,它将作为“布局根”,这意味着对其下的Parent.requestLayout()
的调用将仅导致由该节点生根的分支被中继,从而将布局更改隔离到该根和下面。 应用程序负责设置非托管节点的大小和位置。默认情况下所有节点都被管理。
- 另请参见:
-
isManaged()
,setManaged(boolean)
-
layoutX
public final DoubleProperty layoutXProperty
定义添加到Node
的转换中用于布局目的的转换的x坐标。 该值应该计算为将节点的位置从当前的layoutBounds minX
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
不能减去
layoutBounds minX
可能会导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutX。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。如果节点被管理并且以其父节点为
Region
,则布局区域将根据自己的布局策略设置layoutX
。 如果节点不是由Group
管理或者父母,则应用程序可以直接设置layoutX
来定位它。- 另请参见:
-
getLayoutX()
,setLayoutX(double)
-
layoutY
public final DoubleProperty layoutYProperty
定义为了布局目的而添加到此Node
的转换中的转换的y坐标。 该值应该计算为将节点的位置从当前的layoutBounds minY
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
不能减去
layoutBounds minY
可能会导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutY。节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,translateY
可选地对该位置进行动态调整。如果节点被管理,并且有一个
Region
作为其父节点,则该区域将根据其自己的布局策略设置layoutY
。 如果节点不是由Group
管理或父节点,则应用程序可以直接设置layoutY
来定位它。- 另请参见:
-
getLayoutY()
,setLayoutY(double)
-
boundsInParent
public final ReadOnlyObjectProperty<Bounds> boundsInParentProperty
这个Node
的矩形边界包括它的变换。boundsInParent
是通过采取局部边界(由boundsInLocal
定义)并应用通过设置以下附加变量创建的变换来计算的-
transforms
ObservableList -
scaleX
,scaleY
-
rotate
-
layoutX
,layoutY
-
translateX
,translateY
结果范围将在概念上在
Node
的父节点的坐标空间中,但是该节点不需要有父代来计算这些边界。请注意,此方法不考虑节点的可见性; 该计算仅基于该
Node
的几何。此属性将始终具有非空值。
请注意,只要节点的几何结构发生更改,或者当以下任何一项更改时,boundsInParent将自动重新计算:转换ObservableList,translateX,translateY,layoutX,layoutY,scaleX,scaleY或rotate变量。 因此,将节点中的任何值绑定到依赖于此变量的表达式是一个错误。 例如,为了定位节点,形状的x或y变量或translateX,translateY不应该被绑定到boundsInParent。
- 另请参见:
-
getBoundsInParent()
-
-
boundsInLocal
public final ReadOnlyObjectProperty<Bounds> boundsInLocalProperty
该节点未转换的局部坐标空间中的Node
的矩形边界。 对于扩展Shape
的节点,局部边界还将包括可能落在由位置和大小属性定义的形状几何体之外的非零行程所需的空间。 本地范围还将包括任何剪辑集clip
以及设置为effect
的效果。请注意,此方法不考虑节点的可见性; 该计算仅基于这个
Node
的几何。此属性将始终具有非空值。
请注意,只要节点的几何结构发生更改,boundsInLocal就会自动重新计算。 因此,将节点中的任何值绑定到依赖于此变量的表达式是一个错误。 例如,为了定位节点,形状的x或y变量不应该被绑定到boundsInLocal。
- 另请参见:
-
getBoundsInLocal()
-
layoutBounds
public final ReadOnlyObjectProperty<Bounds> layoutBoundsProperty
应该用于此节点的布局计算的矩形边界。layoutBounds
可能与节点的可视边界不同,并且根据节点类型而不同地计算。如果该节点类型是可调整大小(
Region
,Control
,或WebView
),则layoutBounds中永远是0,0 width x height
。 如果该节点类型是不可调整大小(Shape
,Text
,或Group
),则layoutBounds中计算基于所述节点的几何性质,并且不包括该节点的剪辑,效果或变换。 有关详细信息,请参阅各类课程文档需要注意的是
layoutX
,layoutY
,translateX
,并translateY
变量没有在layoutBounds。 这很重要,因为布局代码必须首先确定节点的当前大小和位置(使用layoutBounds),然后设置layoutX
和layoutY
以调整节点的翻译,以使其具有所需的布局位置。因为layoutBounds的计算通常与节点的几何变量相关联,所以将这些变量绑定到依赖于
layoutBounds
的表达式是一个错误。 例如,为了定位节点,不应将形状的x或y变量绑定到layoutBounds。layoutBounds永远不会为空。
- 另请参见:
-
getLayoutBounds()
-
viewOrder
public final DoubleProperty viewOrderProperty
定义其父项中的Node
的呈现和拣配顺序。此属性用于更改其父级中的节点的呈现和拣选顺序,而无需重新排序父级的
children
列表。 例如,这可以用作实现透明度排序的更有效的方法。 为此,应用程序可以将每个节点的viewOrder值分配给该节点和查看器之间的计算距离。父母将通过其
children
减少viewOrder
订单。 这意味着一个较小的viewOrder
的孩子将在一个较高的viewOrder
的孩子viewOrder
。 如果两个孩子有相同的viewOrder
,父母将按照父母children
列表中的顺序遍历它们。但是,
viewOrder
不会在此父节点中更改此节点的布局和重点遍历顺序。 当进行布局或聚焦遍历时,父对象总是按顺序遍历其children
列表。- Default value:
- 0.0
- 从以下版本开始:
- 9
- 另请参见:
-
getViewOrder()
,setViewOrder(double)
-
translateX
public final DoubleProperty translateXProperty
定义添加到此Node
的转换中的转换的x坐标。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。该变量可用于改变节点的位置而不会干扰其
layoutBounds
,这使得它有助于动画化节点的位置。- Default value:
- 0
- 另请参见:
-
getTranslateX()
,setTranslateX(double)
-
translateY
public final DoubleProperty translateYProperty
定义添加到此Node
的转换中的转换的y坐标。节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,translateY
可选地对该位置进行动态调整。该变量可用于改变节点的位置,而不会干扰其
layoutBounds
,这使得它有助于动画化节点的位置。- Default value:
- 0
- 另请参见:
-
getTranslateY()
,setTranslateY(double)
-
translateZ
public final DoubleProperty translateZProperty
定义添加到此Node
的转换坐标的平移的Z坐标。 该值将被添加到由transforms
ObservableList和layoutZ
定义的任何翻译。该变量可用于改变节点的位置,而不会影响其布局边界,这使得它有助于动画化节点的位置。
请注意,这是一个条件功能。 详见
ConditionalFeature.SCENE3D
。- Default value:
- 0
- 另请参见:
-
getTranslateZ()
,setTranslateZ(double)
-
scaleX
public final DoubleProperty scaleXProperty
定义坐标按照该Node
的X轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和转换后,对整个节点进行缩放是非常理想的。发生刻度的枢轴点是未转化的
layoutBounds
的中心。- Default value:
- 1.0
- 另请参见:
-
getScaleX()
,setScaleX(double)
-
scaleY
public final DoubleProperty scaleYProperty
定义坐标按照该Node
的Y轴对象对象中心进行比例的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在考虑了所有效果和转换后,可以缩放整个节点。尺度发生的枢轴点是未转化的
layoutBounds
的中心。- Default value:
- 1.0
- 另请参见:
-
getScaleY()
,setScaleY(double)
-
scaleZ
public final DoubleProperty scaleZProperty
定义坐标按照该Node
的Z轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,该比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在所有效果和转换都被考虑后,可以缩放整个节点。尺度发生的枢轴点是通过采用
boundsInLocal
形成的矩形边界的中心,并应用transforms
ObservableList中的所有变换。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。- Default value:
- 1.0
- 另请参见:
-
getScaleZ()
,setScaleZ(double)
-
rotate
public final DoubleProperty rotateProperty
定义关于Node
中心的旋转角度,以度为单位。 这是用来旋转Node
。默认情况下,这个旋转因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和变换之后,它是理想的旋转整个节点。旋转发生的枢轴点是未转化的
layoutBounds
的中心。请注意,由于枢轴点计算为此
Node
的布局边界的中心,对布局边界的任何更改将导致枢轴点更改,这可能会移动对象。 对于叶节点,几何的任何更改将导致布局边界更改。 对于组节点,对其任何子项的任何更改(包括对子组的几何,剪辑,效果,位置,方向或比例的更改)都将导致组的布局界限发生更改。 如果不需要枢纽点的这种移动,应用程序应该使用节点的transforms
ObservableList,并添加一个Rotate
变换,它具有用户可指定的枢轴点。- Default value:
- 0.0
- 另请参见:
-
getRotate()
,setRotate(double)
-
rotationAxis
public final ObjectProperty<Point3D> rotationAxisProperty
定义Node
的旋转轴。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。- Default value:
- Rotate.Z_AXIS
- 另请参见:
-
getRotationAxis()
,setRotationAxis(Point3D)
-
localToParentTransform
public final ReadOnlyObjectProperty<Transform> localToParentTransformProperty
保存计算的本地到父变换的仿射变换。 这是这个节点中所有变换的并置,包括所有的方便变换。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getLocalToParentTransform()
-
localToSceneTransform
public final ReadOnlyObjectProperty<Transform> localToSceneTransformProperty
拥有计算的局部到场景变换的仿射变换。 这是这个节点的父节点和这个节点中的所有变换的并置,包括到根节点的所有方便变换。 如果此节点在一个SubScene
中 ,则此属性表示转换为子视图,而不是根节点。请注意,当您注册侦听器或绑定到此属性时,它需要监听所有父进程对根节点的无效。 这意味着在许多节点上注册此属性的侦听器可能会对其父母中的转换更改的性能产生负面影响。
- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getLocalToSceneTransform()
-
nodeOrientation
public final ObjectProperty<NodeOrientation> nodeOrientationProperty
属性保存NodeOrientation。节点方向描述节点内视觉数据的流动。 在英语世界中,视觉数据通常从左到右流动。 在阿拉伯语或希伯来语世界,视觉数据从右到左流动。 这与两个世界的文本阅读顺序一致。 默认值是从左到右。
- 结果
- NodeOrientation
- 从以下版本开始:
- JavaFX 8.0
-
effectiveNodeOrientation
public final ReadOnlyObjectProperty<NodeOrientation> effectiveNodeOrientationProperty
节点的有效方向解决节点方向的继承,从左到右或从右到左返回。- 从以下版本开始:
- JavaFX 8.0
- 另请参见:
-
getEffectiveNodeOrientation()
-
mouseTransparent
public final BooleanProperty mouseTransparentProperty
如果true
,这个节点(连同它的所有子节点)对于鼠标事件是完全透明的。 当选择鼠标事件的目标时,mouseTransparent
设置为true
节点及其子树将不被考虑。
-
hover
public final ReadOnlyBooleanProperty hoverProperty
这Node
是否正在徘徊。 通常这是由于鼠标在节点上,尽管这可能是由于笔悬停在图形输入板或其他形式的输入上。请注意,当前实现的悬停依赖于鼠标进入和退出事件来确定此节点是否处于悬停状态; 这意味着目前仅在具有鼠标的系统上支持此功能。 未来的实现可以提供支持悬停的替代方式。
- Default value:
- 假
- 另请参见:
-
isHover()
,setHover(boolean)
-
pressed
public final ReadOnlyBooleanProperty pressedProperty
是否按下Node
。 通常,当主鼠标按钮处于关闭状态时,这是正确的,尽管子类可以定义其他鼠标按钮状态或键状态,以使节点“按下”。- Default value:
- 假
- 另请参见:
-
isPressed()
,setPressed(boolean)
-
onContextMenuRequested
public final ObjectProperty<EventHandler<? super ContextMenuEvent>> onContextMenuRequestedProperty
定义在Node
上请求上下文菜单时要调用的函数。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnContextMenuRequested()
,setOnContextMenuRequested(EventHandler)
-
onMouseClicked
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseClickedProperty
定义当这个Node
点击(按下和释放)鼠标按钮时要调用的功能。
-
onMouseDragged
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseDraggedProperty
定义当在此Node
上按下鼠标按钮然后拖动时要调用的功能。
-
onMouseEntered
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseEnteredProperty
定义当鼠标进入Node
时要调用的功能。
-
onMouseExited
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseExitedProperty
定义当鼠标退出Node
时要调用的函数。
-
onMouseMoved
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseMovedProperty
定义当这个Node
鼠标光标移动时调用的功能,但没有按钮被按下。
-
onMousePressed
public final ObjectProperty<EventHandler<? super MouseEvent>> onMousePressedProperty
定义在Node
上按下鼠标按钮时要调用的功能。
-
onMouseReleased
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseReleasedProperty
定义当这个Node
上释放鼠标按钮时要调用的函数。
-
onDragDetected
public final ObjectProperty<EventHandler<? super MouseEvent>> onDragDetectedProperty
定义检测到拖动手势时要调用的功能。 这是开始拖放操作的正确位置。
-
onMouseDragOver
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragOverProperty
定义当这个Node
的全按压拖动手势进行时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragOver()
,setOnMouseDragOver(EventHandler)
-
onMouseDragReleased
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragReleasedProperty
定义当这个Node
完全按下 - 拖动释放手势结束(通过释放鼠标按钮)时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragReleased()
,setOnMouseDragReleased(EventHandler)
-
onMouseDragEntered
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragEnteredProperty
定义当全按压拖动手势进入这个Node
时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragEntered()
,setOnMouseDragEntered(EventHandler)
-
onMouseDragExited
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragExitedProperty
定义当完全按下 - 拖动释放手势离开这个Node
时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragExited()
,setOnMouseDragExited(EventHandler)
-
onScrollStarted
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollStartedProperty
定义检测到滚动手势时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnScrollStarted()
,setOnScrollStarted(EventHandler)
-
onScroll
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollProperty
定义当用户执行滚动操作时要调用的函数。
-
onScrollFinished
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollFinishedProperty
定义当滚动手势结束时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnScrollFinished()
,setOnScrollFinished(EventHandler)
-
onRotationStarted
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationStartedProperty
定义检测到旋转手势时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotationStarted()
,setOnRotationStarted(EventHandler)
-
onRotate
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotateProperty
定义当用户执行旋转操作时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotate()
,setOnRotate(EventHandler)
-
onRotationFinished
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationFinishedProperty
定义旋转手势结束时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotationFinished()
,setOnRotationFinished(EventHandler)
-
onZoomStarted
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomStartedProperty
定义检测到缩放手势时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoomStarted()
,setOnZoomStarted(EventHandler)
-
onZoom
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomProperty
定义当用户执行缩放操作时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoom()
,setOnZoom(EventHandler)
-
onZoomFinished
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomFinishedProperty
定义当缩放手势结束时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoomFinished()
,setOnZoomFinished(EventHandler)
-
onSwipeUp
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeUpProperty
定义当在该节点上居中的向上滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeUp()
,setOnSwipeUp(EventHandler)
-
onSwipeDown
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeDownProperty
定义当在该节点上居中的向下滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeDown()
,setOnSwipeDown(EventHandler)
-
onSwipeLeft
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeLeftProperty
定义当以该节点为中心的向左滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeLeft()
,setOnSwipeLeft(EventHandler)
-
onSwipeRight
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeRightProperty
定义当以该节点为中心的向右滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeRight()
,setOnSwipeRight(EventHandler)
-
onTouchPressed
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchPressedProperty
定义当按下新的触摸点时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchPressed()
,setOnTouchPressed(EventHandler)
-
onTouchMoved
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchMovedProperty
定义当触摸点移动时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchMoved()
,setOnTouchMoved(EventHandler)
-
onTouchReleased
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchReleasedProperty
定义触发点释放时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchReleased()
,setOnTouchReleased(EventHandler)
-
onTouchStationary
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchStationaryProperty
定义当触摸点保持按下并静止时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchStationary()
,setOnTouchStationary(EventHandler)
-
onKeyPressed
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyPressedProperty
定义当这个Node
或其子项Node
具有输入焦点并按下一个键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onKeyReleased
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyReleasedProperty
定义当这个Node
或其子代Node
具有输入焦点并且键被释放时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onKeyTyped
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyTypedProperty
定义当这个Node
或其子代Node
具有输入焦点并键入了一个键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onInputMethodTextChanged
public final ObjectProperty<EventHandler<? super InputMethodEvent>> onInputMethodTextChangedProperty
定义当这个Node
具有输入焦点并且输入法文本已更改时要调用的函数。 如果此功能未在此Node
定义,则它会将输入法组合的结果字符串接收为一系列onKeyTyped
函数调用。当
Node
丢失输入焦点时,JavaFX运行时自动提交现有的合成文本(如果有)。
-
inputMethodRequests
public final ObjectProperty<InputMethodRequests> inputMethodRequestsProperty
属性保存InputMethodRequests。
-
focused
public final ReadOnlyBooleanProperty focusedProperty
- Default value:
- 假
- 另请参见:
-
isFocused()
,setFocused(boolean)
-
focusTraversable
public final BooleanProperty focusTraversableProperty
指定此Node
应该是聚焦遍历周期的一部分。 当这个属性是true
焦点可以移动到这个Node
和从这Node
使用常规焦点遍历键。 在桌面上,这样的键通常是TAB
用于向前移动焦点和SHIFT+TAB
用于向后移动焦点。 当创建Scene
,系统Node
焦点放在Node
其focusTraversable
变量为true,并且有资格接收焦点,除非通过调用requestFocus()
显式设置了焦点。- Default value:
- 假
- 另请参见:
-
isFocusTraversable()
,setFocusTraversable(boolean)
-
eventDispatcher
public final ObjectProperty<EventDispatcher> eventDispatcherProperty
指定此节点的事件分派器。 默认事件调度程序将接收的事件发送到已注册的事件处理程序和过滤器。 当使用新的EventDispatcher
替换值时,新的调度程序应将事件转发到已替换的调度程序,以维护节点的默认事件处理行为。
-
accessibleRole
public final ObjectProperty<AccessibleRole> accessibleRoleProperty
这个Node
的可访问角色。屏幕阅读器使用节点的角色来确定支持的属性和动作。
- Default value:
-
AccessibleRole.NODE
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleRole()
,setAccessibleRole(AccessibleRole)
-
accessibleRoleDescription
public final ObjectProperty<String> accessibleRoleDescriptionProperty
这个角色描述Node
。可以说,当为节点提供角色时,屏幕阅读器说出节点的作用以及内容。 当设置此值时,可以覆盖默认值。 这是有用的,因为角色集是预定义的。 例如,可以将节点的角色设置为按钮,但将角色描述设置为任意文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleRoleDescription()
,setAccessibleRoleDescription(String)
-
accessibleText
public final ObjectProperty<String> accessibleTextProperty
Node
的可访问文本。此属性用于设置屏幕阅读器将发言的文本。 如果一个节点通常会说文字,那么该文本就会被覆盖。 例如,一个按钮通常使用控件中的文本,但在设置此值时将不再执行此操作。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleText()
,setAccessibleText(String)
-
accessibleHelp
public final ObjectProperty<String> accessibleHelpProperty
该Node
的可访问的帮助文本。帮助文本提供了节点可访问文本的更详细描述。 默认情况下,如果节点具有工具提示,则使用此文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleHelp()
,setAccessibleHelp(String)
-
-
字段详细信息
-
BASELINE_OFFSET_SAME_AS_HEIGHT
public static final double BASELINE_OFFSET_SAME_AS_HEIGHT
这是一个可能由getBaselineOffset()
返回的特殊值。 这意味着此节点的父(布局窗格)应使用此节点的高度作为基线。- 另请参见:
- Constant Field Values
-
-
方法详细信息
-
getProperties
public final ObservableMap<Object,Object> getProperties()
返回此节点上属性的可观察图,主要由应用程序开发人员使用。- 结果
- 该节点上属性的可观察地图主要由应用程序开发人员使用
-
hasProperties
public boolean hasProperties()
测试节点是否具有属性。- 结果
- 如果节点有属性,则为true。
-
setUserData
public void setUserData(Object value)
用于设置可以在以后检索的单个Object属性的便利方法。 这在功能上等同于调用getProperties()。put(Object key,Object value)方法。 这可以稍后通过调用getUserData()
来检索。- 参数
-
value
- 要存储的值 - 以后可以通过调用getUserData()
来检索。
-
getUserData
public Object getUserData()
返回先前设置的Object属性,如果没有使用setUserData(java.lang.Object)
方法设置此属性,则返回null。- 结果
- 先前设置的对象,如果没有设置属性或设置为null,则为null。
-
getParent
public final Parent getParent()
获取属性parent的值。- Property description:
-
这是
Node
的父母。 如果此Node
尚未添加到场景图中,则父级将为空。 - Default value:
- 空值
-
parentProperty
public final ReadOnlyObjectProperty<Parent> parentProperty()
这是Node
的父母。 如果此Node
尚未添加到场景图中,则父级将为空。- Default value:
- 空值
- 另请参见:
-
getParent()
-
getScene
public final Scene getScene()
获取属性场景的值。- Property description:
-
Scene
这个Node
是其中的一部分。 如果节点不是场景的一部分,则该变量将为空。 - Default value:
- 空值
-
sceneProperty
public final ReadOnlyObjectProperty<Scene> sceneProperty()
Scene
这个Node
是其中的一部分。 如果节点不是场景的一部分,则该变量将为空。- Default value:
- 空值
- 另请参见:
-
getScene()
-
setId
public final void setId(String value)
设置属性id的值。- Property description:
-
该
Node
为Node
。 这个简单的字符串标识符可用于在场景图中查找特定的节点。 虽然节点的ID在场景图中应该是唯一的,但是这种唯一性不会被强制执行。 这类似于HTML元素上的“id”属性( CSS ID Specification )。例如,如果节点的ID为“myId”,则可以使用查找方法来查找此节点,如下所示:
scene.lookup("#myId");
。 - Default value:
- 空值
-
getId
public final String getId()
该Node
为Node
。 这个简单的字符串标识符可用于在场景图中查找特定的节点。 虽然节点的ID在场景图中应该是唯一的,但是这种唯一性不会被强制执行。 这类似于HTML元素上的“id”属性( CSS ID Specification )。- Specified by:
-
getId
在接口Styleable
- Default value:
- 空值
- 结果
-
使用
setId
方法或null
分配给此Node
的ID,如果没有分配ID。 - 另请参见:
- CSS Reference Guide
-
idProperty
public final StringProperty idProperty()
这个id的这个Node
。 这个简单的字符串标识符可用于在场景图中查找特定的节点。 虽然节点的ID在场景图中应该是唯一的,但是这种唯一性不会被强制执行。 这类似于HTML元素上的“id”属性( CSS ID Specification )。例如,如果节点的ID为“myId”,则可以使用lookup方法来查找此节点,如下所示:
scene.lookup("#myId");
。- Default value:
- 空值
- 另请参见:
-
getId()
,setId(String)
-
getStyleClass
public final ObservableList<String> getStyleClass()
描述从接口Styleable
复制可用于逻辑组合节点的字符串标识符列表,专门用于外部样式引擎。 该变量类似于HTML元素上的“类”属性,因此列表的每个元素都是此节点所属的样式类。- Specified by:
-
getStyleClass
在接口Styleable
- 结果
- 可用于逻辑组合节点的字符串标识符列表,专门用于外部样式引擎
- 另请参见:
- CSS3 class selectors
-
setStyle
public final void setStyle(String value)
与此特定的Node
相关联的CSS样式的字符串表示Node
。 这类似于HTML元素的“样式”属性。 请注意,像HTML样式属性一样,此变量包含样式属性和值,而不包含样式规则的选择器部分。- Default value:
- 空字符串
- 参数
-
value
- 用于此Node
的内联CSS样式。null
隐式转换为空字符串。 - 另请参见:
- CSS Reference Guide
-
getStyle
public final String getStyle()
与此特定的Node
相关联的CSS样式的字符串表示Node
。 这类似于HTML元素的“样式”属性。 请注意,像HTML样式属性一样,此变量包含样式属性和值,而不包含样式规则的选择器部分。- Specified by:
-
getStyle
在接口Styleable
- Default value:
- 空字符串
- 结果
-
与此
Node
相关联的内联CSS样式。 如果此Node
没有内联样式,则返回一个空字符串。 - 另请参见:
- CSS Reference Guide
-
styleProperty
public final StringProperty styleProperty()
与此特定的Node
相关联的CSS样式的字符串表示Node
。 这类似于HTML元素的“样式”属性。 请注意,像HTML样式属性一样,此变量包含样式属性和值,而不包含样式规则的选择器部分。- Default value:
- 空字符串
- 另请参见:
-
getStyle()
,setStyle(String)
-
setVisible
public final void setVisible(boolean value)
设置属性的值可见。- Property description:
-
指定此
Node
和任何子节点是否应呈现为场景图的一部分。 节点可能是可见的,但是如果例如它离开屏幕或被另一个节点遮蔽,则可以在渲染的场景中显示。 隐形节点永远不会接收鼠标事件或键盘焦点,并且在不可见时不会保持键盘焦点。 - Default value:
- 真正
-
isVisible
public final boolean isVisible()
获取属性的值可见。- Property description:
-
指定此
Node
和任何子节点是否应呈现为场景图的一部分。 节点可能是可见的,但是如果例如它离开屏幕或被另一个节点遮蔽,则可以在渲染的场景中显示。 隐形节点永远不会接收鼠标事件或键盘焦点,并且在不可见时不会保持键盘焦点。 - Default value:
- 真正
-
visibleProperty
public final BooleanProperty visibleProperty()
指定此Node
和任何子节点是否应呈现为场景图的一部分。 节点可能是可见的,但是如果例如它离开屏幕或被另一个节点遮蔽,则可以在渲染的场景中显示。 隐形节点永远不会接收鼠标事件或键盘焦点,并且在不可见时不会保持键盘焦点。- Default value:
- 真正
- 另请参见:
-
isVisible()
,setVisible(boolean)
-
setCursor
public final void setCursor(Cursor value)
设置属性游标的值。- Property description:
-
为此
Node
和子节点定义鼠标光标。 如果为空,则将使用具有非空游标的第一个父节点的游标。 如果场景图中没有节点定义光标,则将使用Scene
的光标。 - Default value:
- 空值
-
getCursor
public final Cursor getCursor()
获取属性游标的值。- Property description:
-
为此
Node
和子节点定义鼠标光标。 如果为空,则将使用具有非空游标的第一个父节点的游标。 如果场景图中没有节点定义了游标,则将使用Scene
的光标。 - Default value:
- 空值
-
cursorProperty
public final ObjectProperty<Cursor> cursorProperty()
为此Node
和子节点定义鼠标光标。 如果为空,则将使用具有非空游标的第一个父节点的游标。 如果场景图中没有节点定义了游标,则将使用Scene
的光标。- Default value:
- 空值
- 另请参见:
-
getCursor()
,setCursor(Cursor)
-
setOpacity
public final void setOpacity(double value)
设置属性不透明度的值。- Property description:
-
指定
Node
不透明(即固体)。 0%不透明度的节点是完全半透明的。 也就是说,虽然它仍然是visible
并呈现,你通常将无法看到它。 这个规则的例外是当Node
与混合模式和混合效果相结合时,在这种情况下,半透明节点可能仍然对渲染有影响。 50%的不透明度将使节点呈现50%的透明度。具有任何不透明度设置的
visible
节点仍然接收鼠标事件并可以接收键盘焦点。 例如,如果要在场景图中拥有一个大的不可见矩形覆盖所有Node
s,以截取鼠标事件,但用户不可见,则可以创建一个不透明度为0%的大型Rectangle
。不透明度被指定为介于0和1之间的值。小于0的值被视为0,大于1的值被视为1。
在某些平台上,ImageView可能不支持opacity变量。
有一个已知的混合不透明度<1.0与3D变换的限制。 不透明度/混合本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的不透明度<1.0的结果将导致其孩子被顺序渲染,而不会在这些孩子之间施加Z缓冲。 - Default value:
- 1.0
-
getOpacity
public final double getOpacity()
获取属性不透明度的值。- Property description:
-
指定
Node
不透明(即固体)。 0%不透明度的节点是完全半透明的。 也就是说,虽然它仍然是visible
并且呈现,你通常将无法看到它。 这个规则的例外是当Node
与混合模式和混合效果相结合时,在这种情况下,半透明节点可能仍然对渲染有影响。 50%的不透明度将使节点呈现50%的透明度。具有任何不透明度设置的
visible
节点仍然接收鼠标事件并可以接收键盘焦点。 例如,如果要在场景图中有一个大的不可见矩形覆盖所有Node
s,以截取鼠标事件,但用户不可见,则可以创建一个不透明度为0%的大型Rectangle
。不透明度被指定为介于0和1之间的值。小于0的值被视为0,大于1的值被视为1。
在某些平台上,ImageView可能不支持opacity变量。
有一个已知的混合不透明度<1.0与3D变换的限制。 不透明度/混合本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的不透明度<1.0的结果将导致其孩子被依次渲染,而不会在这些孩子之间施加Z缓冲。 - Default value:
- 1.0
-
opacityProperty
public final DoubleProperty opacityProperty()
指定出现Node
不透明(即固体)。 0%不透明度的节点是完全半透明的。 也就是说,虽然它仍然是visible
并渲染,但你通常将无法看到它。 这个规则的例外是当Node
与混合模式和混合效果相结合时,在这种情况下,半透明节点可能仍然对渲染有影响。 50%的不透明度将使节点呈现50%的透明度。具有任何不透明度设置的
visible
节点仍然接收鼠标事件并可以接收键盘焦点。 例如,如果要在场景图中有一个大的不可见的矩形覆盖所有Node
,以拦截鼠标事件,但对用户不可见,则可以创建一个不透明度为0%的大型Rectangle
。不透明度被指定为介于0和1之间的值。小于0的值被视为0,大于1的值被视为1。
在某些平台上,ImageView可能不支持opacity变量。
有一个已知的混合不透明度<1.0与3D变换的限制。 不透明度/混合本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的不透明度<1.0的结果将导致其孩子被依次渲染,而不会在这些孩子之间应用Z缓冲。- Default value:
- 1.0
- 另请参见:
-
getOpacity()
,setOpacity(double)
-
setBlendMode
public final void setBlendMode(BlendMode value)
设置blendMode属性的值。- Property description:
-
BlendMode
用于将此单个节点混合到其后面的场景中。 如果这个节点恰好是一个组,那么所有的子节点都将使用自己的混合模式单独合成一个临时缓冲区,然后临时缓冲区将使用指定的混合模式合成到场景中。 值null
被视为通过,虽然这意味着对单个节点等父类(例如组)和等效的SRC_OVER没有影响。 - Default value:
- 空值
-
getBlendMode
public final BlendMode getBlendMode()
获取属性blendMode的值。- Property description:
-
BlendMode
用于将此单个节点混合到其后面的场景中。 如果这个节点恰好是一个组,那么所有的子节点都将使用自己的混合模式单独合成一个临时缓冲区,然后临时缓冲区将使用指定的混合模式合成到场景中。 值null
被视为通过,这意味着对单个节点等父类(如组)和等效的SRC_OVER无影响。 - Default value:
- 空值
-
blendModeProperty
public final ObjectProperty<BlendMode> blendModeProperty()
BlendMode
用于将这个单独的节点混合到其后面的场景中。 如果这个节点恰好是一个组,那么所有的子节点都将使用自己的混合模式单独合成一个临时缓冲区,然后临时缓冲区将使用指定的混合模式合成到场景中。 值null
被视为通过,这意味着对单个节点等父类(如组)和等效的SRC_OVER无影响。- Default value:
- 空值
- 另请参见:
-
getBlendMode()
,setBlendMode(BlendMode)
-
setClip
public final void setClip(Node value)
设置属性剪辑的值。- Property description:
-
指定一个
Node
用于定义此节点的剪切形状。 这个剪辑节点不是场景图形中Node
的小孩。 相反,它用于定义此Node
的剪辑。例如,您可以使用
ImageView
节点作为掩码来表示剪辑。 或者您可以使用几何形状节点之一,如Rectangle
或Circle
。 或者您可以使用Text
节点来表示剪辑。有关设置剪辑的场景图结构限制,请参阅
Node
的类文档。 如果对clip变量的更改违反了这些限制,则忽略该更改,并恢复剪辑变量的先前值。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SHAPE_CLIP
。将Clip与3D Transform混合存在一个已知的限制。 剪切本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的剪辑的结果将导致其孩子被顺序呈现,而不在这些孩子之间施加Z缓冲。 - Default value:
- 空值
-
getClip
public final Node getClip()
获取属性剪辑的值。- Property description:
-
指定一个
Node
用于定义此节点的剪切形状。 这个剪辑节点不是场景图形中Node
一个小孩。 相反,它用于定义此Node
的剪辑。例如,您可以使用
ImageView
节点作为掩码来表示剪辑。 或者您可以使用几何形状节点之一,如Rectangle
或Circle
。 或者您可以使用Text
节点来表示剪辑。有关设置剪辑的场景图结构限制,请参阅
Node
的类文档。 如果对clip变量的更改违反了这些限制,则忽略该更改,并恢复剪辑变量的先前值。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SHAPE_CLIP
。将Clip与3D Transform混合存在一个已知的限制。 剪切本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置Clip的结果将导致其孩子被依次渲染,而不会在这些孩子之间施加Z缓冲。 - Default value:
- 空值
-
clipProperty
public final ObjectProperty<Node> clipProperty()
指定用于定义此节点的剪切形状的Node
。 这个剪辑节点不是场景图形中Node
一个小孩。 相反,它用于定义此Node
的剪辑。例如,您可以使用
ImageView
节点作为掩码来表示剪辑。 或者您可以使用几何形状节点之一,如Rectangle
或Circle
。 或者您可以使用Text
节点来表示剪辑。有关设置剪辑的场景图结构限制,请参阅
Node
的类文档。 如果对clip变量的更改违反了这些限制,则忽略该更改,并恢复剪辑变量的先前值。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SHAPE_CLIP
。将Clip与3D Transform混合存在一个已知的限制。 剪切本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置Clip的结果将导致其孩子被顺序渲染,而不会在这些孩子之间施加Z缓冲。- Default value:
- 空值
- 另请参见:
-
getClip()
,setClip(Node)
-
setCache
public final void setCache(boolean value)
设置属性缓存的值。- Property description:
-
系统的性能提示表明这个
Node
应该被缓存为一个位图。 在许多情况下,渲染节点的位图表示将比渲染图元更快,特别是在应用了效果的图元的情况下(如模糊)。 但是,它也增加了内存使用量。 这个提示表明这种权衡(增加的性能的内存使用增加)是否值得。 还要注意,在某些平台上,如GPU加速平台,使用模糊和其他效果时,将节点缓存为位图几乎没有什么好处,因为它们在GPU上渲染速度非常快。cacheHintProperty()
变量提供了更多选项来实现更积极的位图缓存。对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。
- Default value:
- 假
-
isCache
public final boolean isCache()
获取属性缓存的值。- Property description:
-
系统的性能提示表明这个
Node
应该被缓存为一个位图。 在许多情况下,渲染节点的位图表示将比渲染图元更快,特别是在应用了效果的图元的情况下(如模糊)。 但是,它也增加了内存使用量。 这个提示表明这种权衡(增加的性能的内存使用增加)是否值得。 还要注意,在某些平台上,如GPU加速平台,使用模糊和其他效果时,将节点缓存为位图几乎没有什么好处,因为它们在GPU上渲染速度非常快。cacheHintProperty()
变量提供了更多选项来实现更积极的位图缓存。对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。
- Default value:
- 假
-
cacheProperty
public final BooleanProperty cacheProperty()
系统的性能提示表明这个Node
应该被缓存为一个位图。 在许多情况下,渲染节点的位图表示将比渲染图元更快,特别是在应用了效果的图元的情况下(如模糊)。 但是,它也增加了内存使用量。 这个提示表明这种权衡(增加的性能的内存使用增加)是否值得。 还要注意,在某些平台上,如GPU加速平台,使用模糊和其他效果时,将节点缓存为位图几乎没有什么好处,因为它们在GPU上渲染速度非常快。cacheHintProperty()
变量提供了更多选项来实现更积极的位图缓存。对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。
- Default value:
- 假
- 另请参见:
-
isCache()
,setCache(boolean)
-
setCacheHint
public final void setCacheHint(CacheHint value)
设置属性cacheHint的值。- Property description:
-
控制位图缓存的其他提示。
在某些情况下,例如对于呈现非常昂贵的动画节点,希望能够在节点上执行转换而不必重新生成缓存的位图。 在这种情况下,选项是对缓存位图本身进行转换。
这种技术可以显着提高动画性能,但也可能导致视觉质量下降。
cacheHint
变量为系统提供了关于如何以及何时可以接受折衷(动画效果的视觉质量)的提示。只有在您的节点动画化的时候才能启用cacheHint。 以这种方式,昂贵的节点可以出现在屏幕上,具有完整的视觉质量,但仍然是平稳的动画。
例:
expensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();
cacheHint
只是系统的一个提示。 根据节点或变换的细节,此提示可能会被忽略。如果
Node.cache
为false,则将忽略cacheHint。 对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。 - Default value:
- CacheHint.DEFAULT
-
getCacheHint
public final CacheHint getCacheHint()
获取属性cacheHint的值。- Property description:
-
控制位图缓存的其他提示。
在某些情况下,例如对于呈现非常昂贵的动画节点,希望能够在节点上执行转换而不必重新生成缓存的位图。 在这种情况下,选项是对缓存位图本身进行转换。
这种技术可以显着提高动画性能,但也可能导致视觉质量下降。
cacheHint
变量为系统提供了关于如何以及何时可以接受折衷(动画表现的视觉质量)的提示。只有在您的节点动画化的时候才能启用cacheHint。 以这种方式,昂贵的节点可以出现在屏幕上,具有完整的视觉质量,但仍然是平稳的动画。
例:
expensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();
cacheHint
只是系统的提示。 根据节点或变换的细节,此提示可能会被忽略。如果
Node.cache
为false,则将忽略cacheHint。 对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。 - Default value:
- CacheHint.DEFAULT
-
cacheHintProperty
public final ObjectProperty<CacheHint> cacheHintProperty()
控制位图缓存的其他提示。在某些情况下,例如对于呈现非常昂贵的动画节点,希望能够在节点上执行转换而不必重新生成缓存的位图。 在这种情况下,选项是对缓存位图本身进行转换。
这种技术可以显着提高动画性能,但也可能导致视觉质量下降。
cacheHint
变量为系统提供了关于如何以及何时可以接受折衷(动画表现的视觉质量)的提示。只有在您的节点动画化的时候才能启用cacheHint。 以这种方式,昂贵的节点可以出现在屏幕上,具有完整的视觉质量,但仍然是平稳的动画。
例:
expensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();
cacheHint
只是系统的一个暗示。 根据节点或变换的细节,此提示可能会被忽略。如果
Node.cache
为false,则将忽略cacheHint。 对于自身,任何其祖先或其任何后代都有3D变换的任何节点,可能禁用缓存。- Default value:
- CacheHint.DEFAULT
- 另请参见:
-
getCacheHint()
,setCacheHint(CacheHint)
-
setEffect
public final void setEffect(Effect value)
设置属性效果的值。- Property description:
-
指定应用于此
Node
的效果。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.EFFECT
。混合效果与3D变换有一个已知的限制。 效果本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的效果的结果将导致其孩子被顺序呈现,而不在这些孩子之间施加Z缓冲。 - Default value:
- 空值
-
getEffect
public final Effect getEffect()
获取属性效果的值。- Property description:
-
指定应用于此
Node
的效果。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.EFFECT
。混合效果与3D变换有一个已知的限制。 效果本质上是2D图像操作。 在具有3D变换的孩子的
Group
节点上设置的效果的结果将导致其孩子被顺序渲染,而不会在这些孩子之间施加Z缓冲。 - Default value:
- 空值
-
effectProperty
public final ObjectProperty<Effect> effectProperty()
指定应用于此Node
的效果。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.EFFECT
。混合效果与3D变换有一个已知的限制。 效果本质上是2D图像操作。 效果设置在具有3D变换的孩子的
Group
节点上的结果将导致其孩子被顺序呈现,而不在这些孩子之间施加Z缓冲。- Default value:
- 空值
- 另请参见:
-
getEffect()
,setEffect(Effect)
-
setDepthTest
public final void setDepthTest(DepthTest value)
设置属性depthTest的值。- Property description:
-
指示在渲染此节点时是否使用深度测试。
如果depthTest标志为
DepthTest.DISABLE
,则该节点的深度测试被禁用。 如果depthTest标志为DepthTest.ENABLE
,则对该节点启用深度测试。 如果depthTest标志为DepthTest.INHERIT
,则如果为父节点启用了深度测试,则该节点将启用深度测试,或者父节点为空。所述depthTest标志仅用于当深度缓存中标志为
Scene
为真(意味着Scene
具有相关联的深度缓冲器)深度测试比较仅在启用了depthTest的节点之间进行。 禁用depthTest的节点不读取,测试或写入深度缓冲区,也就是说,其Z值不会被考虑用于与其他节点的深度测试。
请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。使用depthBuffer查看Scene中的构造函数作为其输入参数之一。
- Default value:
- 继承
-
getDepthTest
public final DepthTest getDepthTest()
获取属性depthTest的值。- Property description:
-
指示在渲染此节点时是否使用深度测试。
如果depthTest标志是
DepthTest.DISABLE
,则该节点的深度测试被禁用。 如果depthTest标志为DepthTest.ENABLE
,则对该节点启用深度测试。 如果depthTest标志为DepthTest.INHERIT
,则如果为父节点启用了深度测试,则父节点为空。所述depthTest标志仅用于当深度缓存中标志为
Scene
为真(意味着Scene
具有相关联的深度缓冲器)深度测试比较仅在启用了depthTest的节点之间进行。 禁用depthTest的节点不读取,测试或写入深度缓冲区,也就是说,其Z值不会被考虑用于与其他节点的深度测试。
请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。使用depthBuffer查看Scene中的构造函数作为其输入参数之一。
- Default value:
- 继承
-
depthTestProperty
public final ObjectProperty<DepthTest> depthTestProperty()
指示在渲染此节点时是否使用深度测试。 如果depthTest标志为DepthTest.DISABLE
,则该节点的深度测试被禁用。 如果depthTest标志为DepthTest.ENABLE
,则对该节点启用深度测试。 如果depthTest标志为DepthTest.INHERIT
,则如果为父节点启用了深度测试,则该节点启用了深度测试,或者父节点为空。所述depthTest标志仅用于当深度缓存中标志为
Scene
为真(意味着Scene
具有相关联的深度缓冲器)深度测试比较仅在启用了depthTest的节点之间进行。 禁用depthTest的节点不读取,测试或写入深度缓冲区,也就是说,其Z值不会被考虑用于与其他节点的深度测试。
请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。使用depthBuffer查看Scene中的构造函数作为其输入参数之一。
- Default value:
- 继承
- 另请参见:
-
getDepthTest()
,setDepthTest(DepthTest)
-
setDisable
public final void setDisable(boolean value)
设置属性的值禁用。- Property description:
-
定义此
Node
的个人禁用状态。 将disable
设置为true将导致此Node
和任何子节点被禁用。 该属性应仅用于设置禁用状态为Node
。 为了查询Node
的禁用状态,应该使用disabled
属性,因为即使disable
状态在Node
上的disable
状态为false
,由于可能禁用了Node
,因为祖先被禁用。 - Default value:
- 假
-
isDisable
public final boolean isDisable()
获取属性禁用的值。- Property description:
-
定义此
Node
的个人禁用状态。 将disable
设置为true将导致此Node
和任何子节点被禁用。 该属性应仅用于设置禁用状态为Node
。 对于查询的禁用状态Node
,该disabled
财产应改为使用,因为它可能是一个Node
作为祖先的结果被禁用即使个别被禁用disable
在这种状态下Node
为false
。 - Default value:
- 假
-
disableProperty
public final BooleanProperty disableProperty()
定义此Node
的个人禁用状态。 将disable
设置为true将导致此Node
和任何子节点被禁用。 该属性应仅用于设置禁用状态为Node
。 对于查询的禁用状态Node
,该disabled
财产应改为使用,因为它可能是一个Node
作为祖先的结果被禁用即使个别被禁用disable
在这种状态下Node
为false
。- Default value:
- 假
- 另请参见:
-
isDisable()
,setDisable(boolean)
-
setPickOnBounds
public final void setPickOnBounds(boolean value)
设置属性pickOnBounds的值。- Property description:
-
定义当由
MouseEvent
或contains
函数调用触发时,如何为此节点完成拣选计算。 如果pickOnBounds
为真,则通过与该节点的边界相交来计算拾取,否则通过与该节点的几何形状相交来计算拾取。 - Default value:
- 假
-
isPickOnBounds
public final boolean isPickOnBounds()
获取属性pickOnBounds的值。- Property description:
-
定义当由
MouseEvent
或contains
函数调用触发时,如何为此节点完成拣选计算。 如果pickOnBounds
为真,则通过与该节点的边界相交来计算拾取,否则通过与该节点的几何形状相交来计算拾取。 - Default value:
- 假
-
pickOnBoundsProperty
public final BooleanProperty pickOnBoundsProperty()
定义当由MouseEvent
或contains
函数调用触发时,如何为此节点完成拣选计算。 如果pickOnBounds
为真,则通过与该节点的边界相交来计算拾取,否则通过与该节点的几何形状相交来计算拾取。- Default value:
- 假
- 另请参见:
-
isPickOnBounds()
,setPickOnBounds(boolean)
-
setDisabled
protected final void setDisabled(boolean value)
设置禁用属性的值。- Property description:
-
表示是否禁用此
Node
。 如果27071567748263在本身或场景图中的一个祖先设置为true
,则Node
将被禁用。禁用的
Node
应该呈现不同的方式,以指示其对用户的禁用状态。 这种禁用渲染取决于Node
的实现。javafx.scene.shape
包含的形状类默认情况下不实现此类渲染,因此使用形状处理输入的应用程序必须实现适当的禁用渲染本身。 然而,javafx.scene.control
定义的用户界面控件将实现禁用敏感的渲染。禁用的
Node
不接收鼠标或键事件。 - Default value:
- 假
-
isDisabled
public final boolean isDisabled()
获取禁用的属性的值。- Property description:
-
指示此
Node
是否被禁用。 如果disable
本身或场景图中的一个祖先设置为true
,则Node
将被禁用。禁用的
Node
应该以不同的方式呈现,以指示其对用户的禁用状态。 这种禁用渲染取决于Node
的实现。javafx.scene.shape
包含的形状类默认情况下不实现此类渲染,因此使用形状处理输入的应用程序必须实现适当的禁用渲染本身。 然而,javafx.scene.control
定义的用户界面控件将实现禁用敏感的渲染。禁用的
Node
不接收鼠标或键事件。 - Default value:
- 假
-
disabledProperty
public final ReadOnlyBooleanProperty disabledProperty()
表示是否禁用Node
。 如果27071567777119在场景图中本身或其祖先之一上设置为true
,则Node
将被禁用。禁用的
Node
应该呈现不同的方式,以指示其对用户的禁用状态。 这种禁用渲染取决于Node
的实现。javafx.scene.shape
包含的形状类默认情况下不实现此类渲染,因此使用形状处理输入的应用程序必须实现适当的禁用渲染本身。 然而,javafx.scene.control
定义的用户界面控件将实现禁用敏感的渲染。禁用的
Node
不会接收鼠标或键事件。- Default value:
- 假
- 另请参见:
-
isDisabled()
,setDisabled(boolean)
-
lookup
public Node lookup(String selector)
根据给定的CSS选择器,找到这个Node
或第一个子节点。 如果此节点为Parent
,则该函数将遍历到分支中,直到找到匹配项。 如果多个子节点与指定的选择器匹配,则此函数返回其中的第一个。例如,如果节点的ID为“myId”,那么查找方法可以用于查找此节点,如下所示:
scene.lookup("#myId");
。- 参数
-
selector
- 要查找的节点的css选择器 - 结果
-
第一个节点,从这个
Node
开始,与CSSselector
匹配,如果没有找到,selector
null。
-
lookupAll
public Set<Node> lookupAll(String selector)
查找所有Node
s,包括这个和任何孩子,匹配给定的CSS选择器。 如果没有找到匹配项,则返回一个空的不可修改的集合。 该集合是明确无序的。- 参数
-
selector
- 要查找的节点的css选择器 - 结果
-
所有节点,从包括这个
Node
,它与CSSselector
匹配。 返回的集合始终是无序的,不可修改的,永远不会为空。
-
toBack
public void toBack()
将这个Node
移动到它的兄弟节点的z顺序。 这是通过将此Node
移动到其父级的content
ObservableList中的第一个位置来实现的。 如果该Node
不是Node
则此功能无效。
-
toFront
public void toFront()
按照z顺序将此Node
移动到其兄弟节点的前端。 这是通过将此Node
移动到其父代的content
ObservableList中的最后一个位置来实现的。 如果此Node
不是组的一部分,则此功能无效。
-
snapshot
public WritableImage snapshot(SnapshotParameters params, WritableImage image)
获取该节点的快照,并在渲染图像准备就绪时返回。 在渲染之前,将对节点及其任何子节点进行CSS和布局处理。 整个目标图像被清除为由SnapshotParameters指定的填充Paint
。 然后将该节点呈现给图像。 如果由SnapshotParameters指定的视口为空,则在首次应用由SnapshotParameters指定的变换后,该节点的boundsInParent
的左上角像素将映射到图像中的左上角像素(0,0)。 如果指定了非空视口,则视口的左上角像素将映射到图像中的左上角像素(0,0)。 在这两种情况下,图像的映射(0,0)都是用整数转换完成的。 在渲染图像之外的节点部分将被图像剪辑。当通过应用程序或隐式(如图表动画)明确地拍摄场景的快照时,将根据快照拍摄时的场景图形的状态渲染快照,并且不会反映任何随后的动画更改。
注意:为了使CSS和布局正常工作,节点必须是场景的一部分(场景可以附加到舞台,但不需要)。
- 参数
-
params
- 包含将控制渲染的属性的快照参数。 如果SnapshotParameters对象为空,则如果此节点是场景的一部分,则将使用场景的属性,如果此节点不是场景的一部分,则将使用默认属性。 -
image
- 将用于保存渲染节点的可写映像。 它可能为null,在这种情况下,将构建一个新的WritableImage。 新图像使用从该节点的已变换边界或从SnapShotParameters中指定的视口大小导出的整数宽度和高度值构造。 选择这些整数值使得图像将完全包含此节点或指定视口的边界。 如果图像不为空,则节点将被渲染为现有图像。 在这种情况下,图像的宽度和高度决定了渲染的区域,而不是边界或视口的宽度和高度。 - 结果
- 渲染图像
- 异常
-
IllegalStateException
- 如果在除JavaFX应用程序线程之外的线程上调用此方法。 - 从以下版本开始:
- JavaFX 2.2
-
snapshot
public void snapshot(Callback<SnapshotResult,Void> callback, SnapshotParameters params, WritableImage image)
在下一帧获取该节点的快照,并在映像准备就绪时调用指定的回调方法。 在渲染之前,将对节点及其任何子节点进行CSS和布局处理。 整个目标图像被清除为由SnapshotParameters指定的填充Paint
。 然后将该节点呈现给图像。 如果由SnapshotParameters指定的视口为空,则在首次应用由SnapshotParameters指定的变换后,该节点的boundsInParent
的左上角像素映射到图像中的左上角像素(0,0)。 如果指定了非空视口,则视口的左上角像素将映射到图像中的左上角像素(0,0)。 在这两种情况下,图像的映射(0,0)都是用整数转换完成的。 在渲染图像之外的节点部分将被图像剪辑。这是一个异步调用,这意味着在渲染节点之前可能会处理其他事件或动画。 如果任何这样的事件修改节点或其任何子节点,则修改将被反映在渲染图像中(就像它也将反映在渲染到舞台的帧中,如果该节点是实况场景图的一部分) 。
当通过应用程序或隐式(如图表动画)明确地获取动画节点的快照时,将根据拍摄快照时场景图的状态渲染快照,并且不会反映任何随后的动画更改。
注意:为了使CSS和布局正常工作,节点必须是场景的一部分(场景可以附加到舞台,但不需要)。
- 参数
-
callback
- 当图像准备好时调用方法的类。 传递到回调的调用方法的SnapshotResult将包含渲染的图像,渲染的源节点以及SnapshotParameters的副本。 回调参数不能为空。 -
params
- 包含将控制渲染的属性的快照参数。 如果SnapshotParameters对象为空,则如果此节点是场景的一部分,则将使用场景的属性,如果此节点不是场景的一部分,则将使用默认属性。 -
image
- 将用于保存渲染节点的可写映像。 它可能为null,在这种情况下,将构建一个新的WritableImage。 新图像使用从该节点的已变换边界或从SnapShotParameters中指定的视口大小导出的整数宽度和高度值构造。 选择这些整数值使得图像将完全包含此节点或指定视口的边界。 如果图像不为空,则节点将被渲染为现有图像。 在这种情况下,图像的宽度和高度决定了渲染的区域,而不是边界或视口的宽度和高度。 - 异常
-
IllegalStateException
- 如果在除JavaFX应用程序线程之外的线程上调用此方法。 -
NullPointerException
- 如果回调参数为空。 - 从以下版本开始:
- JavaFX 2.2
-
setOnDragEntered
public final void setOnDragEntered(EventHandler<? super DragEvent> value)
设置属性onDragEntered的值。- Property description:
-
定义当拖动手势进入
Node
时要调用的功能。
-
getOnDragEntered
public final EventHandler<? super DragEvent> getOnDragEntered()
获取属性onDragEntered的值。- Property description:
-
定义当拖动手势进入
Node
时要调用的功能。
-
onDragEnteredProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragEnteredProperty()
定义当拖动手势进入Node
时要调用的功能。
-
setOnDragExited
public final void setOnDragExited(EventHandler<? super DragEvent> value)
设置属性onDragExited的值。- Property description:
-
定义当拖动手势退出
Node
时要调用的函数。
-
getOnDragExited
public final EventHandler<? super DragEvent> getOnDragExited()
获取属性onDragExited的值。- Property description:
-
定义当拖动手势退出
Node
时要调用的函数。
-
onDragExitedProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragExitedProperty()
定义当拖动手势退出Node
时要调用的函数。
-
setOnDragOver
public final void setOnDragOver(EventHandler<? super DragEvent> value)
设置属性onDragOver的值。- Property description:
-
定义当这个
Node
拖动手势进度时要调用的函数。
-
getOnDragOver
public final EventHandler<? super DragEvent> getOnDragOver()
获取属性onDragOver的值。- Property description:
-
定义当这个
Node
拖动手势进度时要调用的函数。
-
onDragOverProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragOverProperty()
定义当这个Node
拖动手势进度时要调用的函数。
-
setOnDragDropped
public final void setOnDragDropped(EventHandler<? super DragEvent> value)
设置属性onDragDropped的值。- Property description:
-
定义在拖放手势时,在此
Node
上释放鼠标按钮时要调用的功能。 在DragEvent
的dragboard
中传输数据应发生在此功能中。
-
getOnDragDropped
public final EventHandler<? super DragEvent> getOnDragDropped()
获取属性onDragDropped的值。- Property description:
-
定义在拖放手势时,在此
Node
上释放鼠标按钮时要调用的功能。 在DragEvent
的dragboard
中的数据传输应该发生在此功能中。
-
onDragDroppedProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty()
定义当在拖放手势时释放鼠标按钮Node
时要调用的功能。 在DragEvent
的dragboard
中的数据传输应该发生在这个功能中。
-
setOnDragDone
public final void setOnDragDone(EventHandler<? super DragEvent> value)
设置属性onDragDone的值。- Property description:
-
当这个
Node
是一个拖放手势源,它的数据被放在放置目标上之后,定义要调用的函数。 该事件的transferMode
显示刚刚发生的下降目标。 如果transferMode
的值为MOVE
,则源可以清除其数据。 清除源的数据给用户通过拖放手势移动了数据的适当外观。 甲transferMode
具有值NONE
指示拖放手势期间没有数据被转移。
-
getOnDragDone
public final EventHandler<? super DragEvent> getOnDragDone()
获取属性onDragDone的值。- Property description:
-
定义当这个
Node
是数据放在放置目标上之后的拖放手势源时要调用的函数。 事件的transferMode
显示刚刚发生的下降目标。 如果transferMode
的值为MOVE
,则源可以清除其数据。 清除源的数据给用户通过拖放手势移动了数据的适当外观。 甲transferMode
具有值NONE
指示拖放手势期间没有数据被转移。
-
onDragDoneProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty()
当这个Node
是一个拖放手势源,它的数据被放在放置目标上之后,定义要调用的函数。 该事件的transferMode
显示刚刚发生的下降目标。 如果transferMode
的值为MOVE
,则源可以清除其数据。 清除源的数据给用户通过拖放手势移动了数据的适当外观。 甲transferMode
具有值NONE
指示拖放手势期间没有数据被转移。
-
startDragAndDrop
public Dragboard startDragAndDrop(TransferMode... transferModes)
确认一个潜在的拖放手势,在这Node
被认可。 只能从DRAG_DETECTED事件处理程序调用。 返回的Dragboard
用于在拖放手势期间传输数据。 将Node
的数据放在Dragboard
上也可以将此Node
标识为拖放手势的来源。 有关拖放手势的更多详细信息,请参见DragEvent
。- 参数
-
transferModes
- 支持的TransferMode
(Node
- 结果
-
A
Dragboard
将此Node
的数据放在上面 - 异常
-
IllegalStateException
- 如果此时无法启动拖放(在DRAG_DETECTED
事件处理之外调用或此节点不在场景中)。 - 另请参见:
-
DragEvent
-
startFullDrag
public void startFullDrag()
开始一个完整的按下 - 拖动释放手势与该节点作为手势源。 只能从一个DRAG_DETECTED
鼠标事件处理程序调用此方法。 有关拖动手势的更多详细信息,请参见MouseEvent
和MouseDragEvent
的概述。- 异常
-
IllegalStateException
- 如果此时无法启动完全按下 - 拖动释放手势(在DRAG_DETECTED
事件处理之外调用或此节点不在场景中)。 - 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
MouseEvent
,MouseDragEvent
-
setManaged
public final void setManaged(boolean value)
设置管理的属性的值。- Property description:
-
定义该节点的布局是否由父节点管理。
如果节点被管理,它的父节点将将节点的几何因子归因于其自己的首选大小和
layoutBounds
计算,并将在场景的布局过程中进行排列。 如果受管节点的layoutBounds更改,它将自动触发将场景图转发到最近的布局根(通常是场景的根节点)。如果节点不受管理,其父级将忽略两个首选大小的计算和布局中的子节点。 layoutBounds中的更改将不会在其上方触发中继。 如果非托管节点类型为
Parent
,则它将作为“布局根”,这意味着在其下方调用Parent.requestLayout()
将仅导致由节点生根的分支被中继,从而将布局更改隔离到该根和下面。 应用程序负责设置非托管节点的大小和位置。默认情况下所有节点都被管理。
-
isManaged
public final boolean isManaged()
获取管理的属性的值。- Property description:
-
定义该节点的布局是否由父节点管理。
如果节点被管理,那么父节点会将节点的几何因子归因于其自己的首选大小和
layoutBounds
计算,并将在场景布局通过期间进行排列。 如果受管节点的layoutBounds更改,它将自动触发将场景图转发到最近的布局根(通常是场景的根节点)。如果节点不受管理,其父级将忽略两个首选大小的计算和布局中的子节点。 layoutBounds中的更改将不会在其上方触发中继。 如果非托管节点的类型为
Parent
,则它将作为“布局根”,这意味着在其下方调用Parent.requestLayout()
将仅导致由节点生根的分支被中继,从而将布局更改隔离到该根和下面。 应用程序负责设置非托管节点的大小和位置。默认情况下所有节点都被管理。
-
managedProperty
public final BooleanProperty managedProperty()
定义该节点的布局是否由父节点管理。 如果节点被管理,那么它的父节点会将节点的几何因子归因于自己的首选大小和layoutBounds
计算,并在场景的布局过程中将其排除。 如果受管节点的layoutBounds更改,它将自动触发将场景图转发到最近的布局根(通常是场景的根节点)。如果节点不受管理,其父级将忽略两个首选大小的计算和布局中的子节点。 layoutBounds中的更改将不会在其上方触发中继。 如果非托管节点的类型为
Parent
,则它将作为“布局根”,这意味着对其下的Parent.requestLayout()
的调用将仅导致由节点生根的分支被中继,从而将布局更改隔离到该根和下面。 应用程序负责设置非托管节点的大小和位置。默认情况下所有节点都被管理。
- 另请参见:
-
isManaged()
,setManaged(boolean)
-
setLayoutX
public final void setLayoutX(double value)
设置属性layoutX的值。- Property description:
-
定义添加到此
Node
的转换中用于布局目的的转换的x坐标。 该值应该计算为将节点的位置从当前的layoutBounds minX
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
不能减去
layoutBounds minX
可能导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutX。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。如果节点被管理并且有一个
Region
作为其父节点,则布局区域将根据其自己的布局策略设置layoutX
。 如果节点由Group
进行非管理或父控 ,则应用程序可以直接设置layoutX
来定位它。
-
getLayoutX
public final double getLayoutX()
获取属性layoutX的值。- Property description:
-
定义添加到
Node
的转换中用于布局目的的转换的x坐标。 该值应该计算为将节点的位置从当前的layoutBounds minX
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
不能减去
layoutBounds minX
可能导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutX。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。如果节点被管理,并且有一个
Region
作为其父节点,则布局区域将根据其自己的布局策略设置layoutX
。 如果节点不是由Group
管理或父节点,那么应用程序可以直接设置layoutX
来定位它。
-
layoutXProperty
public final DoubleProperty layoutXProperty()
定义为了布局目的而添加到此Node
的转换中的转换的x坐标。 该值应计算为将节点的位置从当前的layoutBounds minX
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
不能减去
layoutBounds minX
可能会导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutX。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,并且translateX
可选地对该位置进行动态调整。如果节点被管理,并以其父节点为
Region
,则布局区域将根据自己的布局策略设置layoutX
。 如果节点由Group
进行非管理或父控 ,则应用程序可以直接设置layoutX
来定位它。- 另请参见:
-
getLayoutX()
,setLayoutX(double)
-
setLayoutY
public final void setLayoutY(double value)
设置属性layoutY的值。- Property description:
-
定义添加到此
Node
的转换中用于布局目的的转换的y坐标。 该值应该计算为将节点的位置从当前的layoutBounds minY
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
不能减去
layoutBounds minY
可能会导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutY。该节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,而translateY
可选地对该位置进行动态调整。如果节点被管理,并以其父级为
Region
,则该区域将根据其自己的布局策略设置layoutY
。 如果节点由Group
进行非管理或父控 ,则应用程序可以直接设置layoutY
来定位它。
-
getLayoutY
public final double getLayoutY()
获取属性layoutY的值。- Property description:
-
定义添加到此
Node
的转换中用于布局目的的转换的y坐标。 该值应该计算为将节点的位置从当前的layoutBounds minY
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
不能减去
layoutBounds minY
可能导致节点错位。relocate(x, y)
方法将自动进行正确的计算,通常直接用于设置layoutY。该节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,而translateY
可选地对该位置进行动态调整。如果节点被管理,并且有一个
Region
作为其父节点,则该区域将根据其自己的布局策略设置layoutY
。 如果节点不是由Group
管理或父节点,则应用程序可以直接设置layoutY
来定位它。
-
layoutYProperty
public final DoubleProperty layoutYProperty()
定义添加到此Node
的转换中用于布局目的的转换的y坐标。 该值应该计算为将节点的位置从当前的layoutBounds minY
位置(可能不为0)调整到所需位置所需的偏移量。例如,如果
textnode
应该位于finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
不能减去
layoutBounds minY
可能导致节点错位。relocate(x, y)
方法将自动进行正确的计算,一般应直接用于设置layoutY。节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,translateY
可选地对该位置进行动态调整。如果节点被管理并且以其父节点为
Region
,则该区域将根据其自己的布局策略设置layoutY
。 如果节点是非管理的或由Group
父节点,那么应用程序可以直接设置layoutY
来定位它。- 另请参见:
-
getLayoutY()
,setLayoutY(double)
-
relocate
public void relocate(double x, double y)
设置节点的layoutX和layoutY转换属性,以便将该节点重定位到父节点的x,y位置。该方法不会改变translateX或translateY,如果还设置了这个方法,它将被添加到layoutX和layoutY中,根据相应的数量调整最终位置。
- 参数
-
x
- 目标x坐标位置 -
y
- 目标y坐标位置
-
isResizable
public boolean isResizable()
指示该节点是否可以由父节点调整大小。 如果此方法返回true,那么在布局过程中,父节点将通过调用node.resize(width,height)来调整节点的大小(理想情况下在其大小范围内)。 所有区域,控件和WebView都是可调整大小的类,它们在应用所有尺寸和CSS样式信息后,依赖于他们的父母在布局期间调整大小。如果此方法返回false,那么在布局期间父()不能调整它大小(resize()是一个no-op),并且它应该返回其layoutBounds的最小,首选和最大大小。 组,文本和所有形状都不能调整大小,因此通过设置适当的属性(例如矩形的宽度/高度,文本上的文本等),依赖于应用程序来建立其大小。 在布局期间,仍然可以重新定位不可调整大小的节点。
- 结果
- 该布局期间该节点类型是否可以由其父节点调整大小
- 另请参见:
-
getContentBias()
,minWidth(double)
,minHeight(double)
,prefWidth(double)
,prefHeight(double)
,maxWidth(double)
,maxHeight(double)
,resize(double, double)
,getLayoutBounds()
-
getContentBias
public Orientation getContentBias()
返回节点调整大小偏置的方向以进行布局。 如果节点类型没有偏差,则返回null。 如果节点可调整大小,并且其高度取决于其宽度,则返回HORIZONTAL,否则如果其宽度取决于其高度,则返回VERTICAL。可调整大小的子类应该覆盖此方法以返回适当的值。
- 结果
- width / height依赖的方向,如果没有则为null
- 另请参见:
-
isResizable()
,minWidth(double)
,minHeight(double)
,prefWidth(double)
,prefHeight(double)
,maxWidth(double)
,maxHeight(double)
-
minWidth
public double minWidth(double height)
返回节点在布局计算中使用的最小宽度。 如果节点可调整大小,则其父值不应该调整其小于此值的宽度。 如果节点不可调整,则返回其layoutBounds宽度。调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有垂直的内容偏置,则呼叫者应该传入最小宽度应该基于的高度值。 如果节点具有水平或空的内容偏置,则调用者应该传入-1。
具有垂直内容偏置的节点子类应该尊重height参数,不管是-1还是正值。 所有其他子类可以忽略height参数(这可能是-1)。
如果节点的
maxWidth(double)
低于此数字,则优先级为minWidth
。 这意味着Node不应该调整大小以下minWidth
。- 参数
-
height
- 如果最小宽度取决于应该使用的高度 - 结果
- 布局期间节点应该调整大小的最小宽度。 结果永远不会是NaN,也不会是负面的。
- 另请参见:
-
isResizable()
,getContentBias()
-
minHeight
public double minHeight(double width)
返回节点在布局计算中使用的最小高度。 如果节点可调整大小,则父节点不应该将其高度调整为小于该值的大小。 如果节点不可调整大小,返回其layoutBounds高度。调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有水平的内容偏置,则呼叫者应该传递最小高度应该基于的宽度值。 如果节点具有垂直或空的内容偏置,则调用者应该传入-1。
具有水平内容偏置的节点子类应该符合宽度参数,不管是-1还是正值。 所有其他子类可以忽略width参数(这可能是-1)。
如果节点的
maxHeight(double)
低于此数字,则优先级为minHeight
。 这意味着节点不应该被调整至低于minHeight
。- 参数
-
width
- 如果最小高度取决于应该使用的宽度 - 结果
- 在布局期间节点应该调整大小的最小高度结果将不会是NaN,也不会是负数。
- 另请参见:
-
isResizable()
,getContentBias()
-
prefWidth
public double prefWidth(double height)
返回节点在布局计算中使用的首选宽度。 如果节点可调整大小,其父级应将该值视为节点在其范围内的理想宽度。 如果节点不可调整,只需返回其layoutBounds宽度,该宽度应该被视为节点的刚性宽度。调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有垂直的内容偏置,则呼叫者应该传入首选宽度应该基于的高度值。 如果节点具有水平或空的内容偏置,则调用者应该传入-1。
具有垂直内容偏置的节点子类应该尊重height参数,不管是-1还是正值。 所有其他子类可以忽略height参数(这可能是-1)。
- 参数
-
height
- 如果首选宽度取决于应该使用的高度 - 结果
- 节点在布局期间应该调整大小的首选宽度结果将不会是NaN,也不会是负数。
- 另请参见:
-
isResizable()
,getContentBias()
,autosize()
-
prefHeight
public double prefHeight(double width)
返回节点的首选高度,用于布局计算。 如果节点可调整大小,其父级应该将该值视为节点在其范围内的理想高度。 如果节点不可调整大小,则只返回其layoutBounds高度,该高度应该被视为节点的刚性高度。调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有水平的内容偏置,则呼叫者应该传入首选高度应该基于的宽度值。 如果节点具有垂直或空的内容偏置,则调用者应该传入-1。
具有水平内容偏倚的节点子类应该符合高度参数,不管是-1还是正值。 所有其他子类可以忽略height参数(这可能是-1)。
- 参数
-
width
- 如果偏好的高度取决于应该使用的宽度 - 结果
- 节点在布局期间应该调整大小的首选高度结果将不会是NaN,也不会是负数。
- 另请参见:
-
getContentBias()
,autosize()
-
maxWidth
public double maxWidth(double height)
返回节点在布局计算中使用的最大宽度。 如果节点可调整大小,其父级不应该调整其大于此值的宽度。 Double.MAX_VALUE的值表示父节点可以将节点的宽度扩展到超出其优先级而不受限制。如果节点不可调整,则返回其layoutBounds宽度。
调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有垂直的内容偏置,则呼叫者应该传入最大宽度应该基于的高度值。 如果节点具有水平或空的内容偏置,则调用者应该传入-1。
具有垂直内容偏置的节点子类应该尊重height参数,不管是-1还是正值。 所有其他子类可以忽略height参数(这可能是-1)。
如果节点的
minWidth(double)
较大,则应优先于maxWidth
。 这意味着节点不应该被调整至低于minWidth
。- 参数
-
height
- 如果最大宽度取决于它应该使用的高度 - 结果
- 节点在布局期间应该调整大小的最大宽度结果将不会是NaN,也不会是负数。
- 另请参见:
-
isResizable()
,getContentBias()
-
maxHeight
public double maxHeight(double width)
返回节点在布局计算中使用的最大高度。 如果节点可调整大小,其父级不应该调整其大于此值的任何大小。 Double.MAX_VALUE的值表示父节点可能将节点的高度超出其首选而不受限制。如果节点不可调整大小,返回其layoutBounds高度。
调用此方法的布局代码应首先检查节点的内容偏差。 如果节点具有水平的内容偏置,则呼叫者应该传入最大高度应该基于的宽度值。 如果节点具有垂直或空的内容偏置,则调用者应该传入-1。
具有水平内容偏置的节点子类应该符合宽度参数,不管是-1还是正值。 所有其他子类可以忽略width参数(这可能是-1)。
如果节点的
minHeight(double)
较大,则应优先于maxHeight
。 这意味着Node不应该调整大小在minHeight
以下。- 参数
-
width
- 如果最大高度取决于应该使用的宽度 - 结果
- 节点在布局期间应该调整大小的最大高度结果将不会是NaN,也不会是负数。
- 另请参见:
-
isResizable()
,getContentBias()
-
resize
public void resize(double width, double height)
如果节点可调整大小,将其布局边界设置为指定的宽度和高度。 如果节点不能调整大小,这个方法是无效的。这个方法通常只能通过parentChildren()方法由父节点调用。 所有Parent类将自动调整大小可调整大小的子项,因此应用程序直接进行的调整大小将被节点的父级覆盖,除非子级不受管理。
父母负责确保宽度和高度值落在可调整大小的节点的首选范围内。 如果父级只需要将节点的大小调整为其首选大小,则可以使用autosize()方法。
- 参数
-
width
- 目标布局的边界宽度 -
height
- 目标布局界定高度 - 另请参见:
-
isResizable()
,getContentBias()
,autosize()
,minWidth(double)
,minHeight(double)
,prefWidth(double)
,prefHeight(double)
,maxWidth(double)
,maxHeight(double)
,getLayoutBounds()
-
autosize
public final void autosize()
如果节点可调整大小,则将其布局边界设置为当前优选的宽度和高度。 如果节点不能调整大小,这个方法是无效的。该方法自动查询节点的内容偏倚,如果是水平方向,则会传递节点的首选宽度以获得首选高度; 如果是垂直的,将会通过节点的首选高度来获取宽度,如果为空则将独立计算首选的宽度/高度。
- 另请参见:
-
isResizable()
,getContentBias()
-
resizeRelocate
public void resizeRelocate(double x, double y, double width, double height)
如果节点可调整大小,将其布局边界设置为指定的宽度和高度。 如果节点不可调整大小,则跳过调整大小步骤。一旦节点被调整大小(如果可调整大小),则设置节点的layoutX和layoutY转换属性,以便将其重定位到父坐标空间中的x,y。
这个方法通常只能通过parentChildren()方法由父节点调用。 所有Parent类将自动调整大小可调整大小的子项,因此应用程序直接进行的调整大小将被节点的父级覆盖,除非子级不受管理。
父母负责确保宽度和高度值落在可调整大小的节点的首选范围内。 如果父节点只需要将节点的大小调整为其首选大小并重新定位,则可以使用autosize()和relocate()方法。
- 参数
-
x
- 目标x坐标位置 -
y
- 目标y坐标位置 -
width
- 目标布局的边界宽度 -
height
- 目标布局界限高度 - 另请参见:
-
isResizable()
,getContentBias()
,autosize()
,minWidth(double)
,minHeight(double)
,prefWidth(double)
,prefHeight(double)
,maxWidth(double)
,maxHeight(double)
-
getBaselineOffset
public double getBaselineOffset()
当基于与其他节点垂直对齐的节点的layoutBounds.minY位置时,“字母”(或“罗马”)基线偏移。 默认情况下,这可以返回BASELINE_OFFSET_SAME_AS_HEIGHT
用于可调整大小的节点和layoutBounds高度,不可调整大小。 包含文本的子类应该覆盖此方法以返回其实际文本基线偏移量。- 结果
-
对于不可调整大小的节点,
textBounds.minY的文本基线偏移量为
BASELINE_OFFSET_SAME_AS_HEIGHT
-
computeAreaInScreen
public double computeAreaInScreen()
返回以像素为单位投影到物理屏幕上的Node
区域。- 结果
-
这个
Node
的区域投影到物理屏幕上 - 从以下版本开始:
- JavaFX 8.0
-
getBoundsInParent
public final Bounds getBoundsInParent()
获取属性boundsInParent的值。- Property description:
-
这个
Node
的矩形边界包括它的变换。boundsInParent
是通过采取局部边界(由boundsInLocal
定义)并应用通过设置以下附加变量创建的变换来计算的-
transforms
ObservableList -
scaleX
,scaleY
-
rotate
-
layoutX
,layoutY
-
translateX
,translateY
结果范围将在概念上在
Node
的父节点的坐标空间中,但是节点不需要有父代来计算这些边界。请注意,此方法不考虑节点的可见性; 计算仅基于这个
Node
的几何。此属性将始终具有非空值。
请注意,只要节点的几何结构发生更改,或者当以下任何一项更改时,boundsInParent将自动重新计算:转换ObservableList,translateX,translateY,layoutX,layoutY,scaleX,scaleY或rotate变量。 因此,将节点中的任何值绑定到依赖于此变量的表达式是一个错误。 例如,为了定位节点,形状的x或y变量或translateX,translateY不应该被绑定到boundsInParent。
-
-
boundsInParentProperty
public final ReadOnlyObjectProperty<Bounds> boundsInParentProperty()
这个Node
的矩形边界包括它的变换。boundsInParent
是通过采取局部边界(由boundsInLocal
定义)并应用通过设置以下附加变量创建的变换来计算的-
transforms
ObservableList -
scaleX
,scaleY
-
rotate
-
layoutX
,layoutY
-
translateX
,translateY
结果范围将在概念上在
Node
的父级的坐标空间中,但是该节点不需要有父代来计算这些边界。请注意,此方法不考虑节点的可见性; 该计算仅基于该
Node
的几何形状。此属性将始终具有非空值。
请注意,只要节点的几何结构发生更改,或者当以下任何一项更改时,boundsInParent将自动重新计算:转换ObservableList,translateX,translateY,layoutX,layoutY,scaleX,scaleY或rotate变量。 因此,将节点中的任何值绑定到依赖于此变量的表达式是一个错误。 例如,为了定位节点,形状的x或y变量或translateX,translateY不应该被绑定到boundsInParent。
- 另请参见:
-
getBoundsInParent()
-
-
getBoundsInLocal
public final Bounds getBoundsInLocal()
获取属性boundsInLocal的值。
-
boundsInLocalProperty
public final ReadOnlyObjectProperty<Bounds> boundsInLocalProperty()
该节点未转换的局部坐标空间中的Node
的矩形边界。 对于扩展Shape
的节点,局部边界还将包括可能落在由位置和大小属性定义的形状几何体之外的非零行程所需的空间。 本地范围还将包括任何剪辑集clip
以及设置为effect
的效果。请注意,此方法不考虑节点的可见性; 该计算仅基于这个
Node
的几何。此属性将始终具有非空值。
请注意,只要节点的几何结构发生更改,boundsInLocal就会自动重新计算。 因此,将节点中的任何值绑定到依赖于此变量的表达式是一个错误。 例如,为了定位节点,形状的x或y变量不应该被绑定到boundsInLocal。
- 另请参见:
-
getBoundsInLocal()
-
getLayoutBounds
public final Bounds getLayoutBounds()
获取属性layoutBounds的值。- Property description:
-
应该用于此节点的布局计算的矩形边界。
layoutBounds
可能与节点的可视边界不同,并且根据节点类型不同地计算。如果该节点类型是可调整大小(
Region
,Control
,或WebView
),则layoutBounds中永远是0,0 width x height
。 如果该节点类型是不可调整大小(Shape
,Text
,或Group
),则layoutBounds中计算基于所述节点的几何性质,并且不包括该节点的剪辑,效果或变换。 有关详细信息,请参阅各类课程文档需要注意的是
layoutX
,layoutY
,translateX
,并translateY
变量没有在layoutBounds。 这很重要,因为布局代码必须首先确定节点的当前大小和位置(使用layoutBounds),然后设置layoutX
和layoutY
以调整节点的翻译,以使其具有所需的布局位置。由于layoutBounds的计算通常与节点的几何变量相关联,因此将任何此类变量绑定到依赖于
layoutBounds
的表达式是一个错误。 例如,为了定位节点,不应将形状的x或y变量绑定到layoutBounds。layoutBounds永远不会为空。
-
layoutBoundsProperty
public final ReadOnlyObjectProperty<Bounds> layoutBoundsProperty()
应该用于此节点的布局计算的矩形边界。layoutBounds
可能与节点的可视边界不同,并且根据节点类型而不同地计算。如果该节点类型是可调整大小(
Region
,Control
,或WebView
),则layoutBounds中永远是0,0 width x height
。 如果该节点类型是不可调整大小(Shape
,Text
,或Group
),则layoutBounds中计算基于所述节点的几何性质,并且不包括该节点的剪辑,效果或变换。 有关详细信息,请参阅各类课程文档需要注意的是
layoutX
,layoutY
,translateX
,并translateY
变量没有在layoutBounds。 这很重要,因为布局代码必须首先确定节点的当前大小和位置(使用layoutBounds),然后设置layoutX
和layoutY
以调整节点的翻译,以使其具有所需的布局位置。因为layoutBounds的计算通常与节点的几何变量相关联,所以将任何这样的变量绑定到依赖于
layoutBounds
的表达式是一个错误。 例如,为了定位节点,不应将形状的x或y变量绑定到layoutBounds。layoutBounds永远不会为空。
- 另请参见:
-
getLayoutBounds()
-
contains
public boolean contains(double localX, double localY)
返回true
如果给定的点(指定在局部坐标的此空间Node
)包含在此的形状内Node
。 请注意,这种方法不能看清; 测试是基于这个Node
的几何。- 参数
-
localX
- 节点空间中点的x坐标 -
localY
- 节点空间中点的y坐标 - 结果
-
包含的结果为这个
Node
-
contains
public boolean contains(Point2D localPoint)
返回true
如果给定的点(指定在局部坐标的此空间Node
)包含在此的形状内Node
。 请注意,这种方法不能看清; 该测试仅基于该Node
的几何形状。- 参数
-
localPoint
- 节点空间中的2D点 - 结果
-
包含的结果为这个
Node
-
intersects
public boolean intersects(double localX, double localY, double localWidth, double localHeight)
返回true
如果给定的矩形(在指定在局部坐标的此空间Node
)相交此的形状Node
。 请注意,这种方法不能看清; 该测试仅基于该Node
的几何形状。 此函数的默认行为只是检查给定坐标是否与局部边界相交。- 参数
-
localX
- 节点空间中矩形的x坐标 -
localY
- 节点空间中矩形的y坐标 -
localWidth
- 节点空间中矩形的宽度 -
localHeight
- 节点空间中矩形的高度 - 结果
-
这个相交结果为
Node
-
intersects
public boolean intersects(Bounds localBounds)
返回true
如果给定的范围(在当地指定的坐标这个空间Node
)相交这个形状Node
。 请注意,这种方法不能看清; 测试是基于这个Node
的几何形状。 此函数的默认行为只是检查给定坐标是否与局部边界相交。- 参数
-
localBounds
- 界限 - 结果
-
这个相交结果为
Node
-
screenToLocal
public Point2D screenToLocal(double screenX, double screenY)
将来自该坐标空间中的点Screen
这个局部坐标空间Node
。- 参数
-
screenX
- 屏幕上某个点的x坐标 -
screenY
- 屏幕上某个点的y坐标 - 结果
-
本节点的坐标坐标为null,如果节点不在一个
Window
。 如果从本地到场景的转换是不可逆的,则返回空值。 - 从以下版本开始:
- JavaFX 8.0
-
screenToLocal
public Point2D screenToLocal(Point2D screenPoint)
将一个点从Screen
的坐标空间转换为此Node
的本地坐标空间。- 参数
-
screenPoint
- 屏幕上的一个点 - 结果
-
本节点的坐标坐标为null,如果节点不在一个
Window
。 如果从本地到场景的转换是不可逆的,则返回空值。 - 从以下版本开始:
- JavaFX 8.0
-
screenToLocal
public Bounds screenToLocal(Bounds screenBounds)
将矩形从Screen
的坐标空间转换为此Node
的本地坐标空间。 仅在2D空间中返回合理的结果。
-
sceneToLocal
public Point2D sceneToLocal(double x, double y, boolean rootScene)
将一个点从场景的坐标空间转换为Node
的局部坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,则参数为Scene
,节点返回的坐标为getScene()
。 Othwerwise,使用子序列坐标,这相当于调用sceneToLocal(double, double)
- 参数
-
x
- x坐标 -
y
- y坐标 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 点的本地坐标
- 从以下版本开始:
- JavaFX 8u40
-
sceneToLocal
public Point2D sceneToLocal(Point2D point, boolean rootScene)
将一个点从场景的坐标空间转换为该Node
的局部坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,那么参数是由getScene()
返回的节点的Scene
坐标。 Othwerwise,使用子序列坐标,这相当于调用sceneToLocal(javafx.geometry.Point2D)
- 参数
-
point
- 关键 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 点的本地坐标
- 从以下版本开始:
- JavaFX 8u40
-
sceneToLocal
public Bounds sceneToLocal(Bounds bounds, boolean rootScene)
将场景的坐标空间的边界转换为此Node
的局部坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,则参数在270715818635351的270715818685351坐标中返回getScene()
。 Othwerwise,使用子序列坐标,这相当于调用sceneToLocal(javafx.geometry.Bounds)
。由于3D界限无法转换为
rootScene
设置为true
,尝试转换3D界限将产生null
。- 参数
-
bounds
- 界限 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 边界的局部坐标
- 从以下版本开始:
- JavaFX 8u40
-
sceneToLocal
public Point2D sceneToLocal(double sceneX, double sceneY)
- 参数
-
sceneX
- 场景上点的x坐标 -
sceneY
- 场景上点的y坐标 - 结果
-
本节点的坐标坐标为null,如果节点不在一个
Window
中 。 如果从本地到场景的转换是不可逆的,则返回空值。
-
sceneToLocal
public Point2D sceneToLocal(Point2D scenePoint)
- 参数
-
scenePoint
- 场景上的一个点 - 结果
-
本地节点的坐标坐标,如果节点不在一个
Window
,则为null 。 如果从本地到场景的转换是不可逆的,则返回空值。
-
sceneToLocal
public Point3D sceneToLocal(Point3D scenePoint)
- 参数
-
scenePoint
- 场景上的一个点 - 结果
-
本节点的坐标坐标为null,如果节点不在一个
Window
中 。 如果从本地到场景的转换是不可逆的,则返回空值。 - 从以下版本开始:
- JavaFX 8.0
-
sceneToLocal
public Point3D sceneToLocal(double sceneX, double sceneY, double sceneZ)
- 参数
-
sceneX
- 场景上点的x坐标 -
sceneY
- 场景上点的y坐标 -
sceneZ
- 场景上某个点的z坐标 - 结果
-
本节点的坐标坐标为null,如果节点不在一个
Window
中 。 如果从本地到场景的转换是不可逆的,则返回空值。 - 从以下版本开始:
- JavaFX 8.0
-
localToScreen
public Point2D localToScreen(double localX, double localY)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。- 参数
-
localX
- 节点空间中点的x坐标 -
localY
- 节点空间中点的y坐标 - 结果
-
如果节点不在一个
Window
,则该点的屏幕坐标为null或null - 从以下版本开始:
- JavaFX 8.0
-
localToScreen
public Point2D localToScreen(Point2D localPoint)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。- 参数
-
localPoint
- 节点空间中的一个点 - 结果
-
如果节点不在
Window
中 ,则该点的屏幕坐标为null或null - 从以下版本开始:
- JavaFX 8.0
-
localToScreen
public Point2D localToScreen(double localX, double localY, double localZ)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。- 参数
-
localX
- 节点空间中点的x坐标 -
localY
- 节点空间中点的y坐标 -
localZ
- 节点空间中点的z坐标 - 结果
-
如果节点不在一个
Window
中 ,则该点的屏幕坐标为null或null - 从以下版本开始:
- JavaFX 8.0
-
localToScreen
public Point2D localToScreen(Point3D localPoint)
将一个点从该Node
的局部坐标空间转换为其Screen
的坐标空间。- 参数
-
localPoint
- 节点空间中的一个点 - 结果
-
如果节点不在
Window
中 ,则该点的屏幕坐标为null或null - 从以下版本开始:
- JavaFX 8.0
-
localToScreen
public Bounds localToScreen(Bounds localBounds)
将此Node
的局部坐标空间的Node
转换为其Screen
的坐标空间。- 参数
-
localBounds
- 节点空间中的边界 - 结果
-
如果节点不在一个
Window
中 ,屏幕坐标中的边界为null或null - 从以下版本开始:
- JavaFX 8.0
-
localToScene
public Point2D localToScene(double localX, double localY)
- 参数
-
localX
- 节点空间中点的x坐标 -
localY
- 节点空间中点的y坐标 - 结果
-
点的场景坐标,如果节点不在
Window
,则为null
-
localToScene
public Point2D localToScene(Point2D localPoint)
- 参数
-
localPoint
- 节点空间中的一个点 - 结果
-
点的场景坐标,如果节点不在
Window
,则为null
-
localToScene
public Point3D localToScene(Point3D localPoint)
- 参数
-
localPoint
- 节点空间中的3D点 - 结果
- 在场景空间中变换的3D点
- 从以下版本开始:
- JavaFX 8.0
- 另请参见:
-
localToScene(javafx.geometry.Point3D, boolean)
-
localToScene
public Point3D localToScene(double x, double y, double z)
- 参数
-
x
- 节点空间中点的x坐标 -
y
- 节点空间中点的y坐标 -
z
- 节点空间中点的z坐标 - 结果
- 在场景空间中变换的3D点
- 从以下版本开始:
- JavaFX 8.0
- 另请参见:
-
localToScene(double, double, double, boolean)
-
localToScene
public Point3D localToScene(Point3D localPoint, boolean rootScene)
将一个点从该Node
的本地坐标空间转换为其场景的坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,则结果点为Scene
,节点返回的坐标为getScene()
。 Othwerwise,使用子序列坐标,这相当于调用localToScene(javafx.geometry.Point3D)
- 参数
-
localPoint
- 局部坐标点 -
rootScene
- 即使节点在rootScene
,是否应使用场景坐标 - 结果
- 转换点
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
localToScene(javafx.geometry.Point3D)
-
localToScene
public Point3D localToScene(double x, double y, double z, boolean rootScene)
将这个点从这个Node
的局部坐标空间Node
到其场景的坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,则结果点为Scene
节点返回的坐标为getScene()
。 Othwerwise,使用子序列坐标,这相当于调用localToScene(double, double, double)
- 参数
-
x
- 局部坐标点的x坐标 -
y
- 本地坐标点的y坐标 -
z
- 局部坐标点的z坐标 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 转换点
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
localToScene(double, double, double)
-
localToScene
public Point2D localToScene(Point2D localPoint, boolean rootScene)
将一个点从该Node
的局部坐标空间转换为其场景的坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,结果点在Scene
的节点返回的坐标为getScene()
。 Othwerwise,使用子序列坐标,这相当于调用localToScene(javafx.geometry.Point2D)
- 参数
-
localPoint
- 局部坐标点 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 转换点
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
localToScene(javafx.geometry.Point2D)
-
localToScene
public Point2D localToScene(double x, double y, boolean rootScene)
将一个点从这个Node
的局部坐标空间Node
到其场景的坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,则结果点为Scene
节点返回的坐标为getScene()
。 Othwerwise,使用子序列坐标,这相当于调用localToScene(double, double)
- 参数
-
x
- 局部坐标点的x坐标 -
y
- 本地坐标点的y坐标 -
rootScene
- 即使节点在rootScene
,是否应使用场景坐标 - 结果
- 转换点
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
localToScene(double, double)
-
localToScene
public Bounds localToScene(Bounds localBounds, boolean rootScene)
将这个Node
的局部坐标空间的Node
转换为其场景的坐标空间。 如果节点没有任何SubScene
或rootScene
设置为true,结果边界将在Scene
的Scene
坐标中返回getScene()
。 Othwerwise,使用子序列坐标,这相当于调用localToScene(javafx.geometry.Bounds)
- 参数
-
localBounds
- 局部坐标的边界 -
rootScene
- 即使节点位于子rootScene
,是否应使用场景坐标 - 结果
- 转化界限
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
localToScene(javafx.geometry.Bounds)
-
localToScene
public Bounds localToScene(Bounds localBounds)
- 参数
-
localBounds
- 在节点的空间中的边界 - 结果
-
场景中的边界坐标,如果节点不在
Window
,则为null - 另请参见:
-
localToScene(javafx.geometry.Bounds, boolean)
-
parentToLocal
public Point2D parentToLocal(double parentX, double parentY)
将一个点从母体的坐标空间转换为此Node
的局部坐标空间。- 参数
-
parentX
- 父级空间中的x坐标 -
parentY
- 父级空间中的y坐标 - 结果
- 节点空间中的变换后的2D点
-
parentToLocal
public Point2D parentToLocal(Point2D parentPoint)
将一个点从母体的坐标空间转换为该Node
的局部坐标空间。- 参数
-
parentPoint
- 父级空间中的2D点 - 结果
- 节点空间中的变换后的2D点
-
parentToLocal
public Point3D parentToLocal(Point3D parentPoint)
将一个点从母体的坐标空间转换为该Node
的局部坐标空间。- 参数
-
parentPoint
将3D点放在父的空格中 - 结果
- 在Node的空间中变换的3D点
- 从以下版本开始:
- JavaFX 8.0
-
parentToLocal
public Point3D parentToLocal(double parentX, double parentY, double parentZ)
将一个点从父母的坐标空间转换为这个Node
的局部坐标空间。- 参数
-
parentX
- 父级空间中的x坐标 -
parentY
- 父空间中的y坐标 -
parentZ
- 父级空间中的z坐标 - 结果
- 在Node的空间中变换的3D点
- 从以下版本开始:
- JavaFX 8.0
-
parentToLocal
public Bounds parentToLocal(Bounds parentBounds)
将矩形从母体的坐标空间转换为此Node
的局部坐标空间。- 参数
-
parentBounds
- 父母空间中的界限 - 结果
- 节点空间中的变换界限
-
localToParent
public Point2D localToParent(double localX, double localY)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。- 参数
-
localX
- 节点空间中点的x坐标 -
localY
- 节点空间中点的y坐标 - 结果
- 父母空间中转换的2D点
-
localToParent
public Point2D localToParent(Point2D localPoint)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。- 参数
-
localPoint
- 节点空间中的2D点 - 结果
- 父母空间中转换的2D点
-
localToParent
public Point3D localToParent(Point3D localPoint)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。- 参数
-
localPoint
- 节点空间中的3D点 - 结果
- 在父母的空间中转换的3D点
- 从以下版本开始:
- JavaFX 8.0
-
localToParent
public Point3D localToParent(double x, double y, double z)
将一个点从该Node
的局部坐标空间转换为其父节点的坐标空间。- 参数
-
x
- 节点空间中点的x坐标 -
y
- 节点空间中点的y坐标 -
z
- 节点空间中点的z坐标 - 结果
- 在父母的空间中转换的3D点
- 从以下版本开始:
- JavaFX 8.0
-
localToParent
public Bounds localToParent(Bounds localBounds)
将此Node
的局部坐标空间的Node
转换为其父项的坐标空间。- 参数
-
localBounds
- 节点空间中的边界 - 结果
- 父母空间中的变化界限
-
viewOrderProperty
public final DoubleProperty viewOrderProperty()
定义其父母中的Node
的呈现和拣选顺序。此属性用于更改其父级中节点的呈现和拣选顺序,而无需重新排序父级的
children
列表。 例如,这可以用作实现透明度排序的更有效的方法。 为此,应用程序可以将每个节点的viewOrder值分配给该节点和查看器之间的计算距离。父母将通过其
children
减少viewOrder
订单。 这意味着一个viewOrder
较低的viewOrder
将在一个较高的viewOrder
的孩子viewOrder
。 如果两个孩子有相同的viewOrder
,父母将按照父母children
列表中显示的顺序遍历它们。但是,
viewOrder
不会更改此节点在其父级中的布局和聚焦遍历顺序。 当进行布局或聚焦遍历时,父对象总是按顺序遍历其children
列表。- Default value:
- 0.0
- 从以下版本开始:
- 9
- 另请参见:
-
getViewOrder()
,setViewOrder(double)
-
setViewOrder
public final void setViewOrder(double value)
设置属性viewOrder的值。- Property description:
-
定义其父母中的
Node
的呈现和拣选顺序。此属性用于更改其父级中节点的呈现和拣配顺序,而无需重新排序父级的
children
列表。 例如,这可以用作实现透明度排序的更有效的方法。 为此,应用程序可以将每个节点的viewOrder值分配给该节点和查看器之间的计算距离。父母将通过其
children
减少viewOrder
订单。 这意味着一个viewOrder
较低的viewOrder
将在一个viewOrder
较高的孩子viewOrder
。 如果两个孩子有相同的viewOrder
,父母将按照他们在父母的children
列表中显示的顺序遍历它们。但是,
viewOrder
不会在此父节点中更改此节点的布局和聚焦遍历顺序。 当进行布局或聚焦遍历时,父对象总是按顺序遍历其children
列表。 - Default value:
- 0.0
- 从以下版本开始:
- 9
-
getViewOrder
public final double getViewOrder()
获取属性viewOrder的值。- Property description:
-
定义其父母中的
Node
的呈现和拣配顺序。此属性用于更改其父级中节点的呈现和拣配顺序,而无需重新排序父级的
children
列表。 例如,这可以用作实现透明度排序的更有效的方法。 为此,应用程序可以将每个节点的viewOrder值分配给该节点和查看器之间的计算距离。父母将通过其
children
减少viewOrder
订单。 这意味着一个较小的viewOrder
的孩子将在一个较高的viewOrder
的孩子viewOrder
。 如果两个孩子有相同的viewOrder
,父母将按照父母children
列表中显示的顺序遍历它们。但是,
viewOrder
不会在此父节点中更改此节点的布局和重点遍历顺序。 当进行布局或聚焦遍历时,父代总是按顺序遍历其children
列表。 - Default value:
- 0.0
- 从以下版本开始:
- 9
-
getTransforms
public final ObservableList<Transform> getTransforms()
定义的ObservableListTransform
个对象被应用到这个Node
。 变换的这个ObservableList施加之前translateX
,translateY
,scaleX
,和scaleY
,rotate
个变换。- Default value:
- 空
- 结果
-
这个转换为这个
Node
-
setTranslateX
public final void setTranslateX(double value)
设置属性translateX的值。- Property description:
-
定义添加到此
Node
的转换中的转换的x坐标。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。该变量可用于改变节点的位置而不会干扰其
layoutBounds
,这使得它有助于动画化节点的位置。 - Default value:
- 0
-
getTranslateX
public final double getTranslateX()
获取属性translateX的值。- Property description:
-
定义添加到此
Node
的转换中的转换的x坐标。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,并且translateX
可选地对该位置进行动态调整。该变量可用于改变节点的位置,而不会影响其节点的位置
layoutBounds
。 - Default value:
- 0
-
translateXProperty
public final DoubleProperty translateXProperty()
定义添加到此Node
变换的转换的x坐标。节点的最终翻译将计算为
layoutX
+translateX
,其中layoutX
建立节点的稳定位置,translateX
可选地对该位置进行动态调整。该变量可用于改变节点的位置,而不会影响其
layoutBounds
,这使得它有助于动画化节点的位置。- Default value:
- 0
- 另请参见:
-
getTranslateX()
,setTranslateX(double)
-
setTranslateY
public final void setTranslateY(double value)
设置属性translateY的值。- Property description:
-
定义添加到此
Node
的转换中的转换的y坐标。节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,translateY
可选地对该位置进行动态调整。该变量可用于改变节点的位置,而不会干扰其
layoutBounds
,这使得它有助于动画化节点的位置。 - Default value:
- 0
-
getTranslateY
public final double getTranslateY()
获取属性translateY的值。- Property description:
-
定义添加到此
Node
的转换中的转换的y坐标。节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,translateY
可选地对该位置进行动态调整。此变量可用于更改节点的位置,而不会影响其节点的位置
layoutBounds
。 - Default value:
- 0
-
translateYProperty
public final DoubleProperty translateYProperty()
定义添加到此Node
的转换中的转换的y坐标。该节点的最终翻译将计算为
layoutY
+translateY
,其中layoutY
建立节点的稳定位置,而translateY
可选地对该位置进行动态调整。该变量可用于改变节点的位置,而不会影响其节点的位置
layoutBounds
。- Default value:
- 0
- 另请参见:
-
getTranslateY()
,setTranslateY(double)
-
setTranslateZ
public final void setTranslateZ(double value)
设置属性translateZ的值。- Property description:
-
定义添加到该
Node
的变换坐标中的平移的Z坐标。 该值将被添加到由transforms
ObservableList和layoutZ
定义的任何翻译。该变量可用于改变节点的位置,而不会影响其布局边界,这使得它有助于动画化节点的位置。
请注意,这是一个条件功能。 详见
ConditionalFeature.SCENE3D
。 - Default value:
- 0
-
getTranslateZ
public final double getTranslateZ()
获取属性translateZ的值。- Property description:
-
定义添加到此
Node
的变换坐标中的平移的Z坐标。 该值将被添加到由transforms
ObservableList和layoutZ
定义的任何翻译。该变量可用于改变节点的位置,而不会影响其布局边界,这使得它有助于动画化节点的位置。
请注意,这是一个条件功能。 详情请见
ConditionalFeature.SCENE3D
。 - Default value:
- 0
-
translateZProperty
public final DoubleProperty translateZProperty()
定义添加到此Node
的变换坐标中的平移的Z坐标。 该值将被添加到由transforms
ObservableList和layoutZ
定义的任何翻译。该变量可用于改变节点的位置,而不会影响其布局边界,这使得它有助于动画化节点的位置。
请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。- Default value:
- 0
- 另请参见:
-
getTranslateZ()
,setTranslateZ(double)
-
setScaleX
public final void setScaleX(double value)
设置属性scaleX的值。- Property description:
-
定义坐标按照该
Node
沿着X轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得在考虑所有效果和转换后,整个节点的缩放是理想的。发生规模的枢轴点是未转化的
layoutBounds
的中心。 - Default value:
- 1.0
-
getScaleX
public final double getScaleX()
获取属性scaleX的值。- Property description:
-
定义坐标按照该
Node
的X轴对象对象的中心进行比例的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,该比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在考虑了所有效果和转换后,可以缩放整个节点。发生刻度的枢轴点是未转化的
layoutBounds
的中心。 - Default value:
- 1.0
-
scaleXProperty
public final DoubleProperty scaleXProperty()
定义坐标按照该Node
的X轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和转换后,整个节点的缩放是理想的。发生刻度的枢轴点是未转化的
layoutBounds
的中心。- Default value:
- 1.0
- 另请参见:
-
getScaleX()
,setScaleX(double)
-
setScaleY
public final void setScaleY(double value)
设置属性scaleY的值。- Property description:
-
定义坐标按照该
Node
的Y轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在考虑了所有效果和转换后,缩放整个节点。发生刻度的枢轴点是未转化的
layoutBounds
的中心。 - Default value:
- 1.0
-
getScaleY
public final double getScaleY()
获取属性scaleY的值。- Property description:
-
定义坐标按照该
Node
的Y轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此缩放因子不包括在
layoutBounds
中 ,这使得在考虑所有效果和转换后,整个节点的缩放是理想的。发生规模的枢轴点是未转化的
layoutBounds
的中心。 - Default value:
- 1.0
-
scaleYProperty
public final DoubleProperty scaleYProperty()
定义坐标按照该Node
的Y轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,该比例因子不包括在
layoutBounds
中 ,这使得它在所有效果和转换都被考虑之后非常适合缩放整个节点。尺度发生的枢轴点是未转化的
layoutBounds
的中心。- Default value:
- 1.0
- 另请参见:
-
getScaleY()
,setScaleY(double)
-
setScaleZ
public final void setScaleZ(double value)
设置属性scaleZ的值。- Property description:
-
定义坐标按照该
Node
的Z轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,该比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在考虑了所有效果和转换后,可以缩放整个节点。发生刻度的枢轴点是通过采用
boundsInLocal
形成的矩形边界的中心,并应用transforms
ObservableList中的所有变换。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。 - Default value:
- 1.0
-
getScaleZ
public final double getScaleZ()
获取属性scaleZ的值。- Property description:
-
定义坐标按照该
Node
的Z轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和转换后,对整个节点进行缩放是非常理想的。尺度发生的枢轴点是通过采用
boundsInLocal
形成的矩形边界的中心,并应用transforms
ObservableList中的所有变换。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。 - Default value:
- 1.0
-
scaleZProperty
public final DoubleProperty scaleZProperty()
定义坐标按照该Node
的Z轴的对象中心进行缩放的因子。 这用于手动或使用动画来拉伸或动画节点。默认情况下,此比例因子不包括在
layoutBounds
中 ,这使得它在理想的情况下,在考虑了所有效果和转换后,对整个节点进行缩放。发生刻度的枢轴点是通过采用
boundsInLocal
形成的矩形边界的中心,并在transforms
ObservableList中应用所有变换。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。- Default value:
- 1.0
- 另请参见:
-
getScaleZ()
,setScaleZ(double)
-
setRotate
public final void setRotate(double value)
设置属性rotate的值。- Property description:
-
定义关于
Node
中心的旋转角度,以度为单位。 这是用来旋转Node
。默认情况下,这个旋转因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和变换之后,它是理想的旋转整个节点。旋转发生的枢轴点是未转换的
layoutBounds
的中心。请注意,由于枢轴点计算为此
Node
的布局边界的中心,对布局边界的任何更改将导致枢轴点更改,这可能会移动对象。 对于叶节点,几何的任何更改将导致布局边界更改。 对于组节点,对其任何子项的任何更改(包括对子组的几何,剪辑,效果,位置,方向或比例的更改)都将导致组的布局界限发生更改。 如果不需要枢纽点的这种移动,应用程序应改为使用节点的transforms
ObservableList,并添加一个具有用户可指定的枢轴点的Rotate
变换。 - Default value:
- 0.0
-
getRotate
public final double getRotate()
获取属性旋转的值。- Property description:
-
定义关于
Node
中心的旋转角度,以度为单位。 这是用来旋转Node
。默认情况下,这个旋转因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和转换后,整个节点的旋转是理想的。旋转发生的枢轴点是未转化的
layoutBounds
的中心。请注意,由于枢轴点计算为此
Node
的布局边界的中心,对布局边界的任何更改将导致枢轴点更改,这可以移动对象。 对于叶节点,几何的任何更改将导致布局边界更改。 对于组节点,对其任何子项的任何更改(包括对子组的几何,剪辑,效果,位置,方向或比例的更改)都将导致组的布局界限发生更改。 如果不需要枢轴点的这种移动,应用程序应改为使用节点的transforms
ObservableList,并添加一个Rotate
变换,它具有用户指定的枢轴点。 - Default value:
- 0.0
-
rotateProperty
public final DoubleProperty rotateProperty()
定义关于Node
中心的旋转角度,以度为单位。 这是用来旋转Node
。默认情况下,这个旋转因子不包括在
layoutBounds
中 ,这使得在考虑了所有效果和转换之后,它是理想的旋转整个节点。旋转发生的枢轴点是未转化的
layoutBounds
的中心。请注意,由于枢轴点计算为此
Node
的布局边界的中心,对布局边界的任何更改将导致枢轴点更改,这可能会移动对象。 对于叶节点,几何的任何更改将导致布局边界更改。 对于组节点,对其任何子项的任何更改(包括对子组的几何,剪辑,效果,位置,方向或比例的更改)都将导致组的布局界限发生更改。 如果不需要枢纽点的这种移动,应用程序应该使用节点的transforms
ObservableList,并添加一个具有用户可指定的枢轴点的Rotate
变换。- Default value:
- 0.0
- 另请参见:
-
getRotate()
,setRotate(double)
-
setRotationAxis
public final void setRotationAxis(Point3D value)
设置属性rotateAxis的值。- Property description:
-
定义
Node
的旋转轴。请注意,这是一个条件功能。 详见
ConditionalFeature.SCENE3D
。 - Default value:
- Rotate.Z_AXIS
-
getRotationAxis
public final Point3D getRotationAxis()
获取属性rotateAxis的值。- Property description:
-
定义
Node
的旋转轴。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。 - Default value:
- Rotate.Z_AXIS
-
rotationAxisProperty
public final ObjectProperty<Point3D> rotationAxisProperty()
定义Node
的旋转轴。请注意,这是一个条件功能。 有关详细信息,请参阅
ConditionalFeature.SCENE3D
。- Default value:
- Rotate.Z_AXIS
- 另请参见:
-
getRotationAxis()
,setRotationAxis(Point3D)
-
localToParentTransformProperty
public final ReadOnlyObjectProperty<Transform> localToParentTransformProperty()
保存计算的本地到父变换的仿射变换。 这是这个节点中所有变换的并置,包括所有的方便变换。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getLocalToParentTransform()
-
getLocalToParentTransform
public final Transform getLocalToParentTransform()
获取属性localToParentTransform的值。- Property description:
- 保存计算的本地到父变换的仿射变换。 这是这个节点中所有变换的并置,包括所有的方便变换。
- 从以下版本开始:
- JavaFX 2.2
-
localToSceneTransformProperty
public final ReadOnlyObjectProperty<Transform> localToSceneTransformProperty()
拥有计算的局部到场景变换的仿射变换。 这是这个节点的父节点和这个节点中的所有变换的并置,包括到根节点的所有方便变换。 如果此节点在SubScene
中 ,则此属性表示转换为subscene,而不是根场景。请注意,当您注册侦听器或绑定到此属性时,它需要监听所有父进程对根节点的无效。 这意味着在许多节点上注册此属性的侦听器可能会对其父母中的转换更改的性能产生负面影响。
- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getLocalToSceneTransform()
-
getLocalToSceneTransform
public final Transform getLocalToSceneTransform()
获取属性localToSceneTransform的值。- Property description:
-
拥有计算的局部到场景变换的仿射变换。
这是这个节点的父节点和这个节点中的所有变换的并置,包括到根节点的所有方便变换。
如果此节点位于
SubScene
中 ,则此属性表示转换为次要素,而不是根场景。请注意,当您注册侦听器或绑定到此属性时,它需要监听所有父进程对根节点的无效。 这意味着在许多节点上注册此属性的侦听器可能会对其父母中的转换更改的性能产生负面影响。
- 从以下版本开始:
- JavaFX 2.2
-
setNodeOrientation
public final void setNodeOrientation(NodeOrientation orientation)
设置属性nodeOrientation的值。- Property description:
- *组件方向属性* *
-
getNodeOrientation
public final NodeOrientation getNodeOrientation()
获取属性nodeOrientation的值。- Property description:
- *组件方向属性* *
-
nodeOrientationProperty
public final ObjectProperty<NodeOrientation> nodeOrientationProperty()
属性保存NodeOrientation。节点方向描述节点内视觉数据的流动。 在英语世界中,视觉数据通常从左到右流动。 在阿拉伯语或希伯来语世界,视觉数据从右到左流动。 这与两个世界的文本阅读顺序一致。 默认值是从左到右。
- 结果
- NodeOrientation
- 从以下版本开始:
- JavaFX 8.0
-
getEffectiveNodeOrientation
public final NodeOrientation getEffectiveNodeOrientation()
获取属性effectiveNodeOrientation的值。- Property description:
- 节点的有效方向解决节点方向的继承,从左到右或从右到左返回。
- 从以下版本开始:
- JavaFX 8.0
-
effectiveNodeOrientationProperty
public final ReadOnlyObjectProperty<NodeOrientation> effectiveNodeOrientationProperty()
节点的有效方向解决节点方向的继承,从左到右或从右到左返回。- 从以下版本开始:
- JavaFX 8.0
- 另请参见:
-
getEffectiveNodeOrientation()
-
usesMirroring
public boolean usesMirroring()
确定当节点方向是从右到左时是否应该镜像节点。当一个节点被镜像时,原点会自动移动到右上角,导致节点布局孩子,并使用镜像转换从右到左绘制。 一些节点可能希望从右到左绘制,而不使用转换。 这些节点将会回复
false
并且不使用自动转换实现从右到左的方向。- 结果
-
如果这个
Node
应该镜像,Node
true - 从以下版本开始:
- JavaFX 8.0
-
setMouseTransparent
public final void setMouseTransparent(boolean value)
设置属性mouseTransparent的值。- Property description:
-
如果是
true
,这个节点(和它的所有子节点)对于鼠标事件是完全透明的。 当选择鼠标事件的目标时,mouseTransparent
设置为true
节点及其子树将不被考虑。
-
isMouseTransparent
public final boolean isMouseTransparent()
获取属性mouseTransparent的值。- Property description:
-
如果是
true
,这个节点(连同所有的子节点)对于鼠标事件是完全透明的。 当选择鼠标事件的目标时,mouseTransparent
设置为true
节点及其子树将不被考虑。
-
mouseTransparentProperty
public final BooleanProperty mouseTransparentProperty()
如果是true
,这个节点(和它的所有子节点)对于鼠标事件是完全透明的。 当选择鼠标事件的目标时,mouseTransparent
设置为true
节点及其子树将不被考虑。
-
setHover
protected final void setHover(boolean value)
设置属性悬停的值。- Property description:
-
这个
Node
是否被徘徊。 通常这是由于鼠标在节点上,尽管这可能是由于笔悬停在图形输入板或其他形式的输入上。请注意,当前实现的悬停依赖于鼠标进入和退出事件来确定此节点是否处于悬停状态; 这意味着目前仅在具有鼠标的系统上支持此功能。 未来的实现可以提供支持悬停的替代方式。
- Default value:
- 假
-
isHover
public final boolean isHover()
获取属性悬停的值。- Property description:
-
这
Node
是否正在徘徊。 通常这是由于鼠标在节点上,尽管这可能是由于笔悬停在图形输入板或其他形式的输入上。请注意,当前实现的悬停依赖于鼠标进入和退出事件来确定此节点是否处于悬停状态; 这意味着目前仅在具有鼠标的系统上支持此功能。 未来的实现可以提供支持悬停的替代方式。
- Default value:
- 假
-
hoverProperty
public final ReadOnlyBooleanProperty hoverProperty()
这个Node
是否被徘徊。 通常这是由于鼠标在节点上,尽管这可能是由于笔悬停在图形输入板或其他形式的输入上。请注意,当前实现的悬停依赖于鼠标进入和退出事件来确定此节点是否处于悬停状态; 这意味着目前仅在具有鼠标的系统上支持此功能。 未来的实现可以提供支持悬停的替代方式。
- Default value:
- 假
- 另请参见:
-
isHover()
,setHover(boolean)
-
setPressed
protected final void setPressed(boolean value)
设置按下的属性的值。- Property description:
-
是否按下
Node
。 通常,当主鼠标按钮处于关闭状态时,这是正确的,尽管子类可以定义其他鼠标按钮状态或键状态,以使节点“按下”。 - Default value:
- 假
-
isPressed
public final boolean isPressed()
获取按下的属性的值。- Property description:
-
是否按下
Node
。 通常,当主鼠标按钮处于关闭状态时,这是正确的,尽管子类可以定义其他鼠标按钮状态或键状态,以使节点“按下”。 - Default value:
- 假
-
pressedProperty
public final ReadOnlyBooleanProperty pressedProperty()
是否按下Node
。 通常,当主鼠标按钮处于关闭状态时,这是正确的,尽管子类可以定义其他鼠标按钮状态或键状态,以使节点“按下”。- Default value:
- 假
- 另请参见:
-
isPressed()
,setPressed(boolean)
-
setOnContextMenuRequested
public final void setOnContextMenuRequested(EventHandler<? super ContextMenuEvent> value)
设置属性onContextMenuRequested的值。- Property description:
-
定义在
Node
上请求上下文菜单时要调用的函数。 - 从以下版本开始:
- JavaFX 2.1
-
getOnContextMenuRequested
public final EventHandler<? super ContextMenuEvent> getOnContextMenuRequested()
获取属性onContextMenuRequested的值。- Property description:
-
定义在
Node
上请求上下文菜单时要调用的函数。 - 从以下版本开始:
- JavaFX 2.1
-
onContextMenuRequestedProperty
public final ObjectProperty<EventHandler<? super ContextMenuEvent>> onContextMenuRequestedProperty()
定义在Node
上请求上下文菜单时要调用的函数。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnContextMenuRequested()
,setOnContextMenuRequested(EventHandler)
-
setOnMouseClicked
public final void setOnMouseClicked(EventHandler<? super MouseEvent> value)
设置属性onMouseClicked的值。- Property description:
-
定义在这个
Node
上点击(按下并释放)鼠标按钮时要调用的功能。
-
getOnMouseClicked
public final EventHandler<? super MouseEvent> getOnMouseClicked()
获取属性onMouseClicked的值。- Property description:
-
定义当在此
Node
上单击(按下并释放)鼠标按钮时调用的功能。
-
onMouseClickedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseClickedProperty()
定义当这个Node
点击(按下并释放)鼠标按钮时要调用的功能。
-
setOnMouseDragged
public final void setOnMouseDragged(EventHandler<? super MouseEvent> value)
设置属性onMouseDragged的值。- Property description:
-
定义当在此
Node
上按下鼠标按钮然后拖动时要调用的功能。
-
getOnMouseDragged
public final EventHandler<? super MouseEvent> getOnMouseDragged()
获取属性onMouseDragged的值。- Property description:
-
定义当在此
Node
上按下鼠标按钮然后拖动时要调用的功能。
-
onMouseDraggedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseDraggedProperty()
定义当在此Node
上按下鼠标按钮然后拖动时要调用的功能。
-
setOnMouseEntered
public final void setOnMouseEntered(EventHandler<? super MouseEvent> value)
设置属性onMouseEntered的值。- Property description:
-
定义当鼠标进入
Node
时要调用的功能。
-
getOnMouseEntered
public final EventHandler<? super MouseEvent> getOnMouseEntered()
获取属性onMouseEntered的值。- Property description:
-
定义当鼠标进入
Node
时要调用的功能。
-
onMouseEnteredProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseEnteredProperty()
定义当鼠标进入Node
时要调用的功能。
-
setOnMouseExited
public final void setOnMouseExited(EventHandler<? super MouseEvent> value)
设置属性onMouseExited的值。- Property description:
-
定义当鼠标退出
Node
时调用的函数。
-
getOnMouseExited
public final EventHandler<? super MouseEvent> getOnMouseExited()
获取属性onMouseExited的值。- Property description:
-
定义当鼠标退出
Node
时要调用的函数。
-
onMouseExitedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseExitedProperty()
定义当鼠标退出Node
时要调用的函数。
-
setOnMouseMoved
public final void setOnMouseMoved(EventHandler<? super MouseEvent> value)
设置属性onMouseMoved的值。- Property description:
-
定义当这个
Node
鼠标光标移动时调用的功能,但没有按钮被按下。
-
getOnMouseMoved
public final EventHandler<? super MouseEvent> getOnMouseMoved()
获取属性onMouseMoved的值。- Property description:
-
定义当这个
Node
内的鼠标光标移动时调用的功能,但没有按钮被按下。
-
onMouseMovedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseMovedProperty()
定义当这个Node
内的鼠标光标移动时调用的功能,但没有按钮被按下。
-
setOnMousePressed
public final void setOnMousePressed(EventHandler<? super MouseEvent> value)
设置属性onMousePressed的值。- Property description:
-
定义在
Node
上按下鼠标按钮时要调用的功能。
-
getOnMousePressed
public final EventHandler<? super MouseEvent> getOnMousePressed()
获取属性onMousePressed的值。- Property description:
-
定义当在此
Node
上按下鼠标按钮时要调用的功能。
-
onMousePressedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMousePressedProperty()
定义在Node
上按下鼠标按钮时要调用的功能。
-
setOnMouseReleased
public final void setOnMouseReleased(EventHandler<? super MouseEvent> value)
设置属性onMouseReleased的值。- Property description:
-
定义当这个
Node
释放鼠标按钮时要调用的函数。
-
getOnMouseReleased
public final EventHandler<? super MouseEvent> getOnMouseReleased()
获取属性onMouseReleased的值。- Property description:
-
定义当这个
Node
释放鼠标按钮时要调用的函数。
-
onMouseReleasedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseReleasedProperty()
定义当这个Node
释放鼠标按钮时要调用的功能。
-
setOnDragDetected
public final void setOnDragDetected(EventHandler<? super MouseEvent> value)
设置属性onDragDetected的值。- Property description:
- 定义检测到拖动手势时要调用的功能。 这是开始拖放操作的正确位置。
-
getOnDragDetected
public final EventHandler<? super MouseEvent> getOnDragDetected()
获取属性onDragDetected的值。- Property description:
- 定义检测到拖动手势时要调用的功能。 这是开始拖放操作的正确位置。
-
onDragDetectedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onDragDetectedProperty()
定义检测到拖动手势时要调用的功能。 这是开始拖放操作的正确位置。
-
setOnMouseDragOver
public final void setOnMouseDragOver(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragOver的值。- Property description:
-
定义当这个
Node
内完全按下Node
释放手势时,要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
getOnMouseDragOver
public final EventHandler<? super MouseDragEvent> getOnMouseDragOver()
获取属性onMouseDragOver的值。- Property description:
-
定义当这个
Node
内完全按下 - 拖动释放手势时,要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
onMouseDragOverProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragOverProperty()
定义当这个Node
内完全按下Node
释放手势时,要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragOver()
,setOnMouseDragOver(EventHandler)
-
setOnMouseDragReleased
public final void setOnMouseDragReleased(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragReleased的值。- Property description:
-
定义当完全按下 - 拖动释放手势结束(通过释放鼠标按钮)在该
Node
内时Node
。 - 从以下版本开始:
- JavaFX 2.1
-
getOnMouseDragReleased
public final EventHandler<? super MouseDragEvent> getOnMouseDragReleased()
获取属性onMouseDragReleased的值。- Property description:
-
定义当完全按下 - 拖动释放手势结束(通过释放鼠标按钮)在该
Node
内时Node
。 - 从以下版本开始:
- JavaFX 2.1
-
onMouseDragReleasedProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragReleasedProperty()
定义当完全按下 - 拖动释放手势结束(通过释放鼠标按钮)在Node
内时Node
。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragReleased()
,setOnMouseDragReleased(EventHandler)
-
setOnMouseDragEntered
public final void setOnMouseDragEntered(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragEntered的值。- Property description:
-
定义当全按压拖动手势进入
Node
时要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
getOnMouseDragEntered
public final EventHandler<? super MouseDragEvent> getOnMouseDragEntered()
获取属性onMouseDragEntered的值。- Property description:
-
定义当全按压拖动手势进入
Node
时要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
onMouseDragEnteredProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragEnteredProperty()
定义当全按压拖动手势进入这个Node
时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragEntered()
,setOnMouseDragEntered(EventHandler)
-
setOnMouseDragExited
public final void setOnMouseDragExited(EventHandler<? super MouseDragEvent> value)
设置属性onMouseDragExited的值。- Property description:
-
定义当完全按下 - 拖动释放手势离开这个
Node
时要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
getOnMouseDragExited
public final EventHandler<? super MouseDragEvent> getOnMouseDragExited()
获取属性onMouseDragExited的值。- Property description:
-
定义当完全按下 - 拖动释放手势离开这个
Node
时要调用的功能。 - 从以下版本开始:
- JavaFX 2.1
-
onMouseDragExitedProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragExitedProperty()
定义当完全按下 - 拖动释放手势离开这个Node
时要调用的功能。- 从以下版本开始:
- JavaFX 2.1
- 另请参见:
-
getOnMouseDragExited()
,setOnMouseDragExited(EventHandler)
-
setOnScrollStarted
public final void setOnScrollStarted(EventHandler<? super ScrollEvent> value)
设置属性onScrollStarted的值。- Property description:
- 定义检测到滚动手势时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
getOnScrollStarted
public final EventHandler<? super ScrollEvent> getOnScrollStarted()
获取属性onScrollStarted的值。- Property description:
- 定义检测到滚动手势时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
onScrollStartedProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollStartedProperty()
定义检测到滚动手势时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnScrollStarted()
,setOnScrollStarted(EventHandler)
-
setOnScroll
public final void setOnScroll(EventHandler<? super ScrollEvent> value)
设置属性onScroll的值。- Property description:
- 定义当用户执行滚动操作时要调用的函数。
-
getOnScroll
public final EventHandler<? super ScrollEvent> getOnScroll()
获取属性onScroll的值。- Property description:
- 定义当用户执行滚动操作时要调用的函数。
-
onScrollProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollProperty()
定义当用户执行滚动操作时要调用的函数。
-
setOnScrollFinished
public final void setOnScrollFinished(EventHandler<? super ScrollEvent> value)
设置属性onScrollFinished的值。- Property description:
- 定义当滚动手势结束时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
getOnScrollFinished
public final EventHandler<? super ScrollEvent> getOnScrollFinished()
获取属性onScrollFinished的值。- Property description:
- 定义当滚动手势结束时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
onScrollFinishedProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollFinishedProperty()
定义当滚动手势结束时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnScrollFinished()
,setOnScrollFinished(EventHandler)
-
setOnRotationStarted
public final void setOnRotationStarted(EventHandler<? super RotateEvent> value)
设置属性onRotationStarted的值。- Property description:
- 定义检测到旋转手势时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnRotationStarted
public final EventHandler<? super RotateEvent> getOnRotationStarted()
获取属性onRotationStarted的值。- Property description:
- 定义检测到旋转手势时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onRotationStartedProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationStartedProperty()
定义检测到旋转手势时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotationStarted()
,setOnRotationStarted(EventHandler)
-
setOnRotate
public final void setOnRotate(EventHandler<? super RotateEvent> value)
设置属性onRotate的值。- Property description:
- 定义当用户执行旋转操作时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
getOnRotate
public final EventHandler<? super RotateEvent> getOnRotate()
获取属性onRotate的值。- Property description:
- 定义当用户执行旋转操作时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
onRotateProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotateProperty()
定义当用户执行旋转操作时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotate()
,setOnRotate(EventHandler)
-
setOnRotationFinished
public final void setOnRotationFinished(EventHandler<? super RotateEvent> value)
设置属性onRotationFinished的值。- Property description:
- 定义旋转手势结束时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnRotationFinished
public final EventHandler<? super RotateEvent> getOnRotationFinished()
获取属性onRotationFinished的值。- Property description:
- 定义旋转手势结束时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onRotationFinishedProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationFinishedProperty()
定义旋转手势结束时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnRotationFinished()
,setOnRotationFinished(EventHandler)
-
setOnZoomStarted
public final void setOnZoomStarted(EventHandler<? super ZoomEvent> value)
设置属性onZoomStarted的值。- Property description:
- 定义检测到缩放手势时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnZoomStarted
public final EventHandler<? super ZoomEvent> getOnZoomStarted()
获取属性onZoomStarted的值。- Property description:
- 定义检测到缩放手势时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onZoomStartedProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomStartedProperty()
定义检测到缩放手势时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoomStarted()
,setOnZoomStarted(EventHandler)
-
setOnZoom
public final void setOnZoom(EventHandler<? super ZoomEvent> value)
设置Zoom上的属性值。- Property description:
- 定义当用户执行缩放操作时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
getOnZoom
public final EventHandler<? super ZoomEvent> getOnZoom()
获取属性onZoom的值。- Property description:
- 定义当用户执行缩放操作时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
onZoomProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomProperty()
定义当用户执行缩放操作时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoom()
,setOnZoom(EventHandler)
-
setOnZoomFinished
public final void setOnZoomFinished(EventHandler<? super ZoomEvent> value)
设置属性onZoomFinished的值。- Property description:
- 定义当缩放手势结束时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnZoomFinished
public final EventHandler<? super ZoomEvent> getOnZoomFinished()
获取属性onZoomFinished的值。- Property description:
- 定义当缩放手势结束时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onZoomFinishedProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomFinishedProperty()
定义当缩放手势结束时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnZoomFinished()
,setOnZoomFinished(EventHandler)
-
setOnSwipeUp
public final void setOnSwipeUp(EventHandler<? super SwipeEvent> value)
设置属性onSwipeUp的值。- Property description:
- 定义当在该节点上居中的向上滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnSwipeUp
public final EventHandler<? super SwipeEvent> getOnSwipeUp()
获取属性onSwipeUp的值。- Property description:
- 定义当在该节点上居中的向上滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onSwipeUpProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeUpProperty()
定义当在该节点上居中的向上滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeUp()
,setOnSwipeUp(EventHandler)
-
setOnSwipeDown
public final void setOnSwipeDown(EventHandler<? super SwipeEvent> value)
设置属性onSwipeDown的值。- Property description:
- 定义当在该节点上居中的向下滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnSwipeDown
public final EventHandler<? super SwipeEvent> getOnSwipeDown()
获取属性onSwipeDown的值。- Property description:
- 定义当在该节点上居中的向下滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onSwipeDownProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeDownProperty()
定义当在该节点上居中的向下滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeDown()
,setOnSwipeDown(EventHandler)
-
setOnSwipeLeft
public final void setOnSwipeLeft(EventHandler<? super SwipeEvent> value)
设置属性onSwipeLeft的值。- Property description:
- 定义当以该节点为中心的向左滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnSwipeLeft
public final EventHandler<? super SwipeEvent> getOnSwipeLeft()
获取属性onSwipeLeft的值。- Property description:
- 定义当以该节点为中心的向左滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onSwipeLeftProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeLeftProperty()
定义当以该节点为中心的向左滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeLeft()
,setOnSwipeLeft(EventHandler)
-
setOnSwipeRight
public final void setOnSwipeRight(EventHandler<? super SwipeEvent> value)
设置属性onSwipeRight的值。- Property description:
- 定义当以该节点为中心的向右滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnSwipeRight
public final EventHandler<? super SwipeEvent> getOnSwipeRight()
获取属性onSwipeRight的值。- Property description:
- 定义当以该节点为中心的向右滑动手势发生时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onSwipeRightProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeRightProperty()
定义当以该节点为中心的向右滑动手势发生时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnSwipeRight()
,setOnSwipeRight(EventHandler)
-
setOnTouchPressed
public final void setOnTouchPressed(EventHandler<? super TouchEvent> value)
设置属性onTouchPressed的值。- Property description:
- 定义当按下新的触摸点时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnTouchPressed
public final EventHandler<? super TouchEvent> getOnTouchPressed()
获取onTouchPressed属性的值。- Property description:
- 定义当按下新的触摸点时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onTouchPressedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchPressedProperty()
定义当按下新的触摸点时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchPressed()
,setOnTouchPressed(EventHandler)
-
setOnTouchMoved
public final void setOnTouchMoved(EventHandler<? super TouchEvent> value)
设置属性onTouchMoved的值。- Property description:
- 定义当触摸点移动时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
getOnTouchMoved
public final EventHandler<? super TouchEvent> getOnTouchMoved()
获取onTouchMoved属性的值。- Property description:
- 定义当触摸点移动时要调用的函数。
- 从以下版本开始:
- JavaFX 2.2
-
onTouchMovedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchMovedProperty()
定义当触摸点移动时要调用的函数。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchMoved()
,setOnTouchMoved(EventHandler)
-
setOnTouchReleased
public final void setOnTouchReleased(EventHandler<? super TouchEvent> value)
设置属性onTouchReleased的值。- Property description:
- 定义触发点释放时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnTouchReleased
public final EventHandler<? super TouchEvent> getOnTouchReleased()
获取onTouchReleased属性的值。- Property description:
- 定义触发点释放时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onTouchReleasedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchReleasedProperty()
定义触发点释放时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchReleased()
,setOnTouchReleased(EventHandler)
-
setOnTouchStationary
public final void setOnTouchStationary(EventHandler<? super TouchEvent> value)
设置属性onTouchStationary的值。- Property description:
- 定义当触摸点保持按下并静止时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
getOnTouchStationary
public final EventHandler<? super TouchEvent> getOnTouchStationary()
获取属性onTouchStationary的值。- Property description:
- 定义当触摸点保持按下并静止时要调用的功能。
- 从以下版本开始:
- JavaFX 2.2
-
onTouchStationaryProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchStationaryProperty()
定义当触摸点保持按下并静止时要调用的功能。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
-
getOnTouchStationary()
,setOnTouchStationary(EventHandler)
-
setOnKeyPressed
public final void setOnKeyPressed(EventHandler<? super KeyEvent> value)
设置属性onKeyPressed的值。- Property description:
-
定义当该
Node
或其子项Node
具有输入焦点并按下键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
getOnKeyPressed
public final EventHandler<? super KeyEvent> getOnKeyPressed()
获取属性onKeyPressed的值。- Property description:
-
定义当此
Node
或其子代Node
具有输入焦点并按下键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onKeyPressedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyPressedProperty()
定义当这个Node
或其子代Node
具有输入焦点并按下一个键时调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
setOnKeyReleased
public final void setOnKeyReleased(EventHandler<? super KeyEvent> value)
设置属性onKeyReleased的值。- Property description:
-
定义当这个
Node
或其子代Node
具有输入焦点并且键已被释放时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
getOnKeyReleased
public final EventHandler<? super KeyEvent> getOnKeyReleased()
获取属性onKeyReleased的值。- Property description:
-
定义当这个
Node
或其子代Node
具有输入焦点并且键已被释放时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onKeyReleasedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyReleasedProperty()
定义当这个Node
或其子代Node
具有输入焦点并且键已被释放时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
setOnKeyTyped
public final void setOnKeyTyped(EventHandler<? super KeyEvent> value)
设置属性onKeyTyped的值。- Property description:
-
定义当此
Node
或其子项Node
具有输入焦点并键入密钥时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
getOnKeyTyped
public final EventHandler<? super KeyEvent> getOnKeyTyped()
获取属性onKeyTyped的值。- Property description:
-
定义当这个
Node
或其子代Node
具有输入焦点并键入了一个键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
onKeyTypedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyTypedProperty()
定义当这个Node
或其子代Node
具有输入焦点并键入了一个键时要调用的函数。 该函数仅在事件在捕获或冒泡期间尚未消耗的情况下被调用。
-
setOnInputMethodTextChanged
public final void setOnInputMethodTextChanged(EventHandler<? super InputMethodEvent> value)
设置属性onInputMethodTextChanged的值。- Property description:
-
定义当
Node
具有输入焦点并且输入法文本已更改时要调用的函数。 如果此功能未在此Node
定义,则它会将输入法组合的结果字符串作为一系列onKeyTyped
函数调用接收。当
Node
丢失输入焦点时,JavaFX运行时自动提交现有的合成文本(如果有的话)。
-
getOnInputMethodTextChanged
public final EventHandler<? super InputMethodEvent> getOnInputMethodTextChanged()
获取onInputMethodTextChanged属性的值。- Property description:
-
定义当这个
Node
具有输入焦点并且输入法文本已更改时要调用的函数。 如果此功能未在此Node
定义,则会将该输入法组合的结果字符串作为一系列onKeyTyped
函数调用。当
Node
丢失输入焦点时,JavaFX运行时自动提交现有的合成文本(如果有的话)。
-
onInputMethodTextChangedProperty
public final ObjectProperty<EventHandler<? super InputMethodEvent>> onInputMethodTextChangedProperty()
定义当Node
具有输入焦点并且输入法文本已更改时要调用的函数。 如果此功能未在此Node
定义,那么它会将输入法组合的结果字符串作为一系列onKeyTyped
函数调用。当
Node
丢失输入焦点时,JavaFX运行时自动提交现有的合成文本(如果有的话)。
-
setInputMethodRequests
public final void setInputMethodRequests(InputMethodRequests value)
设置属性inputMethodRequests的值。- Property description:
- 属性保存InputMethodRequests。
-
getInputMethodRequests
public final InputMethodRequests getInputMethodRequests()
获取属性inputMethodRequests的值。- Property description:
- 属性保存InputMethodRequests。
-
inputMethodRequestsProperty
public final ObjectProperty<InputMethodRequests> inputMethodRequestsProperty()
属性保存InputMethodRequests。
-
setFocused
protected final void setFocused(boolean value)
设置集中的属性的值。- Property description:
-
指示此
Node
当前是否具有输入焦点。 要输入焦点,一个节点必须是Scene
的焦点所有者,并且场景必须在可见和活动的Stage
中。 详见requestFocus()
。 - Default value:
- 假
-
isFocused
public final boolean isFocused()
获取关注的属性的值。- Property description:
-
指示此
Node
当前是否具有输入焦点。 要具有输入焦点,节点必须是Scene
的焦点所有者,并且场景必须在可见和活动的Stage
中。 有关详细信息,请参阅requestFocus()
。 - Default value:
- 假
-
focusedProperty
public final ReadOnlyBooleanProperty focusedProperty()
- Default value:
- 假
- 另请参见:
-
isFocused()
,setFocused(boolean)
-
setFocusTraversable
public final void setFocusTraversable(boolean value)
设置focusTraversable属性的值。- Property description:
-
指定此
Node
是否应该是焦点遍历周期的一部分。 当此属性为true
可以将焦点移动到此Node
并使用常规聚焦遍历键从此Node
。 在桌面上,这样的键通常是TAB
用于向前移动焦点和SHIFT+TAB
用于向后移动焦点。 当创建Scene
,系统Node
焦点放在Node
其focusTraversable
变量为true,并且有资格接收焦点,除非通过调用requestFocus()
显式设置焦点。 - Default value:
- 假
-
isFocusTraversable
public final boolean isFocusTraversable()
获取属性focusTraversable的值。- Property description:
-
指定此
Node
应该是焦点遍历周期的一部分。 当这个属性是true
焦点可以移动到这个Node
和从这个Node
使用常规焦点遍历键。 桌面上这样的键通常是TAB
用于向前移动焦点和SHIFT+TAB
用于向后移动焦点。 当创建Scene
,系统Node
焦点放在Node
其focusTraversable
变量为真,并且有资格接收焦点,除非通过调用requestFocus()
显式设置了焦点。 - Default value:
- 假
-
focusTraversableProperty
public final BooleanProperty focusTraversableProperty()
指定此Node
是否应该是焦点遍历周期的一部分。 当这个属性是true
焦点可以移动到这个Node
和从这个Node
使用常规焦点遍历键。 在桌面上,这样的键通常为TAB
用于向前移动焦点和SHIFT+TAB
用于向后移动焦点。 当创建Scene
,系统Node
焦点放在Node
其focusTraversable
变量为true,并且有资格接收焦点,除非通过调用requestFocus()
显式设置了焦点。- Default value:
- 假
- 另请参见:
-
isFocusTraversable()
,setFocusTraversable(boolean)
-
requestFocus
public void requestFocus()
要求这个Node
得到输入焦点,而这个Node
的顶级祖先成为聚焦窗口。 要有资格获得焦点,节点必须是场景的一部分,它和它的所有祖先必须可见,并且不能被禁用。 如果此节点符合条件,则此功能将使其成为此Scene
的“焦点所有者”。 每个场景最多只有一个焦点所有者节点。 焦点所有者实际上不会具有输入焦点,但是,除非场景属于可见和活动的Stage
。
-
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)
设置要用于此事件类型的处理程序。 一次只能有一个这样的处理程序。 这个处理程序保证被称为最后一个,后处理程序使用addEventHandler(javafx.event.EventType, javafx.event.EventHandler)
添加。 这用于注册用户定义的onFoo事件处理程序。- 参数类型
-
T
- 处理程序的特定事件类 - 参数
-
eventType
- 与给定eventHandler关联的事件类型 -
eventHandler
- 注册的处理程序,或取消注册为null - 异常
-
NullPointerException
- 如果事件类型为空
-
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
为此节点构造事件调度链。 事件调度链包含从舞台到该节点的所有事件调度程序。- Specified by:
-
buildEventDispatchChain
在接口EventTarget
- 参数
-
tail
- 从...建立的初始链 - 结果
- 此节点的结果事件调度链
-
fireEvent
public final void fireEvent(Event event)
触发指定的事件。 默认情况下,事件将从阶段到该节点遍历层次结构。 遇到的任何事件过滤器将被通知并可以使用该事件。 如果不被过滤器使用,则会通知此节点上的事件处理程序。 如果这些也不消耗事件,事件将返回到到达该节点的相同路径。 遇到的所有事件处理程序都被调用,可以使用事件。必须在FX用户线程上调用此方法。
- 参数
-
event
- 事件发生
-
getTypeSelector
public String getTypeSelector()
- Specified by:
-
getTypeSelector
在接口Styleable
- 结果
-
getClass().getName()
没有包名 - 从以下版本开始:
- JavaFX 8.0
-
getStyleableParent
public Styleable getStyleableParent()
返回此Styleable的父项,如果没有父项则返回null。- Specified by:
-
getStyleableParent
在接口Styleable
- 结果
-
getParent()
- 从以下版本开始:
- JavaFX 8.0
-
getInitialFocusTraversable
protected Boolean getInitialFocusTraversable()
返回此节点的初始焦点遍历状态,供JavaFX CSS引擎正确设置其初始值。 在这种情况下,这个方法可以被子类覆盖,因为这个方法最初应该是true(因为这个方法的默认实现是返回false)。- 结果
-
这个
Node
的初始聚焦可移动状态。 - 从以下版本开始:
- 9
-
getInitialCursor
protected Cursor getInitialCursor()
返回此节点的初始游标状态,供JavaFX CSS引擎正确设置其初始值。 这个方法可以在游标应该最初不为空的情况下被子类覆盖(因为这个方法的默认实现是返回null)。- 结果
-
这个
Node
的初始游标状态。 - 从以下版本开始:
- 9
-
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
- 结果
- 与此类相关联的CssMetaData可能包括其类的CssMetaData。
- 从以下版本开始:
- JavaFX 8.0
-
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
该方法应该委托给getClassCssMetaData()
,以便可以访问Node的CssMetaData而不需要反射。- Specified by:
-
getCssMetaData
在接口Styleable
- 结果
- 与该节点相关联的CssMetaData,其可以包括其超类的CssMetaData。
- 从以下版本开始:
- JavaFX 8.0
-
pseudoClassStateChanged
public final void pseudoClassStateChanged(PseudoClass pseudoClass, boolean active)
用于指定此节点的伪类已更改。 如果在与CSS相符的CSS选择器中使用伪类,则将重新应用CSS。 通常,该方法是从用作伪类的属性的invalidated
方法中调用的。 例如:private static final PseudoClass MY_PSEUDO_CLASS_STATE = PseudoClass.getPseudoClass("my-state"); BooleanProperty myPseudoClassState = new BooleanPropertyBase(false) { @Override public void invalidated() { pseudoClassStateChanged(MY_PSEUDO_CLASS_STATE, get()); } @Override public Object getBean() { return MyControl.this; } @Override public String getName() { return "myPseudoClassState"; } };
- 参数
-
pseudoClass
- 已修改状态的伪类 -
active
- 状态是否处于活动状态 - 从以下版本开始:
- JavaFX 8.0
-
getPseudoClassStates
public final ObservableSet<PseudoClass> getPseudoClassStates()
说明从界面Styleable
复制返回此Styleable的伪类状态。 CSS假定此集是只读的。- Specified by:
-
getPseudoClassStates
在接口Styleable
- 结果
- 此Node的活动伪类状态,包装在一个不可修改的ObservableSet中
- 从以下版本开始:
- JavaFX 8.0
-
applyCss
public final void applyCss()
如果需要,将样式应用于此节点及其子节点(如果有)。 此方法通常不需要直接调用,而是可以结合使用Parent.layout()
下一脉冲之前大小节点,或者如果Scene
不在Stage
。如果节点的
Scene
不为空,则CSS应用于此节点,而不管此节点的CSS状态是否干净。 CSS样式从此节点的最顶层父节点应用,其CSS状态不是干净的,这可能会影响其他节点的样式。 如果节点不在场景中,则此方法是无效的。 场景不必在舞台上。此方法不调用
Parent.layout()
方法。 通常,调用者将使用以下操作序列。parentNode.applyCss(); parentNode.layout();
作为更完整的示例,以下代码使用
applyCss()
和layout()
在舞台显示之前查找Button的宽度和高度。 如果要么调用applyCss()
或调用layout()
被注释掉,在两个电话getWidth()
和getHeight()
将返回零(直到显示在舞台一段时间后)。@Override public void start(Stage stage) throws Exception { Group root = new Group(); Scene scene = new Scene(root); Button button = new Button("Hello World"); root.getChildren().add(button); root.applyCss(); root.layout(); double width = button.getWidth(); double height = button.getHeight(); System.out.println(width + ", " + height); stage.setScene(scene); stage.show(); }
- 从以下版本开始:
- JavaFX 8.0
-
setAccessibleRole
public final void setAccessibleRole(AccessibleRole value)
设置属性accessibilityRole的值。- Property description:
-
这个
Node
的可访问角色。屏幕阅读器使用节点的角色来确定支持的属性和动作。
- Default value:
-
AccessibleRole.NODE
- 从以下版本开始:
- JavaFX 8u40
-
getAccessibleRole
public final AccessibleRole getAccessibleRole()
获取属性accessibilityRole的值。- Property description:
-
这个
Node
的可访问角色。屏幕阅读器使用节点的角色来确定支持的属性和动作。
- Default value:
-
AccessibleRole.NODE
- 从以下版本开始:
- JavaFX 8u40
-
accessibleRoleProperty
public final ObjectProperty<AccessibleRole> accessibleRoleProperty()
这个Node
的可访问角色。屏幕阅读器使用节点的角色来确定支持的属性和动作。
- Default value:
-
AccessibleRole.NODE
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleRole()
,setAccessibleRole(AccessibleRole)
-
setAccessibleRoleDescription
public final void setAccessibleRoleDescription(String value)
设置属性accessibilityRoleDescription的值。- Property description:
-
这个角色描述
Node
。可以说,当为节点提供角色时,屏幕阅读器说出节点的作用以及内容。 当设置此值时,可以覆盖默认值。 这是有用的,因为角色集是预定义的。 例如,可以将节点的角色设置为按钮,但将角色描述设置为任意文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
getAccessibleRoleDescription
public final String getAccessibleRoleDescription()
获取属性accessibilityRoleDescription的值。- Property description:
-
这个角色描述
Node
。可以说,当为节点提供角色时,屏幕阅读器说出节点的作用以及内容。 当设置此值时,可以覆盖默认值。 这是有用的,因为角色集是预定义的。 例如,可以将节点的角色设置为按钮,但将角色描述设置为任意文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
accessibleRoleDescriptionProperty
public final ObjectProperty<String> accessibleRoleDescriptionProperty()
这个角色描述Node
。可以说,当为节点提供角色时,屏幕阅读器说出节点的作用以及内容。 当设置此值时,可以覆盖默认值。 这是有用的,因为角色集是预定义的。 例如,可以将节点的角色设置为按钮,但将角色描述设置为任意文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleRoleDescription()
,setAccessibleRoleDescription(String)
-
setAccessibleText
public final void setAccessibleText(String value)
设置属性accessibleText的值。- Property description:
-
这个
Node
的可访问文本。此属性用于设置屏幕阅读器将发言的文本。 如果一个节点通常会说文字,那么该文本就会被覆盖。 例如,一个按钮通常使用控件中的文本,但在设置此值时将不再执行此操作。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
getAccessibleText
public final String getAccessibleText()
获取属性accessibleText的值。- Property description:
-
这个
Node
的可访问文本。此属性用于设置屏幕阅读器将发言的文本。 如果一个节点通常会说文字,那么该文本就会被覆盖。 例如,一个按钮通常使用控件中的文本,但在设置此值时将不再执行此操作。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
accessibleTextProperty
public final ObjectProperty<String> accessibleTextProperty()
这个Node
的可访问文本。此属性用于设置屏幕阅读器将发言的文本。 如果一个节点通常会说文字,那么该文本就会被覆盖。 例如,一个按钮通常使用控件中的文本,但在设置此值时将不再执行此操作。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleText()
,setAccessibleText(String)
-
setAccessibleHelp
public final void setAccessibleHelp(String value)
设置属性accessibleHelp的值。- Property description:
-
该
Node
的可访问帮助文本。帮助文本提供了节点可访问文本的更详细描述。 默认情况下,如果节点具有工具提示,则使用此文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
getAccessibleHelp
public final String getAccessibleHelp()
获取属性accessibleHelp的值。- Property description:
-
该
Node
的可访问的帮助文本。帮助文本提供了节点可访问文本的更详细描述。 默认情况下,如果节点具有工具提示,则使用此文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
-
accessibleHelpProperty
public final ObjectProperty<String> accessibleHelpProperty()
该Node
的无障碍帮助文本。帮助文本提供了节点可访问文本的更详细描述。 默认情况下,如果节点具有工具提示,则使用此文本。
- Default value:
- 空值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
getAccessibleHelp()
,setAccessibleHelp(String)
-
queryAccessibleAttribute
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
该方法由辅助技术调用以请求属性的值。子类通常覆盖此方法来实现特定角色所需的属性。
如果未处理特定属性,则必须调用超类实现。- 参数
-
attribute
- 请求的属性 -
parameters
- 可选参数列表 - 结果
- 请求的属性的值
- 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
AccessibleAttribute
-
executeAccessibleAction
public void executeAccessibleAction(AccessibleAction action, Object... parameters)
该方法由辅助技术调用,请求执行由参数指示的动作。此方法通常被子类覆盖,以实现特定角色所需的操作。
如果未处理特定操作,则必须调用超类实现。- 参数
-
action
- 要执行的动作 -
parameters
- 可选参数列表 - 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
AccessibleAction
-
notifyAccessibleAttributeChanged
public final void notifyAccessibleAttributeChanged(AccessibleAttribute attributes)
该方法由应用程序调用,以通知辅助技术属性的值已更改。- 参数
-
attributes
- 其值已更改的属性 - 从以下版本开始:
- JavaFX 8u40
- 另请参见:
-
AccessibleAttribute
-
-