RadialControllerMenuItem.CreateFromIcon Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.
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