BitmapPropertiesView.GetPropertiesAsync(IIterable<String>) Método

Definición

Espacio de nombres:

Windows.Graphics.Imaging

Recupera de forma asincrónica una o varias propiedades de mapa de bits.

public:
 virtual IAsyncOperation<BitmapPropertySet ^> ^ GetPropertiesAsync(IIterable<Platform::String ^> ^ propertiesToRetrieve) = GetPropertiesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<BitmapPropertySet> GetPropertiesAsync(IIterable<winrt::hstring> const& propertiesToRetrieve);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<BitmapPropertySet> GetPropertiesAsync(IEnumerable<string> propertiesToRetrieve);

function getPropertiesAsync(propertiesToRetrieve)

Public Function GetPropertiesAsync (propertiesToRetrieve As IEnumerable(Of String)) As IAsyncOperation(Of BitmapPropertySet)

Parámetros

propertiesToRetrieve

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Colección de cadenas que representan las claves de propiedad o las consultas que se solicitan. Entre las cadenas válidas se incluyen las propiedades de Windows y las consultas de metadatos del componente de creación de imágenes de Windows.

Devoluciones

IAsyncOperation<BitmapPropertySet>

Objeto que administra la recuperación asincrónica de las propiedades del mapa de bits.

Implementaciones

M:Windows.Graphics.Imaging.IBitmapPropertiesView.GetPropertiesAsync(System.Collections.Generic.IEnumerable{System.String}) M:Windows.Graphics.Imaging.IBitmapPropertiesView.GetPropertiesAsync(System.Collections.Generic.IEnumerable{Platform::String}) M:Windows.Graphics.Imaging.IBitmapPropertiesView.GetPropertiesAsync(System.Collections.Generic.IEnumerable{winrt::hstring})

Atributos

RemoteAsyncAttribute

Comentarios

La operación asincrónica genera una colección que representa las claves de propiedad de imagen solicitadas y sus valores. Los valores se almacenan como BitmapTypedValue, que contiene los datos reales, así como el PropertyType de los datos.

Una imagen determinada solo puede contener algunas (o ninguna) de las propiedades solicitadas. En este caso, la colección solo tendrá pares clave-valor para las propiedades que se encontraron en la imagen. Debe comprobar la existencia de la propiedad antes de intentar obtener datos de ella:

bitmapPropertiesView.getPropertiesAsync(["System.Title"]).done(function (retrievedProperties) {
  if (retrievedProperties.hasKey("System.Title")) {
	  	var titleProperty = retrievedProperties.lookup("System.Title");
	  	var title = titleProperty.value;
	 }
});

Consulta de un bloque de metadatos

Si usa el lenguaje de consulta de metadatos para solicitar un bloque de metadatos en lugar de una propiedad, el valor devuelto es bitmapPropertiesView que representa los metadatos de ese bloque. Puede solicitar los metadatos contenidos en el bloque desde BitmapPropertiesView:

// this is equivalent to directly requesting "/app1/ifd/{ushort=274}" from bitmapPropertiesView
bitmapPropertiesView.getPropertiesAsync(["/app1/ifd"]).done(function (retrievedProperties) {
	  // var ifdBlock is a BitmapPropertiesView
	  var ifdBlock = retrievedProperties.lookup("/app1/ifd").value;
	  return ifdBlock.getPropertiesAsync(["/{ushort=274}");
}).then(function (retrievedProperties) {
	  var orientation = retrievedProperties.lookup("/{ushort=274}").value;
});

Enumerar todos los metadatos dentro de un marco

Puede solicitar todo el contenido de un bloque de metadatos, incluidos los sub bloques y propiedades, pasando una colección vacía (longitud cero) de cadenas. Esto genera una colección que contiene todos los sub bloques y propiedades dentro del ámbito de BitmapPropertiesView . De este modo, puede recuperar iterativamente todos los metadatos contenidos en un marco de imagen.

bitmapPropertiesView.getPropertiesAsync([]).done(function (retrievedProperties) {
	  var iterator = retrievedProps.first();
	  while (iterator.hasCurrent) {
		  // iterator.current gives a key-value pair of string, BitmapTypedValue
		  // nextMetadataBlock is a BitmapPropertiesView containing the sub-block
		  var nextMetadataBlock = iterator.current.value.value;
		  iterator.moveNext();
	}
});

Si el formato de imagen no admite metadatos, se producirá un error en la WINCODEC_ERR_UNSUPPORTEDOPERATION HRESULT.

Consulte también

• BitmapPropertySet
• BitmapTypedValue