Share via

RadialControllerMenuItem Class


Represents a single custom tool from the RadialController menu.

public ref class RadialControllerMenuItem sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RadialControllerMenuItem final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public sealed class RadialControllerMenuItem
Public NotInheritable Class RadialControllerMenuItem
Object Platform::Object IInspectable RadialControllerMenuItem

Windows requirements

Device family
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v3.0)


In this example, we add a custom tool (Sample) with a standard icon to the Surface Dial menu.

  1. First, we get a reference to the RadialController object for the Surface Dial (myController) by calling CreateForCurrentView.
  2. We then create an instance of a RadialControllerMenuItem (myItem) by calling RadialControllerMenuItem.CreateFromIcon.
  3. Finally, we append that item to the collection of menu items.
public sealed partial class MainPage : Page
     RadialController myController;

     public MainPage()
         // Create a reference to the RadialController.
         myController = RadialController.CreateForCurrentView();

         // Create an icon for the custom tool.
         RandomAccessStreamReference icon =
             new Uri("ms-appx:///Assets/StoreLogo.png"));

         // Create a menu item for the custom tool.
         RadialControllerMenuItem myItem =
           RadialControllerMenuItem.CreateFromIcon("Sample", icon);

         // Add the custom tool to the RadialController menu.

         // Declare input handlers for the RadialController.
         myController.ButtonClicked += MyController_ButtonClicked;
         myController.RotationChanged += MyController_RotationChanged;


Version history

Windows version SDK version Value added
1703 15063 CreateFromFontGlyph(String,String,String)
1703 15063 CreateFromFontGlyph(String,String,String,Uri)



Gets the text string of the custom tool on the RadialController menu.


Gets or sets an object used to identify custom tools on the RadialController menu.


CreateFromFontGlyph(String, String, String)

Creates a custom tool (using the specified text string and font glyph) on the RadialController menu.

CreateFromFontGlyph(String, String, String, Uri)

Creates a custom tool (using the specified text string and font glyph) on the RadialController menu.

CreateFromIcon(String, RandomAccessStreamReference)

Creates a custom tool (using the specified text string and custom icon) on the RadialController menu.

CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)

Creates a custom tool (using the specified text string and system icon) on the RadialController menu.



Occurs when a custom tool is selected from the RadialController menu.

Applies to

See also