IWidgetProvider2.OnCustomizationRequested Method

Reference

Definition

Namespace:: Microsoft.Windows.Widgets.Providers

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Raised when the user has requested widget customization through the widget host UI.

public:
 void OnCustomizationRequested(WidgetCustomizationRequestedArgs ^ customizationRequestedArgs);

void OnCustomizationRequested(WidgetCustomizationRequestedArgs const& customizationRequestedArgs);

public void OnCustomizationRequested(WidgetCustomizationRequestedArgs customizationRequestedArgs);

function onCustomizationRequested(customizationRequestedArgs)

Public Sub OnCustomizationRequested (customizationRequestedArgs As WidgetCustomizationRequestedArgs)

Parameters

customizationRequestedArgs: WidgetCustomizationRequestedArgs

A WidgetCustomizationRequestedArgs object providing access to the widget context and custom state.

Remarks

To receive this event, you must set the IsCustomizable attribute to "true" in the Definition element for your widget in your widget provider app's package manifest file. For more information, see Widget provider package manifest XML format.

For an end-to-end walkthrough of creating a widget provider app, including customization, see Implement a widget provider in a C# Windows App or Implement a widget provider in a win32 app (C++/WinRT).

Note

There is a known bug with the Windows Widget Board, for widgets built using the Windows App SDK, that causes the ellipsis menu to become unresponsive after the customization card is shown.

Applies to