RadialControllerMenuItem.CreateFromKnownIcon 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 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.
O ícone do sistema a ser exibido para a ferramenta personalizada.
Retornos
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