MediaElement.PosterSource 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置在 MediaElement 加载转换状态期间用于占位符图像的图像源。

public:
 property ImageSource ^ PosterSource { ImageSource ^ get(); void set(ImageSource ^ value); };

ImageSource PosterSource();

void PosterSource(ImageSource value);

public ImageSource PosterSource { get; set; }

var imageSource = mediaElement.posterSource;
mediaElement.posterSource = imageSource;

Public Property PosterSource As ImageSource

<MediaElement PosterSource="imageUri" />

属性值

ImageSource

应用于 MediaElement 内容区域的转换 ImageBrush 的图像源。

注解

PosterSource 是用于代替视频显示的图像，如专辑封面或电影海报。 它为 MediaElement 提供加载媒体之前或仅当媒体为音频时的可视表示形式。

PosterSource 将在以下情况下显示：

• 在没有设置有效的源时。 例如，未设置 Source ， Source 设置为 Null，或源无效 (如 MediaFailed 事件触发) 。
• 加载媒体时。 例如，设置了有效的源，但 尚未触发 MediaOpened 事件。
• 当媒体流式传输到另一台设备时。
• 当媒体仅限音频时。