ImageProperties Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso às propriedades relacionadas à imagem de um item (como um arquivo ou pasta).
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 ImagePropertiesPublic NotInheritable Class ImageProperties- Herança
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
Este exemplo demonstra como recuperar propriedades de um arquivo, incluindo propriedades de imagem como 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
}
Após a conclusão de GetImagePropertiesAsync , imageProperties obtém um objeto ImageProperties.
No exemplo, file contém um StorageFile que representa o arquivo para o qual recuperar as propriedades.
Comentários
Você pode acessar um objeto ImageProperties de forma assíncrona usando o método getImagePropertiesAsync da propriedade Properties de um item (como um arquivo de pasta) ou de forma síncrona usando a propriedade ImageProperties se ela estiver disponível. Você pode obter um objeto ImageProperties usando qualquer um dos seguintes métodos e propriedades:
- Método StorageItemContentProperties.getImagePropertiesAsync , que pode ser acessado usando a propriedade Properties , se estiver disponível.
- Propriedade FileInformation.imageProperties
- Propriedade FolderInformation.imageProperties
Observação
As propriedades que são get ou set usando um manipulador de propriedades definido por outro aplicativo (como o Microsoft Word) podem não estar acessíveis. Em vez disso, você pode tentar obter essas propriedades usando uma consulta de arquivo que é apoiada pelo índice do sistema. Para obter mais informações, consulte QueryOptions.
Para obter mais exemplos de código sobre como acessar propriedades, consulte o Exemplo de acesso a arquivos.
Propriedades
| CameraManufacturer |
Obtém ou define o fabricante da câmera que tirou a foto. |
| CameraModel |
Obtém ou define o modelo da câmera que tirou a foto. |
| DateTaken |
Obtém ou define a data em que a imagem foi tirada. |
| Height |
Obtém a altura da imagem. |
| Keywords |
Obtém a coleção de palavras-chave associadas à imagem. |
| Latitude |
Obtém a coordenada de latitude em que a foto foi tirada. |
| Longitude |
Obtém a coordenada de longitude em que a foto foi tirada. |
| Orientation |
Obtém o sinalizador de orientação EXIF (Arquivo de Imagem Trocáveis) da foto. |
| PeopleNames |
Obtém os nomes das pessoas que estão marcadas na foto. |
| Rating |
Obtém ou define a classificação associada a um arquivo de imagem. |
| Title |
Obtém ou define o título da imagem. |
| Width |
Obtém a largura da imagem. |
Métodos
| RetrievePropertiesAsync(IIterable<String>) |
Recupera as propriedades especificadas associadas ao item. |
| SavePropertiesAsync() |
Salva todas as propriedades associadas ao item. |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Salva as propriedades e os valores especificados associados ao item. |