WidgetManager.GetWidgetInfo(String) 메서드

정의

네임스페이스:

Microsoft.Windows.Widgets.Providers

시각적 템플릿, 데이터 템플릿, 사용자 지정 상태, 마지막 업데이트 시간 및 위젯 호스트의 컨텍스트 정보를 포함하여 제공된 위젯 ID를 사용하여 위젯에 대한 정보를 포함하는 WidgetInfo 개체를 가져옵니다.

public:
 virtual WidgetInfo ^ GetWidgetInfo(Platform::String ^ widgetId) = GetWidgetInfo;

WidgetInfo GetWidgetInfo(winrt::hstring const& widgetId);

public WidgetInfo GetWidgetInfo(string widgetId);

function getWidgetInfo(widgetId)

Public Function GetWidgetInfo (widgetId As String) As WidgetInfo

매개 변수

widgetId

String

Platform::String

winrt::hstring

정보를 검색할 위젯의 고유 식별자입니다.

반환

WidgetInfo

지정된 ID가 삭제되지 않은 호출 앱과 연결된 위젯과 연결된 경우 WidgetInfo 개체입니다. 그렇지 않으면 null입니다.

구현

M:Microsoft.Windows.Widgets.Providers.IWidgetManager.GetWidgetInfo(System.String) M:Microsoft.Windows.Widgets.Providers.IWidgetManager.GetWidgetInfo(Platform::String) M:Microsoft.Windows.Widgets.Providers.IWidgetManager.GetWidgetInfo(winrt::hstring)

예제

다음 예제에서는 호출 앱이 소유한 위젯 중 하나에 대한 위젯 정보를 검색하는 방법을 보여 줍니다.

/*
* Sample output:
* Id: {5E3D9EDF-13A6-4185-902B-5997AE0411A5}
* Template: {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5"
    "body": [
        {
            "type": "TextBlock",
            "text": "${greeting}!"
        }
    ]
}
* Data: {"count": "3"}
* CustomState: 3
* DefinitionName: clickCounter
*/
using namespace std;
using namespace winrt;
using namespace Microsoft::Windows::Widgets::Providers;

class WidgetManagerOperations
{
    void PrintInfoOfWidget(hstring myWidgetId)
    {
        WidgetManager widgetManager = WidgetManager::GetDefault();

        WidgetInfo widgetInfo = widgetManager.GetWidgetInfo(myWidgetId);
        wcout << L"Id - " << L": " << widgetInfo.WidgetContext().Id().c_str() << endl;
        wcout << L"Template: " << widgetInfo.Template().c_str() << endl;
        wcout << L"Data: " << widgetInfo.Data().c_str() << endl;
        wcout << L"CustomState: " << widgetInfo.CustomState().c_str() << endl;
        wcout << L"DefinitionName: " << widgetInfo.WidgetContext().DefinitionName().c_str() << endl;
    }
}

설명

이 메서드는 마지막으로 알려진 상태를 복구하기 위해 인식할 수 없는 위젯과 연결된 요청을 처리할 때 위젯 공급자가 사용할 수 있습니다. 예를 들어 위젯의 상태를 microsoft.Windows.Widgets.Providers.WidgetUpdateRequestOptions.CustomState 속성 저장하는 경우 위젯 공급자를 초기화하는 동안 이 메서드를 사용하여 위젯의 상태를 다시 생성할 수 있습니다.