RadialControllerMenuItem.CreateFromIcon Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto especificada e o ícone personalizado) no 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
Parâmetros
- displayText
-
String
Platform::String
winrt::hstring
A cadeia de caracteres de texto a ser exibida para a ferramenta personalizada.
O ícone personalizado a ser exibido para a ferramenta personalizada.
Retornos
A ferramenta personalizada.
Comentários
Operações de menu RadialController, incluindo CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems e TrySelectDefaultMenuItem, devem ser executadas no thread da interface do usuário. Fazer isso em um thread de trabalho em segundo plano pode causar problemas com manipuladores de eventos no thread da interface do usuário.
As diretrizes de experiência do usuário para o Surface Dial recomendam o seguinte:
Texto
- Os nomes devem ser curtos para caber dentro do círculo central do menu de roda de rolagem
- Os nomes devem identificar claramente a ação primária (uma ação complementar pode ser implícita)
- Rolagem indica o efeito de ambas as direções de rotação
- Desfazer especifica uma ação principal, mas Refazer (a ação complementar) pode ser inferido e descoberto facilmente pelo usuário
Ícones
- Fornecer uma imagem PNG de 64 x 64 pixels de alta qualidade (44 x 44 é o menor com suporte)
- Verifique se a tela de fundo é transparente
- O ícone deve preencher a maior parte da imagem
- Um ícone branco deve ter um contorno preto que fique visível no modo de alto contraste