IWidgetProvider Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Diese Schnittstelle wird von Windows-Widgetanbietern implementiert, um Rückrufe vom Widgethost für Widgetlebensdauerereignisse zu empfangen.
public interface class IWidgetProvider/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
struct IWidgetProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 65536)]
[Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
public interface IWidgetProviderPublic Interface IWidgetProvider- Attribute
Hinweise
Diese Schnittstelle wird als Out-of-Process-COM-Server implementiert. Die Lebensdauer eines Widgetanbieters ist unabhängig von den Lebensdauern seiner Widgets. ein Widgetanbieter kann jederzeit vom widgetm anager aktiviert und freigegeben werden. Mehrere Anbieter für dieselbe Anbieter-App werden in einem freigegebenen Prozess ausgeführt. Anbieter aus verschiedenen Anbieter-Apps werden in separaten Prozessen ausgeführt.
Objekte, die an die Rückrufmethoden der IWidgetProvider-Schnittstelle übergeben werden, sind nur innerhalb des Rückrufs gültig. Sie sollten keine Verweise auf diese Objekte speichern, da ihr Verhalten außerhalb des Kontexts des Rückrufs nicht definiert ist.
Eine Übersicht über Windows-Widgets finden Sie unter Übersicht über Widgets. Informationen zum Entwickeln eines Widgetanbieters finden Sie unter Widgetdienstanbieter.
Methoden
| Activate(WidgetContext) |
Benachrichtigt den Widgetanbieter, dass der Widgethost derzeit daran interessiert ist, aktualisierte Inhalte vom Anbieter zu erhalten. |
| CreateWidget(WidgetContext) |
Benachrichtigt den Widgetanbieter, dass ein neues Widget erstellt wurde, z. B. wenn ein Benutzer einem Widgethost ein Widget hinzufügt. |
| Deactivate(String) |
Benachrichtigt den Widgetanbieter, dass der Widgethost nicht mehr aktiv aktualisierte Inhalte vom Anbieter anfordert. |
| DeleteWidget(String, String) |
Benachrichtigt den Widgetanbieter, dass eines der unterstützten Widgets gelöscht wurde, z. B. wenn ein Benutzer ein Widget aus einem Widgethost entfernt. |
| OnActionInvoked(WidgetActionInvokedArgs) |
Wird aufgerufen, wenn eine Aktion für ein Widget aufgerufen wird, z. B. wenn der Benutzer auf eine Schaltfläche klickt. |
| OnWidgetContextChanged(WidgetContextChangedArgs) |
Wird aufgerufen, wenn sich die Konfiguration des Widgets innerhalb des Widgethosts ändert. |