RadialControllerMenuItem.CreateFromFontGlyph 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.
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
- CreateFromFontGlyph(String, String, String, Uri)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Interações com o Surface Dial
- Amostras da Plataforma Universal do Windows (C# e C++)
- Exemplo da área de trabalho do Windows
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.
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
- CreateFromFontGlyph(String, String, String)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Interações com o Surface Dial
- Amostras da Plataforma Universal do Windows (C# e C++)
- Exemplo da área de trabalho do Windows