导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

ImageProperties Class

提供对项的图像相关属性的访问(如文件或文件夹)。

语法


var imageProperties = fileInformation.imageProperties;

特性

[Version(0x06020000)]

成员

ImageProperties类 具有这些类型的成员:

方法

The ImageProperties 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
RetrievePropertiesAsync Retrieves the specified properties associated with the item.
SavePropertiesAsync() Saves all properties associated with the item.
SavePropertiesAsync(IIterable(IKeyValuePair)) Saves the specified properties and values associated with the item.

 

属性

ImageProperties类 具有这些属性。

属性访问类型说明

CameraManufacturer

读/写Gets or sets the manufacturer of the camera that took the photo.

CameraModel

读/写Gets or sets the model of the camera that took the photo.

DateTaken

读/写Gets or sets the date when the image was taken.

Height

只读Gets the height of the image.

Keywords

只读Gets the collection of keywords associated with the image.

Latitude

只读Gets the latitude coordinate where the photo was taken.

Longitude

只读Gets the longitude coordinate where the photo was taken.

Orientation

只读Gets the Exchangeable Image File (EXIF) orientation flag of the photo.

PeopleNames

只读Gets the names of people who are tagged in the photo.

Rating

读/写Gets the rating associated with the image.

Title

读/写Gets or sets the title of the image.

Width

只读Gets the width of the image.

 

备注

如果可用,您可以使用项(如文件或文件夹)的 Properties 属性中的 getImagePropertiesAsync 方法以异步的方式,或使用 ImageProperties 属性以同步的方式访问 ImageProperties 对象。

使用以下任意方法和属性,可以获取 ImageProperties 对象:

注意  使用由另一个应用程序定义的属性处理程序(如 Microsoft Word)获取或设置属性可能不可访问。相反,您可以使用由系统索引返回的文件查询尝试获取这些属性。 有关更多信息,请参见 QueryOptions

有关访问属性的更多代码示例,请参见文件访问示例

示例

此示例演示如何检索某个文件的属性,包括诸如 DateTakenRating 的图像属性。



var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get image properties
    file.properties.getImagePropertiesAsync().done(function (imageProperties) {
        outputDiv.innerHTML += "Date taken: " + imageProperties.dateTaken + "<br />";
        outputDiv.innerHTML += "Rating: " + imageProperties.rating + "<br />";
    },
    // Handle errors with an error function
	   function (error) {
	      // Handle errors encountered while retrieving properties
    });
}

GetImagePropertiesAsync 完成后,imageProperties 将获取 ImageProperties 对象。

在示例中,file 包含在表示文件以检索属性的 StorageFile

要求

最低支持客户端

Windows 8 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 [仅 Windows 应用商店应用程序]

最低支持电话

Windows Phone 8

命名空间

Windows.Storage.FileProperties
Windows::Storage::FileProperties [C++]

元数据

Windows.winmd

另请参见

StorageItemContentProperties.getImagePropertiesAsync method
Windows.Storage.BulkAccess.FileInformation.imageProperties property
Windows.Storage.BulkAccess.FolderInformation.imageProperties property
Windows.Storage.BulkAccess.IStorageItemInformation.ImageProperties property

 

 

显示:
© 2014 Microsoft