Класс MediaView

java.lang.Object

javafx.scene.Node

javafx.scene.media.MediaView

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

public class MediaView
extends Node

A Node that provides a view of Media being played by a MediaPlayer.

The following code snippet provides a simple example of an Application.start() method which displays a video:


 public void start(Stage stage) {
     // Create and set the Scene.
     Scene scene = new Scene(new Group(), 540, 209);
     stage.setScene(scene);

     // Name and display the Stage.
     stage.setTitle("Hello Media");
     stage.show();

     // Create the media source.
     String source = getParameters().getRaw().get(0);
     Media media = new Media(source);

     // Create the player and set to play automatically.
     MediaPlayer mediaPlayer = new MediaPlayer(media);
     mediaPlayer.setAutoPlay(true);

     // Create the view and add it to the Scene.
     MediaView mediaView = new MediaView(mediaPlayer);
     ((Group) scene.getRoot()).getChildren().add(mediaView);
 }

The foregoing code will display the video as:

Hello Media

Since:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`DoubleProperty`	`fitHeight`	Определяет высоту ограничивающей рамки, в пределах которой исходные медиаданные масштабируются по мере необходимости для размещения.
`DoubleProperty`	`fitWidth`	Определяет ширину ограничивающей рамки, в пределах которой исходные медиаданные масштабируются по мере необходимости для размещения.
`ObjectProperty<MediaPlayer>`	`mediaPlayer`	`mediaPlayer`, вывод которого будет обрабатываться этим представлением.
`ObjectProperty<EventHandler<MediaErrorEvent>>`	`onError`	Обработчик событий, вызываемый всякий раз, когда возникает ошибка в данном `MediaView`.
`BooleanProperty`	`preserveRatio`	Указывает, сохранять ли пропорции (ширина/высота) медиаданных при масштабировании для их размещения в узле.
`BooleanProperty`	`smooth`	Если установлено в `true`, будет использоваться алгоритм фильтрации лучшего качества при масштабировании этого видео для размещения в пределах ограничивающей рамки, предоставляемой `fitWidth` и `fitHeight`, или при преобразовании.
`ObjectProperty<Rectangle2D>`	`viewport`	Указывает прямоугольную область просмотра в рамках кадра медиа.
`DoubleProperty`	`x`	Определяет текущую координату x начала `MediaView`.
`DoubleProperty`	`y`	Определяет текущую координату y начала `MediaView`.

Свойства, объявленные в классе 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

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

Конструкторы
Конструктор	Описание
`MediaView()`	Создаёт экземпляр `MediaView` без связанного `MediaPlayer`.
`MediaView(MediaPlayer mediaPlayer)`	Создаёт экземпляр `MediaView`, связанный с указанным `MediaPlayer`.

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

Модификатор и тип	Метод	Описание
`DoubleProperty`	`fitHeightProperty()`	Определяет высоту области, в которую необходимо изменить размер исходных данных, чтобы они поместились.
`DoubleProperty`	`fitWidthProperty()`	Определяет ширину области, в которую необходимо изменить размер исходных данных, чтобы они поместились.
`double`	`getFitHeight()`	Возвращает высоту области, в которую помещается измененный размер.
`double`	`getFitWidth()`	Возвращает ширину области, в которую помещается измененный размер.
`MediaPlayer`	`getMediaPlayer()`	Возвращает `MediaPlayer`, чьи данные обрабатываются этим представлением.
`EventHandler<MediaErrorEvent>`	`getOnError()`	Возвращает обработчик события об ошибке.
`Rectangle2D`	`getViewport()`	Возвращает прямоугольную область просмотра в кадре мультимедиа.
`double`	`getX()`	Возвращает координату x начала `MediaView`.
`double`	`getY()`	Возвращает координату y начала `MediaView`.
`boolean`	`isPreserveRatio()`	Возвращает, сохраняется ли соотношение сторон мультимедиа при масштабировании.
`boolean`	`isSmooth()`	Возвращает, сглаживается ли мультимедиа при масштабировании.
`ObjectProperty<MediaPlayer>`	`mediaPlayerProperty()`	`mediaPlayer`, чьи данные будут обрабатываться этим представлением.
`ObjectProperty<EventHandler<MediaErrorEvent>>`	`onErrorProperty()`	Обработчик события об ошибке, вызываемый при возникновении ошибки в этом `MediaView`.
`BooleanProperty`	`preserveRatioProperty()`	Сохранять ли соотношение сторон (ширина / высота) мультимедиа при масштабировании его для помещения в узел.
`void`	`setFitHeight(double value)`	Устанавливает высоту области, в которую помещается измененный размер.
`void`	`setFitWidth(double value)`	Устанавливает ширину области, в которую помещается измененный размер.
`void`	`setMediaPlayer(MediaPlayer value)`	Устанавливает `MediaPlayer`, чьи данные будут обрабатываться этим представлением.
`void`	`setOnError(EventHandler<MediaErrorEvent> value)`	Устанавливает обработчик события об ошибке.
`void`	`setPreserveRatio(boolean value)`	Устанавливает, сохранять ли соотношение сторон мультимедиа при масштабировании.
`void`	`setSmooth(boolean value)`	Устанавливает, сглаживать ли мультимедиа при масштабировании.
`void`	`setViewport(Rectangle2D value)`	Устанавливает прямоугольную область просмотра в кадре мультимедиа.
`void`	`setX(double value)`	Устанавливает координату x начала `MediaView`.
`void`	`setY(double value)`	Устанавливает координату y начала `MediaView`.
`BooleanProperty`	`smoothProperty()`	Если установлено значение `true`, то при масштабировании этого видео для помещения в область, заданную `fitWidth` и `fitHeight`, или при преобразовании будет использоваться алгоритм фильтрации лучшего качества.
`ObjectProperty<Rectangle2D>`	`viewportProperty()`	Определяет прямоугольную область просмотра в кадре мультимедиа.
`DoubleProperty`	`xProperty()`	Определяет текущую координату x начала `MediaView`.
`DoubleProperty`	`yProperty()`	Определяет текущую координату y начала `MediaView`.

