ImageProperties クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アイテムのイメージ関連のプロパティ (ファイルやフォルダーなど) へのアクセスを提供します。
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
}
GetImagePropertiesAsync が完了したら、 imageProperties
ImageProperties オブジェクトを取得します。
この例では、 file
には、プロパティを取得するファイルを表す StorageFile が含まれています。
注釈
ImageProperties オブジェクトに非同期的にアクセスするには、アイテムの Properties プロパティ (フォルダーのファイルなど) から getImagePropertiesAsync メソッドを使用するか、ImageProperties プロパティが使用可能な場合は同期的に使用します。 ImageProperties オブジェクトは、次のいずれかのメソッドとプロパティを使用して取得できます。
- StorageItemContentProperties.getImagePropertiesAsync メソッド。 Properties プロパティ (使用可能な場合) を使用してアクセスできます。
- FileInformation.imageProperties プロパティ
- FolderInformation.imageProperties プロパティ
注意
別のアプリ (Microsoft Word など) によって定義されたプロパティ ハンドラーを使用して取得または設定されたプロパティにアクセスできない場合があります。 代わりに、システム インデックスによってサポートされるファイル クエリを使用して、これらのプロパティを取得できます。 詳細については、「 QueryOptions」を参照してください。
プロパティへのアクセスに関するコード サンプルの詳細については、 ファイル アクセスのサンプルを参照してください。
プロパティ
CameraManufacturer |
写真を撮影したカメラの製造元を取得または設定します。 |
CameraModel |
写真を撮影したカメラのモデルを取得または設定します。 |
DateTaken |
イメージが取得された日付を取得または設定します。 |
Height |
イメージの高さを取得します。 |
Keywords |
イメージに関連付けられているキーワードのコレクションを取得します。 |
Latitude |
写真が撮影された緯度座標を取得します。 |
Longitude |
写真が撮影された経度座標を取得します。 |
Orientation |
写真の Exchangeable Image File (EXIF) 方向フラグを取得します。 |
PeopleNames |
写真にタグ付けされているユーザーの名前を取得します。 |
Rating |
イメージ ファイルに関連付けられている評価を取得または設定します。 |
Title |
イメージのタイトルを取得または設定します。 |
Width |
イメージの幅を取得します。 |
メソッド
RetrievePropertiesAsync(IIterable<String>) |
アイテムに関連付けられている指定したプロパティを取得します。 |
SavePropertiesAsync() |
アイテムに関連付けられているすべてのプロパティを保存します。 |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
アイテムに関連付けられている指定したプロパティと値を保存します。 |