RadialControllerMenuItem.CreateFromIcon Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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