Класс MediaView

java.lang.Object

javafx.scene.Node

com.sun.javafx.scene.AbstractNode

javafx.scene.media.MediaView

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

public class MediaView extends com.sun.javafx.scene.AbstractNode

A Node, который предоставляет вид Media, воспроизводимого MediaPlayer.

Следующий фрагмент кода предоставляет простой пример метода Application.start(), который отображает видео:


 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);
 }

Отображаемое видео будет выглядеть так:

Hello Media

С момента:: JavaFX 2.0

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

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

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

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

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

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

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

mediaPlayer

public final ObjectProperty<MediaPlayer> mediaPlayerProperty

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

См. также:

onError

public final ObjectProperty<EventHandler<MediaErrorEvent>> onErrorProperty

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

См. также:

preserveRatio

public final BooleanProperty preserveRatioProperty

Удерживать ли пропорции (ширина / высота) медиа при масштабировании для соответствия узлу. Если пропорции не сохраняются, медиа будет растянуто или сдвинуто по обеим осям для соответствия размерам узла. Значение по умолчанию - true.

См. также:

smooth

public final BooleanProperty smoothProperty

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

См. также:

x

public final DoubleProperty xProperty

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

См. также:

y

public final DoubleProperty yProperty

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

См. также:

fitWidth

public final DoubleProperty fitWidthProperty

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

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

См. также:

fitHeight

public final DoubleProperty fitHeightProperty

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

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

См. также:

viewport

public final ObjectProperty<Rectangle2D> viewportProperty

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

См. также:

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

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()

Возвращает:

свойство mediaPlayer

См. также:

setOnError

public final void setOnError(EventHandler<MediaErrorEvent> value)

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

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

getOnError

public final EventHandler<MediaErrorEvent> getOnError()

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

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

onErrorProperty

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

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

Возвращает:

свойство onError

См. также:

setPreserveRatio

public final void setPreserveRatio(boolean value)

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

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

isPreserveRatio

public final boolean isPreserveRatio()

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

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

END_OF_DOCUMENT_MARKER

preserveRatioProperty

public final BooleanProperty preserveRatioProperty()

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

Возвращает:

свойство preserveRatio

См. также:

setSmooth

public final void setSmooth(boolean value)

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

Параметры:: value - следует ли сглаживать медиа.

isSmooth

public final boolean isSmooth()

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

Возвращает:: следует ли сглаживать медиа

smoothProperty

public final BooleanProperty smoothProperty()

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

Возвращает:

свойство smooth

См. также:

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.

Возвращает:

свойство x

См. также:

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.

Возвращает:

свойство y

См. также:

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 атрибутами.

Возвращает:

свойство fitWidth

См. также:

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 атрибутами.

Возвращает:

свойство fitHeight

См. также:

setViewport

public final void setViewport(Rectangle2D value)

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

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

getViewport

public final Rectangle2D getViewport()

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

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

viewportProperty

public final ObjectProperty<Rectangle2D> viewportProperty()

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

Возвращает:

свойство viewport

См. также:

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