Module  javafx.media
软件包  javafx.scene.media

Class MediaView

  • All Implemented Interfaces:
    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

    • Property Detail

      • preserveRatio

        public final BooleanProperty preserveRatioProperty
        是否在将其缩放以适应节点时保留介质的宽高比（宽/高）。 如果宽高比不被保留，则介质将在两个维度上被拉伸或剪切以适应节点的尺寸。 默认值为true 。
        另请参见：
        isPreserveRatio() ， setPreserveRatio(boolean)

      • smooth

        public final BooleanProperty smoothProperty
        如果设置为true将缩放此视频以适应fitWidth和fitHeight提供的边界框内或转换时使用更好的质量过滤算法。 如果设置为false将使用更快的质量过滤。 默认值取决于平台配置。
        另请参见：
        isSmooth() ， setSmooth(boolean)

      • 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)
        创建一个与指定的MediaPlayer相关联的MediaView实例。 相当于 
           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 。

      • setOnError

        public final void setOnError​(EventHandler<MediaErrorEvent> value)
        设置错误事件处理程序。
        参数
        value - 错误事件处理程序。

      • getOnError

        public final EventHandler<MediaErrorEvent> getOnError​()
        检索错误事件处理程序。
        结果
        错误事件处理程序。

      • 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)
        设置 MediaView原点的x坐标。
        参数
        value - 视图原点的x坐标。

      • getX

        public final double getX​()
        检索 MediaView原点的x坐标。
        结果
        视图原点的x坐标。

      • setY

        public final void setY​(double value)
        设置 MediaView原点的y坐标。
        参数
        value - 视图原点的y坐标。

      • getY

        public final double getY​()
        检索 MediaView起源的y坐标。
        结果
        视图的原点的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属性。

        另请参见：
        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)