Класс SubScene

java.lang.Object

javafx.scene.Node

javafx.scene.SubScene

Все реализуемые интерфейсы:: Styleable, EventTarget

public class SubScene
extends Node

Класс SubScene служит контейнером для содержимого в дереве сцены. SubScene обеспечивает разделение различных частей сцены, каждая из которых может быть отображена с помощью различной камеры, буфера глубины или антиалиасинга сцены. SubScene встраивается в основную сцену или другую подсцену.

Приложение может запросить поддержку буфера глубины или антиалиасинга сцены при создании SubScene. Подсцена, содержащая только 2D-фигуры и без каких-либо 3D-преобразований, не требует поддержки буфера глубины и антиалиасинга сцены. Подсцена, содержащая 3D-фигуры или 2D-фигуры с 3D-преобразованиями, может использовать поддержку буфера глубины для правильного отображения в порядке глубины; чтобы избежать конфликтов глубины (также известного как Z-конфликт), отключите тестирование глубины для 2D-фигур, у которых нет 3D-преобразований. Смотрите depthTest для получения дополнительной информации. Подсцена с 3D-фигурами может включить антиалиасинг сцены для повышения качества отображения.

Флаги depthBuffer и antiAliasing являются условными функциями. С соответствующими значениями по умолчанию: false и SceneAntialiasing.DISABLED. Смотрите ConditionalFeature.SCENE3D для получения дополнительной информации.

Возможные варианты использования:

Смешивание 2D и 3D содержимого
Наложение для элементов управления пользовательского интерфейса
Подложка для фона
Экранный дисплей

По умолчанию к SubScene, содержащей один или несколько Shape3D узлов, но без узлов освещения, будет добавлен фоновый источник света. Этот источник света является Color.WHITE PointLight, размещенным в позиции камеры.

С тех пор:: JavaFX 8.0

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`ObjectProperty<Camera>`	`camera`	Указывает тип камеры, используемой для отрисовки этого `SubScene`.
`ObjectProperty<Paint>`	`fill`	Определяет заполнение фона этого `SubScene`.
`DoubleProperty`	`height`	Определяет высоту этого `SubScene`.
`ObjectProperty<Parent>`	`root`	Определяет корневой `Node` графа сцены `SubScene`.
`ObjectProperty<String>`	`userAgentStylesheet`
`DoubleProperty`	`width`	Определяет ширину этого `SubScene`.

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

