RadialControllerMenuItem.CreateFromKnownIcon Metodo

Definizione

Crea uno strumento personalizzato (usando la stringa di testo e l'icona di sistema specificati) nel menu RadialController .

public:
 static RadialControllerMenuItem ^ CreateFromKnownIcon(Platform::String ^ displayText, RadialControllerMenuKnownIcon value);
 static RadialControllerMenuItem CreateFromKnownIcon(winrt::hstring const& displayText, RadialControllerMenuKnownIcon const& value);
public static RadialControllerMenuItem CreateFromKnownIcon(string displayText, RadialControllerMenuKnownIcon value);
function createFromKnownIcon(displayText, value)
Public Shared Function CreateFromKnownIcon (displayText As String, value As RadialControllerMenuKnownIcon) As RadialControllerMenuItem

Parametri

displayText
String

Platform::String

winrt::hstring

Stringa di testo da visualizzare per lo strumento personalizzato.

value
RadialControllerMenuKnownIcon

Icona di sistema da visualizzare per lo strumento personalizzato.

Restituisce

Strumento personalizzato.

Commenti

Le operazioni dei menu RadialController, tra cui CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems e TrySelectDefaultMenuItem, devono essere eseguite nel thread dell'interfaccia utente. In questo modo in un thread di lavoro in background possono causare problemi con gestori eventi nel thread dell'interfaccia utente.

Le linee guida per l'esperienza utente per Surface Dial consigliano quanto segue:

Text

  • I nomi devono essere brevi per entrare nel cerchio centrale del menu selettore circolare
  • I nomi devono identificare chiaramente l'azione primaria (un'azione complementare può essere implicita)
  • Scorri indica l'effetto di entrambe le direzioni di rotazione
  • Annulla specifica un'azione primaria, ma Ripeti (l'azione complementare) è deducibile e facilmente individuabile per l'utente

Si applica a

Vedi anche