- java.lang.Object
-
- javafx.scene.Node
-
- javafx.scene.media.MediaView
-
- Все реализуемые интерфейсы:
-
Styleable,EventTarget
public class MediaView extends Node
Элемент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); }
- С момента:
- JavaFX 2.0
-
Краткое описание свойств
Свойства Тип Свойство Описание DoublePropertyfitHeightОпределяет высоту ограничивающей области, в которой исходное медиа масштабируется для соответствия.DoublePropertyfitWidthОпределяет ширину ограничивающей области, в которой исходное медиа масштабируется для соответствия.ObjectProperty<MediaPlayer>mediaPlayermediaPlayer, выходной поток которого будет обрабатываться этим представлением.ObjectProperty<EventHandler<MediaErrorEvent>>onErrorОбработчик событий, вызываемый при возникновении ошибки в этомMediaView.BooleanPropertypreserveRatioУказывает, сохранять ли пропорции (ширина / высота) медиа при масштабировании для соответствия узлу.BooleanPropertysmoothЕсли установлено вtrue, будет использоваться более качественный алгоритм фильтрации при масштабировании этого видео для соответствия области, заданнойfitWidthиfitHeight, или при преобразовании.ObjectProperty<Rectangle2D>viewportОпределяет прямоугольный область просмотра в кадре медиа.DoublePropertyxОпределяет текущую координату x началаMediaView.DoublePropertyyОпределяет текущую координату 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.
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание DoublePropertyfitHeightProperty()Определяет высоту области, в которой необходимо изменить размер исходного медиаконтента для соответствия.DoublePropertyfitWidthProperty()Определяет ширину области, в которой необходимо изменить размер исходного медиаконтента для соответствия.doublegetFitHeight()Возвращает высоту области отрисованного, изменённого размера медиа.doublegetFitWidth()Возвращает ширину области отрисованного, изменённого размера медиа.MediaPlayergetMediaPlayer()ВозвращаетMediaPlayer, вывод которого обрабатывается этим представлением.EventHandler<MediaErrorEvent>getOnError()Возвращает обработчик событий об ошибке.Rectangle2DgetViewport()Возвращает прямоугольную область обзора внутри фрейма медиа.doublegetX()Возвращает координату x началаMediaView.doublegetY()Возвращает координату y началаMediaView.booleanisPreserveRatio()Возвращает, сохраняется ли соотношение сторон медиа при масштабировании.booleanisSmooth()Возвращает, сглаживается ли медиа при масштабировании.ObjectProperty<MediaPlayer>mediaPlayerProperty()mediaPlayer, вывод которого будет обрабатываться этим представлением.ObjectProperty<EventHandler<MediaErrorEvent>>onErrorProperty()Обработчик событий, вызываемый при возникновении ошибки в этомMediaView.BooleanPropertypreserveRatioProperty()Сохраняется ли соотношение сторон (ширина / высота) медиа при масштабировании до узла.voidsetFitHeight(double value)Устанавливает высоту области отрисованного, изменённого размера медиа.voidsetFitWidth(double value)Устанавливает ширину области отрисованного, изменённого размера медиа.voidsetMediaPlayer(MediaPlayer value)УстанавливаетMediaPlayer, вывод которого будет обрабатываться этим представлением.voidsetOnError(EventHandler<MediaErrorEvent> value)Устанавливает обработчик событий об ошибке.voidsetPreserveRatio(boolean value)Устанавливает, сохранять ли соотношение сторон медиа при масштабировании.voidsetSmooth(boolean value)Устанавливает, сглаживать ли медиа при масштабировании.voidsetViewport(Rectangle2D value)Устанавливает прямоугольную область обзора внутри фрейма медиа.voidsetX(double value)Устанавливает координату x началаMediaView.voidsetY(double value)Устанавливает координату y началаMediaView.BooleanPropertysmoothProperty()Если установлено значениеtrue, при масштабировании этого видео для соответствия области, заданнойfitWidthиfitHeight, или при преобразовании будет использоваться алгоритм фильтрации лучшего качества.ObjectProperty<Rectangle2D>viewportProperty()Определяет прямоугольную область обзора внутри фрейма медиа.DoublePropertyxProperty()Определяет текущую координату x началаMediaView.DoublePropertyyProperty()Определяет текущую координату 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, getStyleClass, 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
-
-
Подробное описание свойств
-
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в значение null очистит фрагмент просмотра.- См. также:
-
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()
mediaPlayer, чьи выводы будут обрабатываться этим представлением. Установка этого значения не влияет на состояниеMediaPlayer, например, еслиMediaPlayerвоспроизводился до установкиmediaPlayer, он будет продолжать воспроизводиться.- См. также:
-
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()
Сохранять ли пропорции (ширина/высота) медиа при масштабировании до размеров узла. Если пропорции не сохраняются, медиа будет растянуто или сжато по обеим осям, чтобы соответствовать размерам узла. Значение по умолчанию —true.- См. также:
-
isPreserveRatio(),setPreserveRatio(boolean)
-
setSmooth
public final void setSmooth(boolean value)
Устанавливает, сглаживать ли медиа при масштабировании.- Параметры:
-
value- сглаживать ли медиа.
-
isSmooth
public final boolean isSmooth()
Возвращает, сглаживать ли медиа при масштабировании.- Возвращает:
- сглаживать ли медиа
-
smoothProperty
public final BooleanProperty smoothProperty()
Если установлено вtrue, будет использоваться алгоритм фильтрации лучшего качества при масштабировании видео для соответствия заданной рамкеfitWidthиfitHeightили при преобразовании. Если установлено вfalse, будет использоваться более быстрый, но менее качественный алгоритм фильтрации. Значение по умолчанию зависит от конфигурации платформы.- См. также:
-
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)
Устанавливает прямоугольный фрагмент (viewport) в рамке медиа.- Параметры:
-
value- прямоугольный фрагмент.
-
getViewport
public final Rectangle2D getViewport()
Возвращает прямоугольный фрагмент (viewport) в рамке медиа.- Возвращает:
- прямоугольный фрагмент.
-
viewportProperty
public final ObjectProperty<Rectangle2D> viewportProperty()
Определяет прямоугольный фрагмент (viewport) в рамке медиа. Фрагмент — прямоугольник, заданный в координатах рамки медиа. Результирующие размеры до масштабирования будут соответствовать размерам фрагмента. Отображаемый фрагмент будет включать пересечение рамки и фрагмента. Фрагмент может превышать размеры рамки, но отображаться будет только пересечение. Установка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.