WidgetUpdateRequestOptions 类

定义

命名空间:

Microsoft.Windows.Widgets.Providers

为调用 Microsoft.Windows.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

继承

Object Platform::Object IInspectable WidgetUpdateRequestOptions

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注解

不会更新 WidgetUpdateRequestOptions 类中未设置的任何变量。 例如，如果只对更新小组件的数据感兴趣，但想要保留现有视觉模板和自定义状态，则仅设置 Microsoft.Windows.Widgets.Providers.WidgetUpdateRequestOptions.Data 属性，则会更新小组件的数据，但模板和自定义状态不会修改。

UpdateWidget 还可以通过设置要清除的值的空字符串来清除任何存储的值。 例如，如果要清除小组件的存储自定义状态，可以将 Microsoft.Windows.Widgets.Providers.WidgetUpdateRequestOptions.CustomState 属性设置为空字符串，这将在调用 UpdateWidget 后清除存储的自定义状态。

构造函数

WidgetUpdateRequestOptions(String)

初始化 WidgetRequestOptions 类的新实例。

属性

CustomState	获取或设置表示关联小组件的自定义状态的字符串。
Data	获取或设置关联小组件的自适应卡片数据模板。
Template	获取或设置关联小组件的自适应卡片视觉模板。
UnsetValue	获取一个 sentinel 值，该值指示关联的属性未设置。
WidgetId	获取要更新的小组件的小组件 ID。