WidgetManager.GetWidgetInfo(String) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Windows.Widgets.Providers

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Ottiene un WidgetInfo oggetto contenente informazioni sul widget con l'ID widget specificato, tra cui il modello visivo, il modello di dati, lo stato personalizzato, l'ultima ora di aggiornamento e le informazioni sul contesto dall'host del widget.

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

Parametri

widgetId: String
Platform::String

winrt::hstring

Identificatore univoco del widget per cui vengono recuperate le informazioni.

Restituisce

WidgetInfo

Oggetto WidgetInfo , se l'ID specificato è associato a un widget associato all'app chiamante che non è stata eliminata; in caso contrario, Null.

Implementazioni

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)

Esempio

Nell'esempio seguente viene illustrato il recupero delle informazioni sul widget per uno dei widget di proprietà dell'app chiamante.

/*
* 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;
    }
}

Commenti

Questo metodo può essere usato dai provider di widget durante la gestione di una richiesta associata a un widget non riconosciuto per ripristinare l'ultimo stato noto. Ad esempio, se si archiviano gli stati dei widget nella WidgetUpdateRequestOptions.CustomState proprietà, è possibile usare questo metodo durante l'inizializzazione del provider del widget per rigenerare lo stato dei widget.

Si applica a

Condividi tramite