WidgetManager.GetWidgetInfo(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un WidgetInfo objeto que contiene información sobre el widget con el identificador de widget proporcionado, incluida la plantilla visual, la plantilla de datos, el estado personalizado, la hora de la última actualización y la información de contexto del 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
Parámetros
- widgetId
-
String
Platform::String
winrt::hstring
Identificador único del widget para el que se recupera información.
Devoluciones
Un objeto WidgetInfo , si el identificador especificado está asociado a un widget asociado a la aplicación que realiza la llamada que no se ha eliminado; de lo contrario, null.
Implementaciones
Ejemplos
En el ejemplo siguiente se muestra cómo recuperar información del widget para uno de los widgets que pertenecen a la aplicación que realiza la llamada.
/*
* 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;
}
}
Comentarios
Los proveedores de widgets pueden usar este método al controlar una solicitud asociada a un widget no reconocido para recuperar el último estado conocido. Por ejemplo, si almacena los estados de los widgets en la WidgetUpdateRequestOptions.CustomState propiedad , puede usar este método durante la inicialización del proveedor del widget para volver a generar el estado de los widgets.
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de