radialcontrollermenuitem_createfromfontglyph_63723173.md

-api-id	-api-type
M:Windows.UI.Input.RadialControllerMenuItem.CreateFromFontGlyph(System.String,System.String,System.String)	winrt method

Windows.UI.Input.RadialControllerMenuItem.CreateFromFontGlyph

-description

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

-parameters

-param displayText

The text string to display for the custom tool.

-param glyph

The font glyph to display for the custom tool.

-param fontFamily

The font family that contains the glyph to display for the custom tool.

-returns

The custom tool.

-remarks

Use this method overload when you referencing a font already installed on the system. Otherwise, use CreateFromFontGlyph(String displayText, String glyph, String fontFamily, Uri fontUri).

RadialController menu operations, including CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems, and TrySelectDefaultMenuItem, should be performed on the UI thread. Doing so in a background worker thread can cause issues with event handlers on the UI thread.

UX guidelines for the Surface Dial recommend the following:

• Text
  • Names should be short to fit inside the central circle of the wheel menu
  • Names should clearly identify the primary action (a complementary action can be implied)
  • Scroll indicates the effect of both rotation directions
  • Undo specifies a primary action, but redo (the complementary action) can be inferred and easily discovered by the user

-see-also

CreateFromFontGlyph(String displayText, String glyph, String fontFamily, Uri fontUri), CreateFromIcon, CreateFromKnownIcon, Surface Dial interactions, Universal Windows Platform samples (C# and C++), Windows desktop sample

-examples