BitmapProperties.SetPropertiesAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt asynchron eine oder mehrere Bitmapeigenschaften fest.
public:
virtual IAsyncAction ^ SetPropertiesAsync(IIterable<IKeyValuePair<Platform::String ^, BitmapTypedValue ^> ^> ^ propertiesToSet) = SetPropertiesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction SetPropertiesAsync(IIterable<IKeyValuePair<winrt::hstring, BitmapTypedValue const&>> const& propertiesToSet);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction SetPropertiesAsync(IEnumerable<KeyValuePair<string,BitmapTypedValue>> propertiesToSet);function setPropertiesAsync(propertiesToSet)Public Function SetPropertiesAsync (propertiesToSet As IEnumerable(Of KeyValuePair(Of String, BitmapTypedValue))) As IAsyncActionParameter
- propertiesToSet
-
IIterable<IKeyValuePair<Platform::String,BitmapTypedValue>>
IIterable<IKeyValuePair<winrt::hstring,BitmapTypedValue>>
Eine Auflistung von Schlüssel-Wert-Paaren, die die festzulegenden Bitmapeigenschaften darstellen. Jeder Schlüssel ist eine Zeichenfolge, die die Windows-Eigenschaft oder Metadatenabfrage enthält, und der entsprechende Wert ist ein BitmapTypedValue mit den Daten und dem richtigen PropertyType.
Gibt zurück
Objekt, das die Einstellung der Bitmapeigenschaften asynchron verwaltet.
- Attribute
Hinweise
Verwenden Sie ein BitmapPropertySet , um Metadatenelemente zu speichern, die Sie für den Encoder festlegen möchten. Jedes Metadatenelement ist ein Schlüssel-Wert-Paar.
Der Schlüssel ist eine Zeichenfolge, die das festzulegende Metadatenelement identifiziert. BitmapEncoder akzeptiert einige Windows-Eigenschaften sowie Abfragen, die mit der WIC-Metadatenabfragesprache erstellt wurden. Eine Liste der unterstützten Windows-Eigenschaften finden Sie unter Unterstützte Windows-Eigenschaften. Eine Zusammenfassung der unterstützten WIC-Metadatenabfragen finden Sie im Thema Metadatenabfragen für natives WIC-Bildformat .
Der Wert ist ein BitmapTypedValue , mit dem Sie den tatsächlichen Metadatenwert einem expliziten Datentyp (Windows.Foundation.PropertyType) zuordnen können.
Jedes Bildformat hat bestimmte Anforderungen an den Typ jeder Bitmapeigenschaft, und Sie müssen sicherstellen, dass das Feld Typ jedes BitmapTypedValue für die ausgewählte Eigenschaft ordnungsgemäß festgelegt ist. Beispielsweise wird die Windows-Eigenschaft System.Photo.Orientation in der Datei als UInt16 gespeichert, und daher muss das Feld Typ auf UInt16 festgelegt werden. Weitere Informationen zu Windows-Eigenschaftentypen finden Sie unter Richtlinien für Fotometadaten. Weitere Informationen zu Metadatenabfragetypen der Windows-Imageerstellungskomponente finden Sie unter Metadatenabfragen im nativen Bildformat.