RadialControllerMenuItem.CreateFromIcon Método

Definición

Crea una herramienta personalizada (con la cadena de texto y el icono personalizado especificados) en el menú 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

Parámetros

displayText
String

Platform::String

winrt::hstring

Cadena de texto que se va a mostrar para la herramienta personalizada.

icon
RandomAccessStreamReference

Icono personalizado que se va a mostrar para la herramienta personalizada.

Devoluciones

La herramienta personalizada.

Comentarios

Las operaciones de menú RadialController, incluidas CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems y TrySelectDefaultMenuItem, deben realizarse en el subproceso de la interfaz de usuario. Si lo hace en un subproceso de trabajo en segundo plano, puede causar problemas con los controladores de eventos en el subproceso de interfaz de usuario.

Las directrices de experiencia del usuario para Surface Dial recomiendan lo siguiente:

Text

  • Los nombres deben ser cortos para que quepan dentro del círculo central del menú de rueda.
  • Los nombres deben identificar claramente la acción principal (se puede implicar una acción complementaria).
  • El desplazamiento indica el efecto de ambas direcciones de rotación
  • La acción de deshacer especifica una acción principal, sin embargo rehacer (la acción complementaria) se puede inferir y el usuario puede descubrirla fácilmente

Iconos

  • Proporcionar una imagen PNG de alta calidad de 64 x 64 píxeles (44 x 44 es el tamaño más pequeño admitido)
  • Asegurarse de que el fondo sea transparente
  • El icono debería llenar la mayor parte de la imagen
  • Un icono en blanco debe tener un contorno negro para que sea visible en el modo de contraste alto

Se aplica a

Consulte también