ImageProperties Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к свойствам, связанным с изображением элемента (например, к файлу или папке).
public ref class ImageProperties sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ImageProperties final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ImageProperties
Public NotInheritable Class ImageProperties
- Наследование
- Атрибуты
- Реализации
Требования к Windows
| Требования | Описание |
|---|---|
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
В этом примере показано, как получить свойства файла, включая свойства изображения, такие как DateTaken и Rating.
try
{
StorageFile file = rootPage.sampleFile;
if (file != null)
{
StringBuilder outputText = new StringBuilder();
// Get image properties
ImageProperties imageProperties = await file.Properties.GetImagePropertiesAsync();
outputText.AppendLine("Date taken: " + imageProperties.DateTaken);
outputText.AppendLine("Rating: " + imageProperties.Rating);
}
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
// For example, handle a file not found error
}
После завершения imagePropertiesgetImagePropertiesAsync получает объект ImageProperties.
В этом примере содержит storageFile, представляющий файл, file для которого извлекаются свойства.
Комментарии
Получить доступ к объекту ImageProperties можно асинхронно с помощью метода getImagePropertiesAsync из свойства Properties элемента (например, файла папки) или синхронно с помощью свойства ImageProperties , если оно доступно. Объект ImageProperties можно получить с помощью любого из следующих методов и свойств:
- Метод StorageItemContentProperties.getImagePropertiesAsync , доступ к которому можно получить с помощью свойства Properties , если он доступен.
- Свойство FileInformation.imageProperties
- Свойство FolderInformation.imageProperties
Примечание
Свойства, которые получаются или задаются с помощью обработчика свойств, определенного другим приложением (например, Microsoft Word), могут быть недоступны. Вместо этого можно попытаться получить эти свойства с помощью запроса файла, который поддерживается системным индексом. Дополнительные сведения см. в разделе QueryOptions.
Дополнительные примеры кода о доступе к свойствам см. в разделе Пример доступа к файлам.
Свойства
| Имя | Описание |
|---|---|
| CameraManufacturer |
Возвращает или задает производителя камеры, которая сделала фотографию. |
| CameraModel |
Возвращает или задает модель камеры, которая сделала фотографию. |
| DateTaken |
Возвращает или задает дату создания изображения. |
| Height |
Возвращает высоту изображения. |
| Keywords |
Возвращает коллекцию ключевых слов, связанных с изображением. |
| Latitude |
Возвращает координату широты, в которой была сделана фотография. |
| Longitude |
Возвращает координату долготы, в которой была сделана фотография. |
| Orientation |
Возвращает флаг ориентации exif фотографии. |
| PeopleNames |
Возвращает имена людей, помеченных на фотографии. |
| Rating |
Возвращает или задает оценку, связанную с файлом изображения. |
| Title |
Возвращает или задает заголовок изображения. |
| Width |
Возвращает ширину изображения. |
Методы
| Имя | Описание |
|---|---|
| RetrievePropertiesAsync(IIterable<String>) |
Извлекает указанные свойства, связанные с элементом. |
| SavePropertiesAsync() |
Сохраняет все свойства, связанные с элементом. |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Сохраняет указанные свойства и значения, связанные с элементом. |