Краткое описание полей

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`SubScene(Parent root, double width, double height)`	Создает `SubScene` для определенного корневого узла с определенным размером.
`SubScene(Parent root, double width, double height, boolean depthBuffer, SceneAntialiasing antiAliasing)`	Создаёт `SubScene`, состоящий из корня, с заданными размерами ширины и высоты, указывает, создаётся ли буфер глубины для этой сцены и запрашивается ли антиалиасинг сцены.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ObjectProperty<Camera>`	`cameraProperty()`	Указывает тип камеры, используемой для отрисовки этого `SubScene`.
`ObjectProperty<Paint>`	`fillProperty()`	Определяет заполнение фона этого `SubScene`.
`SceneAntialiasing`	`getAntiAliasing()`	Возвращает заданное `SceneAntialiasing` для этого `SubScene`.
`Camera`	`getCamera()`	Возвращает значение свойства camera.
`Paint`	`getFill()`	Возвращает значение свойства fill.
`double`	`getHeight()`	Возвращает значение свойства height.
`Parent`	`getRoot()`	Возвращает значение свойства root.
`String`	`getUserAgentStylesheet()`	Возвращает URL пользовательского стиля, который будет использоваться этим SubScene.
`double`	`getWidth()`	Возвращает значение свойства width.
`DoubleProperty`	`heightProperty()`	Определяет высоту этого `SubScene`.
`boolean`	`isDepthBuffer()`	Возвращает атрибут буфера глубины для этого `SubScene`.
`ObjectProperty<Parent>`	`rootProperty()`	Определяет корневой `Node` графа сцены `SubScene`.
`void`	`setCamera(Camera value)`	Устанавливает значение свойства camera.
`void`	`setFill(Paint value)`	Устанавливает значение свойства fill.
`void`	`setHeight(double value)`	Устанавливает значение свойства height.
`void`	`setRoot(Parent value)`	Устанавливает значение свойства root.
`void`	`setUserAgentStylesheet(String url)`	Устанавливает URL пользовательского стиля, который будет использоваться этим SubScene вместо платформенно-стандартного пользовательского стиля.
`void`	`setWidth(double value)`	Устанавливает значение свойства width.
`ObjectProperty<String>`	`userAgentStylesheetProperty()`
`DoubleProperty`	`widthProperty()`	Определяет ширину этого `SubScene`.

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClassCssMetaData, getClip, getContentBias, getCssMetaData, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

Подробности свойств

root

public final ObjectProperty<Parent> rootProperty

Определяет корневой Node графа сцены. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень null.

См. также:: getRoot(), setRoot(Parent)

camera

public final ObjectProperty<Camera> cameraProperty

Указывает тип камеры, используемой для рендеринга этой SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другому Scene или SubScene.

Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D.

Значение по умолчанию:: null
См. также:: getCamera(), setCamera(Camera)

width

public final DoubleProperty widthProperty

Определяет ширину этого SubScene

Значение по умолчанию:: 0.0
См. также:: getWidth(), setWidth(double)

height

public final DoubleProperty heightProperty

Определяет высоту этого SubScene

Значение по умолчанию:: 0.0
См. также:: getHeight(), setHeight(double)

fill

public final ObjectProperty<Paint> fillProperty

Определяет заполнение фона этого SubScene. Поддерживаются как значение null, означающее отсутствие фона, так и Paint с прозрачностью. Значение по умолчанию — null.

Значение по умолчанию:: null
См. также:: getFill(), setFill(Paint)

userAgentStylesheet

public final ObjectProperty<String> userAgentStylesheetProperty

С:: JavaFX 8u20
См. также:: getUserAgentStylesheet(), setUserAgentStylesheet(String)

Подробности конструкторов

SubScene

public SubScene(Parent root, double width, double height)

Создает SubScene для определенного узла корня с определенным размером.

Параметры:: root - Корневой узел графа сцены; width - Ширина подсцены; height - Высота подсцены
Исключения:: NullPointerException - если root равен null

SubScene

public SubScene(Parent root, double width, double height, boolean depthBuffer, SceneAntialiasing antiAliasing)

Конструирует SubScene, состоящий из корня, с размерами ширины и высоты, указывает, создается ли буфер глубины для этой сцены, и указывает, запрошена ли антиалиасинг сцены.

Подсцена с только 2D фигурами и без каких-либо 3D преобразований не нуждается в буфере глубины или поддержке антиалиасинга сцены. Подсцена, содержащая 3D фигуры или 2D фигуры с 3D преобразованиями, может использовать поддержку буфера глубины для правильного рендеринга, отсортированного по глубине; чтобы избежать конфликтов глубины (также известные как Z-конфликты), отключите тестирование глубины для 2D фигур, у которых нет 3D преобразований. См. depthTest для получения дополнительной информации. Подсцена с 3D фигурами может включить антиалиасинг сцены, чтобы улучшить качество рендеринга.

Параметры:: root - Корневой узел графа сцены; width - Ширина подсцены; height - Высота подсцены; depthBuffer - Флаг буфера глубины; antiAliasing - Атрибут антиалиасинга подсцены. Значение null обрабатывается как DISABLED.
Флаги depthBuffer и antiAliasing являются условными функциями. С соответствующими значениями по умолчанию: false и SceneAntialiasing.DISABLED. Подробнее см. ConditionalFeature.SCENE3D.
Исключения:: NullPointerException - если root равен null
См. также:: Node.setDepthTest(DepthTest)

Подробности методов

getAntiAliasing

public final SceneAntialiasing getAntiAliasing()

Возвращает определенный SceneAntialiasing для этого SubScene.

Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D и SceneAntialiasing.

Возвращает:: SceneAntialiasing для этой подсцены
С:: JavaFX 8.0

isDepthBuffer

public final boolean isDepthBuffer()

Возвращает атрибут буфера глубины для этого SubScene.

Возвращает:: Атрибут буфера глубины.

setRoot

public final void setRoot(Parent value)

Устанавливает значение свойства root.

Описание свойства:: Определяет корневой Node графа сцены. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень null.

getRoot

public final Parent getRoot()

Получает значение свойства root.

Описание свойства:: Определяет корневой Node графа сцены. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень null.

rootProperty

public final ObjectProperty<Parent> rootProperty()

См. также:: getRoot(), setRoot(Parent)

setCamera

public final void setCamera(Camera value)

Устанавливает значение свойства camera.

Описание свойства:: Указывает тип камеры, используемой для рендеринга этого SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другому Scene или SubScene.
Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D.
Значение по умолчанию:: null

getCamera

public final Camera getCamera()

Получает значение свойства camera.

Описание свойства:: Указывает тип камеры, используемой для рендеринга этого SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другому Scene или SubScene.
Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D.
Значение по умолчанию:: null

cameraProperty

public final ObjectProperty<Camera> cameraProperty()

Указывает тип камеры, используемой для рендеринга этого SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другому Scene или SubScene.

Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D.

Значение по умолчанию:: null
См. также:: getCamera(), setCamera(Camera)

setWidth

public final void setWidth(double value)

Устанавливает значение свойства width.

Описание свойства:: Определяет ширину этого SubScene
Значение по умолчанию:: 0.0

getWidth

public final double getWidth()

Получает значение свойства width.

Описание свойства:: Определяет ширину этого SubScene
Значение по умолчанию:: 0.0

widthProperty

public final DoubleProperty widthProperty()

Определяет ширину этого SubScene

Значение по умолчанию:: 0.0
См. также:: getWidth(), setWidth(double)

setHeight

public final void setHeight(double value)

Устанавливает значение свойства height.

Описание свойства:: Определяет высоту этого SubScene
Значение по умолчанию:: 0.0

getHeight

public final double getHeight()

Получает значение свойства высоты.

Описание свойства:: Определяет высоту этого SubScene
Значение по умолчанию:: 0.0

heightProperty

public final DoubleProperty heightProperty()

Определяет высоту этого SubScene

Значение по умолчанию:: 0.0
См. также:: getHeight(), setHeight(double)

setFill

public final void setFill(Paint value)

Устанавливает значение свойства заливки.

Описание свойства:: Определяет фоновую заливку этого SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.
Значение по умолчанию:: null

getFill

public final Paint getFill()

Получает значение свойства заливки.

Описание свойства:: Определяет фоновую заливку этого SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.
Значение по умолчанию:: null

fillProperty

public final ObjectProperty<Paint> fillProperty()

Определяет фоновую заливку этого SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.

Значение по умолчанию:: null
См. также:: getFill(), setFill(Paint)

userAgentStylesheetProperty

public final ObjectProperty<String> userAgentStylesheetProperty()

С момента:: JavaFX 8u20
См. также:: getUserAgentStylesheet(), setUserAgentStylesheet(String)

getUserAgentStylesheet

public final String getUserAgentStylesheet()

Получить URL пользовательского стиля, который будет использоваться этой SubScene. Если URL не задан, будет использоваться системный пользовательский стиль.

Для дополнительной информации об использовании CSS с деревом сцены, см. Руководство по CSS.

Возвращает:: URL пользовательского стиля, который будет использоваться этой SubScene, или null, если не задан.
С момента:: JavaFX 8u20

setUserAgentStylesheet

public final void setUserAgentStylesheet(String url)

Установить URL пользовательского стиля, который будет использоваться этой SubScene вместо системного. Если URL не указывает на допустимый ресурс, будет использоваться системный пользовательский стиль.

URL является иерархическим URI вида [схема:][//авторитет][путь]. Если в URL нет компонента [схема:], URL рассматривается как только компонент [путь]. Любой ведущий символ '/' в [пути] игнорируется, и [путь] обрабатывается как путь относительно корня пути класса приложения.

Поддерживается схема "data" RFC 2397 для URL, а также обработчики протоколов, зарегистрированные для приложения. Если URL использует схему "data", а тип MIME пустой, "text/plain" или "text/css", содержимое будет интерпретировано как файл CSS. Если тип MIME "application/octet-stream", содержимое будет интерпретировано как двоичный файл CSS (см. Stylesheet.convertToBinary(File, File)).

Для дополнительной информации об использовании CSS с деревом сцены, см. Руководство по CSS.

Параметры:: url - URL пользовательского стиля
С момента:: JavaFX 8u20

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.