Класс SubScene

java.lang.Object

javafx.scene.Node

javafx.scene.SubScene

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

public non-sealed 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

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

Тип	Свойство	Описание
`final ObjectProperty<Camera>`	`camera`	Указывает тип камеры, используемой для отображения этой `SubScene`.
`final ObjectProperty<Paint>`	`fill`	Определяет заполнение фона для этой `SubScene`.
`final DoubleProperty`	`height`	Определяет высоту этой `SubScene`
`final ObjectProperty<Parent>`	`root`	Определяет корневой `Node` графа сцены `SubScene`.
`final ObjectProperty<String>`	`userAgentStylesheet`	Возвращает свойство userAgentStylesheet.
`final 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, focusVisible, focusWithin, 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`, состоящий из корня, с размерами ширины и высоты, указывает, создаётся ли буфер глубины для этой сцены, и указывает, запрашивается ли антиалиасинг сцены.

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

Модификатор и тип	Метод	Описание
`final ObjectProperty<Camera>`	`cameraProperty()`	Указывает тип камеры, используемой для отображения этой `SubScene`.
`final ObjectProperty<Paint>`	`fillProperty()`	Определяет заполнение фона для этой `SubScene`.
`final SceneAntialiasing`	`getAntiAliasing()`	Возвращает определённый `SceneAntialiasing` для этой `SubScene`.
`final Camera`	`getCamera()`	Возвращает значение свойства `camera`.
`final Paint`	`getFill()`	Возвращает значение свойства `fill`.
`final double`	`getHeight()`	Возвращает значение свойства `height`.
`final Parent`	`getRoot()`	Возвращает значение свойства `root`.
`final String`	`getUserAgentStylesheet()`	Возвращает URL пользовательского стиля пользователя, который будет использоваться этой SubScene.
`final double`	`getWidth()`	Возвращает значение свойства `width`.
`final DoubleProperty`	`heightProperty()`	Определяет высоту этой `SubScene`
`final boolean`	`isDepthBuffer()`	Возвращает атрибут буфера глубины для этой `SubScene`.
`final ObjectProperty<Parent>`	`rootProperty()`	Определяет корневой `Node` графа сцены `SubScene`.
`final void`	`setCamera(Camera value)`	Устанавливает значение свойства `camera`.
`final void`	`setFill(Paint value)`	Устанавливает значение свойства `fill`.
`final void`	`setHeight(double value)`	Устанавливает значение свойства `height`.
`final void`	`setRoot(Parent value)`	Устанавливает значение свойства `root`.
`final void`	`setUserAgentStylesheet(String url)`	Устанавливает URL пользовательского стиля пользователя, который будет использоваться этой SubScene вместо стандартного стиля пользователя платформы.
`final void`	`setWidth(double value)`	Устанавливает значение свойства `width`.
`final ObjectProperty<String>`	`userAgentStylesheetProperty()`	Возвращает свойство userAgentStylesheet.
`final 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, focusVisibleProperty, focusWithinProperty, 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, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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, requestFocusTraversal, 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

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

root

public final ObjectProperty<Parent> rootProperty

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

Псевдокласс :root соответствует корневому узлу.

SubScene не принимает нулевой корень.

См. также:

camera

public final ObjectProperty<Camera> cameraProperty

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

Примечание: эта функция является условной. Дополнительную информацию см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

См. также:

width

public final DoubleProperty widthProperty

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

Значение по умолчанию:

0.0

См. также:

height

public final DoubleProperty heightProperty

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

Значение по умолчанию:

0.0

См. также:

fill

public final ObjectProperty<Paint> fillProperty

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

Значение по умолчанию:

null

См. также:

userAgentStylesheet

public final ObjectProperty<String> userAgentStylesheetProperty

Получает свойство userAgentStylesheet.

С момента:

JavaFX 8u20

См. также:

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

SubScene

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

Создает SubScene для определенного узла корня со специфическими размерами.

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

См. также:

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

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.

Описание свойства:

Псевдокласс :root соответствует корневому узлу.

SubScene не принимает нулевой корень.

Параметры:

value - значение для свойства root

См. также:

getRoot

public final Parent getRoot()

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

Описание свойства:

Псевдокласс :root соответствует корневому узлу.

SubScene не принимает нулевой корень.

Возвращает:

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

См. также:

rootProperty

public final ObjectProperty<Parent> rootProperty()

Псевдокласс :root соответствует корневому узлу.

SubScene не принимает нулевой корень.

Возвращает:

свойство root

См. также:

setCamera

public final void setCamera(Camera value)

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

Описание свойства:

Примечание: эта функция является условной. Дополнительную информацию см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Параметры:

value - значение для свойства camera

См. также:

getCamera

public final Camera getCamera()

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

Описание свойства:

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

Примечание: это условная возможность. Дополнительную информацию см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Возвращает:

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

См. также:

cameraProperty

public final ObjectProperty<Camera> cameraProperty()

Примечание: это условная возможность. Дополнительную информацию см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Возвращает:

свойство camera

См. также:

setWidth

public final void setWidth(double value)

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

Описание свойства:

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

Значение по умолчанию:

0.0

Параметры:

value - значение для свойства width

См. также:

getWidth

public final double getWidth()

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

Описание свойства:

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

Значение по умолчанию:

0.0

Возвращает:

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

См. также:

widthProperty

public final DoubleProperty widthProperty()

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

Значение по умолчанию:

0.0

Возвращает:

свойство width

См. также:

setHeight

public final void setHeight(double value)

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

Описание свойства:

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

Значение по умолчанию:

0.0

Параметры:

value - значение для свойства height

См. также:

getHeight

public final double getHeight()

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

Описание свойства:

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

Значение по умолчанию:

0.0

Возвращает:

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

См. также:

heightProperty

public final DoubleProperty heightProperty()

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

Значение по умолчанию:

0.0

Возвращает:

свойство height

См. также:

setFill

public final void setFill(Paint value)

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

Описание свойства:

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

Значение по умолчанию:

null

Параметры:

value - значение для свойства fill

См. также:

getFill

public final Paint getFill()

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

Описание свойства:

Значение по умолчанию:

null

Возвращает:

значение свойства fill

См. также:

fillProperty

public final ObjectProperty<Paint> fillProperty()

Значение по умолчанию:

null

Возвращает:

свойство fill

См. также:

userAgentStylesheetProperty

public final ObjectProperty<String> userAgentStylesheetProperty()

Получает свойство userAgentStylesheet.

Возвращает:

свойство userAgentStylesheet

Since:

JavaFX 8u20

См. также:

getUserAgentStylesheet

public final String getUserAgentStylesheet()

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

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

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

setUserAgentStylesheet

public final void setUserAgentStylesheet(String url)

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

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

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

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

Параметры:: url - URL пользовательского стиля
Since:: 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.