ImageProperties Classe

Definição

Namespace:

Windows.Storage.FileProperties

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 ImageProperties

Public NotInheritable Class ImageProperties

Herança

Object Platform::Object IInspectable ImageProperties

Atributos

ContractVersionAttribute

Implementações

IStorageItemExtraProperties

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.

Confira também

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties