Compartilhar via


RadialControllerMenuItem.CreateFromFontGlyph Método

Definição

Sobrecargas

CreateFromFontGlyph(String, String, String)

Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto e o glifo de fonte especificados) no menu RadialController .

CreateFromFontGlyph(String, String, String, Uri)

Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto e o glifo de fonte especificados) no menu RadialController .

CreateFromFontGlyph(String, String, String)

Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto e o glifo de fonte especificados) no menu RadialController .

public:
 static RadialControllerMenuItem ^ CreateFromFontGlyph(Platform::String ^ displayText, Platform::String ^ glyph, Platform::String ^ fontFamily);
/// [Windows.Foundation.Metadata.Overload("CreateFromFontGlyph")]
 static RadialControllerMenuItem CreateFromFontGlyph(winrt::hstring const& displayText, winrt::hstring const& glyph, winrt::hstring const& fontFamily);
[Windows.Foundation.Metadata.Overload("CreateFromFontGlyph")]
public static RadialControllerMenuItem CreateFromFontGlyph(string displayText, string glyph, string fontFamily);
function createFromFontGlyph(displayText, glyph, fontFamily)
Public Shared Function CreateFromFontGlyph (displayText As String, glyph As String, fontFamily As String) As RadialControllerMenuItem

Parâmetros

displayText
String

Platform::String

winrt::hstring

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

glyph
String

Platform::String

winrt::hstring

O glifo de fonte a ser exibido para a ferramenta personalizada.

fontFamily
String

Platform::String

winrt::hstring

A família de fontes que contém o glifo a ser exibido para a ferramenta personalizada.

Retornos

A ferramenta personalizada.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Use essa sobrecarga de método ao referenciar uma fonte já instalada no sistema. Caso contrário, use CreateFromFontGlyph(String displayText, String gliph, String fontFamily, Uri fontUri).

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

Aplica-se a

CreateFromFontGlyph(String, String, String, Uri)

Cria uma ferramenta personalizada (usando a cadeia de caracteres de texto e o glifo de fonte especificados) no menu RadialController .

public:
 static RadialControllerMenuItem ^ CreateFromFontGlyph(Platform::String ^ displayText, Platform::String ^ glyph, Platform::String ^ fontFamily, Uri ^ fontUri);
/// [Windows.Foundation.Metadata.Overload("CreateFromFontGlyphWithUri")]
 static RadialControllerMenuItem CreateFromFontGlyph(winrt::hstring const& displayText, winrt::hstring const& glyph, winrt::hstring const& fontFamily, Uri const& fontUri);
[Windows.Foundation.Metadata.Overload("CreateFromFontGlyphWithUri")]
public static RadialControllerMenuItem CreateFromFontGlyph(string displayText, string glyph, string fontFamily, System.Uri fontUri);
function createFromFontGlyph(displayText, glyph, fontFamily, fontUri)
Public Shared Function CreateFromFontGlyph (displayText As String, glyph As String, fontFamily As String, fontUri As Uri) As RadialControllerMenuItem

Parâmetros

displayText
String

Platform::String

winrt::hstring

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

glyph
String

Platform::String

winrt::hstring

O glifo de fonte a ser exibido para a ferramenta personalizada.

fontFamily
String

Platform::String

winrt::hstring

A família de fontes que contém o glifo a ser exibido para a ferramenta personalizada.

fontUri
Uri Uri

O URI (Uniform Resource Identifier) que identifica o local da fonte usada para renderizar o glifo.

Retornos

A ferramenta personalizada.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Ao usar essa sobrecarga de método para fazer referência a um glifo de fonte instalado com o pacote appx do aplicativo, seu aplicativo pode exibir uma imagem quebrada quando implantado do Visual Studio. Nesse caso, você deve primeiro criar um pacote de aplicativos (Project-Store-CreateAppPackage>>) e, em seguida, implantar.

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

Aplica-se a