WidgetUpdateRequestOptions Klasse

Definition

Namespace:
Microsoft.Windows.Widgets.Providers
Bearbeiten

Stellt Daten für Aufrufe von Microsoft.Windows bereit. Widgets.Providers.WidgetManager.UpdateWidget.

public ref class WidgetUpdateRequestOptions sealed
/// [Windows.Foundation.Metadata.Activatable(Microsoft.Windows.Widgets.Providers.IWidgetUpdateRequestOptionsFactory, 65536, "Microsoft.Windows.Widgets.WidgetContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WidgetUpdateRequestOptions final
[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.Windows.Widgets.Providers.IWidgetUpdateRequestOptionsFactory), 65536, "Microsoft.Windows.Widgets.WidgetContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WidgetUpdateRequestOptions
function WidgetUpdateRequestOptions(widgetId)
Public NotInheritable Class WidgetUpdateRequestOptions
Vererbung
Object Platform::Object IInspectable WidgetUpdateRequestOptions
Attribute
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Hinweise

Jede Variable, die nicht in der WidgetUpdateRequestOptions-Klasse festgelegt ist, wird nicht aktualisiert. Wenn Sie beispielsweise nur die Daten des Widgets aktualisieren möchten, aber die vorhandene visuelle Vorlage und den benutzerdefinierten Zustand beibehalten möchten, legen Sie nur die Microsoft.Windows fest. Widgets.Providers.WidgetUpdateRequestOptions.Data-Eigenschaft, die Daten des Widgets werden aktualisiert, aber die Vorlage und der benutzerdefinierte Zustand werden nicht geändert.

UpdateWidget kann auch verwendet werden, um jeden gespeicherten Wert zu löschen, indem eine leere Zeichenfolge für den zu löschenden Wert festgelegt wird. Wenn Sie beispielsweise den gespeicherten benutzerdefinierten Zustand des Widgets löschen möchten, können Sie den Microsoft.Windows festlegen. Widgets.Providers.WidgetUpdateRequestOptions.CustomState-Eigenschaft auf eine leere Zeichenfolge, die den gespeicherten benutzerdefinierten Zustand löscht, sobald UpdateWidget aufgerufen wird.

Konstruktoren

Name Beschreibung
WidgetUpdateRequestOptions(String)

Initialisiert eine neue Instanz der WidgetRequestOptions-Klasse .

Eigenschaften

Name Beschreibung
CustomState

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den benutzerdefinierten Zustand für das zugeordnete Widget darstellt.
Data

Ruft die Datenvorlage für adaptive Karten für das zugeordnete Widget ab oder legt sie fest.
IsPlaceholderContent

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Inhalt der Aktualisierung Platzhalterinhalt ist.
Rank

Dient zum Abrufen oder Festlegen eines Werts, der den Rang des Widgets relativ zu anderen Widgets aus derselben Paketidentität angibt.
Template

Ruft die visuelle Vorlage für adaptive Karten für das zugeordnete Widget ab oder legt sie fest.
UnsetValue

Ruft einen Sentinelwert ab, der angibt, dass die zugeordnete Eigenschaft nicht festgelegt ist.
WidgetId

Ruft die Widget-ID des zu aktualisierenden Widgets ab.

Gilt für: