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 클래스의 새 instance 초기화합니다.

속성

CustomState	연결된 위젯의 사용자 지정 상태를 나타내는 문자열을 가져오거나 설정합니다.
Data	연결된 위젯에 대한 적응형 카드 데이터 템플릿을 가져오거나 설정합니다.
Template	연결된 위젯에 대한 적응형 카드 시각적 개체 템플릿을 가져오거나 설정합니다.
UnsetValue	연결된 속성이 설정되지 않았음을 나타내는 sentinel 값을 가져옵니다.
WidgetId	업데이트할 위젯의 위젯 ID를 가져옵니다.