Методы, объявленные в классе 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

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

mediaPlayer

public final ObjectProperty<MediaPlayer> mediaPlayerProperty

mediaPlayer, чья выходная информация будет обрабатываться этим представлением. Установка этого значения не влияет на состояние MediaPlayer, например, если MediaPlayer воспроизводился до установки mediaPlayer, он продолжит воспроизведение.

См. также:: getMediaPlayer(), setMediaPlayer(MediaPlayer)

onError

public final ObjectProperty<EventHandler<MediaErrorEvent>> onErrorProperty

Обработчик событий, вызываемый всякий раз, когда в этом MediaView возникает ошибка.

См. также:: getOnError(), setOnError(EventHandler)

preserveRatio

public final BooleanProperty preserveRatioProperty

Сохранять ли соотношение сторон (ширина/высота) медиа при масштабировании для подгонки к узлу. Если соотношение сторон не сохраняется, медиа будет растянуто или сдвинуто по обеим осям, чтобы соответствовать размерам узла. Значение по умолчанию — true.

См. также:: isPreserveRatio(), setPreserveRatio(boolean)

smooth

public final BooleanProperty smoothProperty

Если установлено true, при масштабировании этого видео для подгонки к области, заданной fitWidth и fitHeight, или при преобразовании будет использоваться алгоритм фильтрации лучшего качества. Если установлено false, будет использоваться более быстрый, но менее качественный алгоритм фильтрации. Значение по умолчанию зависит от конфигурации платформы.

См. также:: isSmooth(), setSmooth(boolean)

x

public final DoubleProperty xProperty

Определяет текущую координату x начала MediaView.

См. также:: getX(), setX(double)

y

public final DoubleProperty yProperty

Определяет текущую координату y начала MediaView.

См. также:: getY(), setY(double)

fitWidth

public final DoubleProperty fitWidthProperty

Определяет ширину области, в пределах которой исходное медиа масштабируется для подгонки. Если value ≤ 0, ширина области будет установлена равной естественной ширине медиа, но fitWidth будет установлено в переданный параметр, даже если он неположительный.

См. preserveRatio для информации о взаимодействии между представлениями медиа fitWidth, fitHeight и preserveRatio атрибутов.

См. также:: getFitWidth(), setFitWidth(double)

fitHeight

public final DoubleProperty fitHeightProperty

Определяет высоту области, в пределах которой исходное медиа масштабируется для подгонки. Если value ≤ 0, высота области будет установлена равной естественной высоте медиа, но fitHeight будет установлено в переданный параметр, даже если он неположительный.

См. preserveRatio для информации о взаимодействии между представлениями медиа fitWidth, fitHeight и preserveRatio атрибутов.

См. также:: getFitHeight(), setFitHeight(double)

viewport

public final ObjectProperty<Rectangle2D> viewportProperty

Определяет прямоугольное представление (viewport) в кадре медиа. Представление — прямоугольник, заданный координатами в кадре медиа. Результирующая область до масштабирования будет иметь размер представления. Отображаемое изображение будет включать пересечение кадра и представления. Представление может превышать размер кадра, но будет отображаться только пересечение.

См. также:: getViewport(), setViewport(Rectangle2D)

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

MediaView

public MediaView()

Создаёт экземпляр MediaView без связанного MediaPlayer.

MediaView

public MediaView(MediaPlayer mediaPlayer)

Создаёт экземпляр MediaView, связанный с указанным MediaPlayer. Эквивалентно


 MediaPlayer player; // initialization omitted
 MediaView view = new MediaView();
 view.setMediaPlayer(player);

Параметры:: mediaPlayer — MediaPlayer, чьё воспроизведение нужно просматривать через этот класс.

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

setMediaPlayer

public final void setMediaPlayer(MediaPlayer value)

Устанавливает MediaPlayer, чья выходная информация будет обрабатываться этим представлением.

Параметры:: value — связанный MediaPlayer.

getMediaPlayer

public final MediaPlayer getMediaPlayer()

Возвращает MediaPlayer, чья выходная информация обрабатывается этим представлением.

Возвращает:: связанный MediaPlayer.

