RadialControllerMenuItem.CreateFromKnownIcon Método

Definição

Namespace:

Windows.UI.Input

Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto especificada e o ícone do sistema) no menu RadialController .

public:
 static RadialControllerMenuItem ^ CreateFromKnownIcon(Platform::String ^ displayText, RadialControllerMenuKnownIcon value);

 static RadialControllerMenuItem CreateFromKnownIcon(winrt::hstring const& displayText, RadialControllerMenuKnownIcon const& value);

public static RadialControllerMenuItem CreateFromKnownIcon(string displayText, RadialControllerMenuKnownIcon value);

function createFromKnownIcon(displayText, value)

Public Shared Function CreateFromKnownIcon (displayText As String, value As RadialControllerMenuKnownIcon) As RadialControllerMenuItem

Parâmetros

displayText

String

Platform::String

winrt::hstring

A cadeia de caracteres de texto a ser exibida para a ferramenta personalizada.

value

RadialControllerMenuKnownIcon

O ícone do sistema a ser exibido para a ferramenta personalizada.

Retornos

RadialControllerMenuItem

A ferramenta personalizada.

Comentários

As 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 UX 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

Confira também

• CreateFromIcon(String, RandomAccessStreamReference)
• CreateFromFontGlyph(String, String, String)
• CreateFromFontGlyph(String, String, String, Uri)
• Interações do Surface DialPlataforma Universal do Windows exemplos (C# e C++)
• Exemplo da área de trabalho do Windows