RadialControllerMenuItem.CreateFromIcon Método

Definição

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.

icon
RandomAccessStreamReference

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

Aplica-se a

Confira também