DeviceThumbnail 类

定义

命名空间:

Windows.Devices.Enumeration

表示设备的缩略图图像。

public ref class DeviceThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DeviceThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DeviceThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class DeviceThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

继承

Object Platform::Object IInspectable DeviceThumbnail

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

// Takes a parameter of type DeviceInformation
// and retrieves a DeviceThumbnail to pass to displayImage().
function getImage (device) {   

    var thumbnail = null;
    if (device){
        device.getThumbnailAsync().then(
            function (thumbnail) {
                if (thumbnail){      
                    if (thumbnail.size > 0) {
                        displayImage(thumbnail);
                    }                                                                      
                 }     
             });
    }                                                                                     
}

function displayImage(imageFile) {

    try {
        // Setting 2nd parameter to 'false' cleans up 
        // the URL after first use.
        // We set this because we only need to load the URL
        // into the image tag once.
        document.getElementById("deviceImage").src = 
            window.URL.createObjectURL(imageFile, false);
    } catch (e) {
        document.getElementById("statusMessage").innerHTML = 
            "Could not display image, error: " + e.message;
    }

}

注解

调用 DeviceInformation.GetThumbnailAsync 并处理完成事件，如示例中所示。

属性

CanRead	获取一个值，该值指示是否可以从中读取流。
CanWrite	获取一个值，该值指示流是否可以写入。
ContentType	返回缩略图图像的内容类型。
Position	获取流的字节偏移量。
Size	获取或设置设备缩略图的大小。

方法

CloneStream()	通过与当前流相同的资源创建 IRandomAccessStream 的新实例。
Close()	关闭当前流并释放系统资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FlushAsync()	在顺序流中异步刷新数据。
GetInputStreamAt(UInt64)	返回指向从指定位置开始的输入流的指针。
GetOutputStreamAt(UInt64)	返回指向从指定位置开始的输出流的指针。
ReadAsync(IBuffer, UInt32, InputStreamOptions)	返回异步字节读取器对象。
Seek(UInt64)	将流的位置设置为指定的值。
WriteAsync(IBuffer)	在顺序流中异步写入数据。