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	取得要更新之小工具的小工具識別碼。