mediaPlayerProperty

public final ObjectProperty<MediaPlayer> mediaPlayerProperty()

См. также:: getMediaPlayer(), setMediaPlayer(MediaPlayer)

setOnError

public final void setOnError(EventHandler<MediaErrorEvent> value)

Устанавливает обработчик ошибок.

Параметры:: value — обработчик ошибок.

getOnError

public final EventHandler<MediaErrorEvent> getOnError()

Возвращает обработчик ошибок.

Возвращает:: обработчик ошибок.

onErrorProperty

public final ObjectProperty<EventHandler<MediaErrorEvent>> onErrorProperty()

Обработчик событий, вызываемый всякий раз, когда в этом MediaView возникает ошибка.

См. также:: getOnError(), setOnError(EventHandler)

setPreserveRatio

public final void setPreserveRatio(boolean value)

Устанавливает, сохранять ли соотношение сторон медиа при масштабировании.

Параметры:: value — сохранять ли соотношение сторон медиа.

isPreserveRatio

public final boolean isPreserveRatio()

Возвращает, сохраняется ли соотношение сторон медиа при масштабировании.

Возвращает:: сохраняется ли соотношение сторон медиа.

preserveRatioProperty

public final BooleanProperty preserveRatioProperty()

См. также:: isPreserveRatio(), setPreserveRatio(boolean)

setSmooth

public final void setSmooth(boolean value)

Устанавливает, применять ли сглаживание к медиа при масштабировании.

Параметры:: value — применять ли сглаживание к медиа.

isSmooth

public final boolean isSmooth()

Возвращает, применяется ли сглаживание к медиа при масштабировании.

Возвращает:: применяется ли сглаживание к медиа.

smoothProperty

public final BooleanProperty smoothProperty()

См. также:: isSmooth(), setSmooth(boolean)

setX

public final void setX(double value)

Устанавливает координату x начала MediaView.

Параметры:: value — координата x начала представления.

getX

public final double getX()

Возвращает координату x начала MediaView.

Возвращает:: координата x начала представления.

xProperty

public final DoubleProperty xProperty()

Определяет текущую координату x начала MediaView.

См. также:: getX(), setX(double)

setY

public final void setY(double value)

Устанавливает координату y начала MediaView.

Параметры:: value - координата y начала области просмотра.

getY

public final double getY()

Возвращает координату y начала MediaView.

Возвращает:: координату y начала области просмотра.

yProperty

public final DoubleProperty yProperty()

Определяет текущую координату y начала MediaView.

См. также:: getY(), setY(double)

setFitWidth

public final void setFitWidth(double value)

Устанавливает ширину ограничивающей рамки изменённого медиа.

Параметры:: value - ширина изменённого медиа.

getFitWidth

public final double getFitWidth()

Возвращает ширину ограничивающей рамки изменённого медиа.

Возвращает:: высоту изменённого медиа.

fitWidthProperty

public final DoubleProperty fitWidthProperty()

Определяет ширину ограничивающей рамки, в пределах которой исходное медиа масштабируется для соответствия. Если value ≤ 0, то ширина ограничивающей рамки будет установлена в естественную ширину медиа, но fitWidth будет установлено в указанный параметр, даже если он отрицательный.

См. preserveRatio для информации о взаимодействии между представлениями медиа fitWidth, fitHeight и preserveRatio атрибутами.

См. также:: getFitWidth(), setFitWidth(double)

setFitHeight

public final void setFitHeight(double value)

Устанавливает высоту ограничивающей рамки изменённого медиа.

Параметры:: value - высота изменённого медиа.

getFitHeight

public final double getFitHeight()

Возвращает высоту ограничивающей рамки изменённого медиа.

Возвращает:: высоту изменённого медиа.

fitHeightProperty

public final DoubleProperty fitHeightProperty()

Определяет высоту ограничивающей рамки, в пределах которой исходное медиа масштабируется для соответствия. Если value ≤ 0, то высота ограничивающей рамки будет установлена в естественную высоту медиа, но fitHeight будет установлено в указанный параметр, даже если он отрицательный.

См. preserveRatio для информации о взаимодействии между представлениями медиа fitWidth, fitHeight и preserveRatio атрибутами.

См. также:: getFitHeight(), setFitHeight(double)

setViewport

public final void setViewport(Rectangle2D value)

Устанавливает прямоугольную область просмотра в фрейме медиа.

Параметры:: value - прямоугольная область просмотра.

getViewport

public final Rectangle2D getViewport()

Возвращает прямоугольную область просмотра в фрейме медиа.

Возвращает:: прямоугольную область просмотра.

viewportProperty

public final ObjectProperty<Rectangle2D> viewportProperty()

Определяет прямоугольную область просмотра в фрейме медиа. Область просмотра — это прямоугольник, заданный в координатах фрейма медиа. Результирующие границы до масштабирования будут размером области просмотра. Отображаемое изображение будет включать пересечение фрейма и области просмотра. Область просмотра может превышать размер фрейма, но отображаться будет только пересечение. Установка viewport в null очистит область просмотра.

См. также:: getViewport(), setViewport(Rectangle2D)

© 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.