WidgetUpdateRequestOptions 类

  • 参考

定义

命名空间:
Microsoft.Windows.Widgets.Providers
编辑

为调用 WidgetManager.UpdateWidget(WidgetUpdateRequestOptions)提供数据。

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 类中未设置的任何变量都不会更新。 例如，如果只对更新小组件的数据感兴趣，但想要保留现有可视模板和自定义状态，则仅 WidgetUpdateRequestOptions.Data 通过设置 属性，将更新小组件的数据，但不会修改模板和自定义状态。

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

构造函数

WidgetUpdateRequestOptions(String)

初始化 WidgetRequestOptions 类的新实例。

属性

CustomState

获取或设置表示关联小组件的自定义状态的字符串。
Data

获取或设置关联小组件的自适应卡片数据模板。
Template

获取或设置关联小组件的自适应卡片视觉模板。
UnsetValue

获取一个 sentinel 值，该值指示未设置关联的属性。
WidgetId

获取要更新的小组件的小组件 ID。

适用于