RadialControllerMenuItem.CreateFromIcon Metodo

Definizione

Crea uno strumento personalizzato (utilizzando la stringa di testo specificata e l'icona personalizzata) nel menu RadialController .

public:
 static RadialControllerMenuItem ^ CreateFromIcon(Platform::String ^ displayText, RandomAccessStreamReference ^ icon);
 static RadialControllerMenuItem CreateFromIcon(winrt::hstring const& displayText, RandomAccessStreamReference const& icon);
public static RadialControllerMenuItem CreateFromIcon(string displayText, RandomAccessStreamReference icon);
function createFromIcon(displayText, icon)
Public Shared Function CreateFromIcon (displayText As String, icon As RandomAccessStreamReference) As RadialControllerMenuItem

Parametri

displayText
String

Platform::String

winrt::hstring

Stringa di testo da visualizzare per lo strumento personalizzato.

icon
RandomAccessStreamReference

Icona personalizzata da visualizzare per lo strumento personalizzato.

Restituisce

Strumento personalizzato.

Commenti

Le operazioni del 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 verificarsi problemi con i 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

Icone

  • Usa un'immagine PNG di alta qualità da 64 x 64 pixel (44 x 44 è la dimensione minima supportata)
  • Verifica che lo sfondo sia trasparente
  • L'icona deve occupare la maggior parte dell'immagine
  • Un'icona bianca deve avere un contorno nero per essere visibile in modalità a contrasto elevato

Si applica a

Vedi anche