ImageProperties Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce l'accesso alle proprietà correlate all'immagine di un elemento , ad esempio un file o una cartella.
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
- Ereditarietà
- Attributi
- Implementazioni
Requisiti Windows
Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Esempio
In questo esempio viene illustrato come recuperare le proprietà di un file, incluse le proprietà dell'immagine, ad esempio DateTaken e 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
}
Al termine di GetImagePropertiesAsync , imageProperties
ottiene un oggetto ImageProperties.
Nell'esempio contiene file
un oggetto StorageFile che rappresenta il file per il quale recuperare le proprietà.
Commenti
È possibile accedere a un oggetto ImageProperties in modo asincrono usando il metodo getImagePropertiesAsync dalla proprietà Properties di un elemento (ad esempio un file di cartella) o in modo sincrono usando la proprietà ImageProperties , se disponibile. È possibile ottenere un oggetto ImageProperties usando uno dei metodi e delle proprietà seguenti:
- Metodo StorageItemContentProperties.getImagePropertiesAsync a cui è possibile accedere tramite la proprietà Properties , se disponibile.
- Proprietà FileInformation.imageProperties
- Proprietà FolderInformation.imageProperties
Nota
Le proprietà che vengono recuperate o impostate usando un gestore di proprietà definito da un'altra app (ad esempio Microsoft Word) potrebbero non essere accessibili. È invece possibile provare a ottenere queste proprietà usando una query di file supportata dall'indice di sistema. Per altre informazioni, vedere QueryOptions.
Per altri esempi di codice sull'accesso alle proprietà, vedere l'esempio di accesso ai file.
Proprietà
CameraManufacturer |
Ottiene o imposta il produttore della fotocamera che ha preso la foto. |
CameraModel |
Ottiene o imposta il modello della fotocamera che ha scattato la foto. |
DateTaken |
Ottiene o imposta la data in cui è stata acquisita l'immagine. |
Height |
Ottiene l'altezza dell'immagine. |
Keywords |
Ottiene la raccolta di parole chiave associate all'immagine. |
Latitude |
Ottiene la coordinata della latitudine in cui è stata scattata la foto. |
Longitude |
Ottiene la coordinata di longitudine in cui è stata scattata la foto. |
Orientation |
Ottiene il flag di orientamento EXIF (Exchangeable Image File) della foto. |
PeopleNames |
Ottiene i nomi delle persone contrassegnate nella foto. |
Rating |
Ottiene o imposta la classificazione associata a un file di immagine. |
Title |
Ottiene o imposta il titolo dell'immagine. |
Width |
Ottiene la larghezza dell'immagine. |
Metodi
RetrievePropertiesAsync(IIterable<String>) |
Recupera le proprietà specificate associate all'elemento. |
SavePropertiesAsync() |
Salva tutte le proprietà associate all'elemento. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Salva le proprietà e i valori specificati associati all'elemento. |