RadialControllerMenuItem.CreateFromFontGlyph Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| CreateFromFontGlyph(String, String, String) |
Crea una herramienta personalizada (mediante la cadena de texto y el glifo de fuente especificados) en el menú RadialController . |
| CreateFromFontGlyph(String, String, String, Uri) |
Crea una herramienta personalizada (mediante la cadena de texto y el glifo de fuente especificados) en el menú RadialController . |
CreateFromFontGlyph(String, String, String)
Crea una herramienta personalizada (mediante la cadena de texto y el glifo de fuente especificados) en el menú 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 RadialControllerMenuItemParámetros
- displayText
-
String
Platform::String
winrt::hstring
Cadena de texto que se va a mostrar para la herramienta personalizada.
- glyph
-
String
Platform::String
winrt::hstring
Glifo de fuente que se va a mostrar para la herramienta personalizada.
- fontFamily
-
String
Platform::String
winrt::hstring
Familia de fuentes que contiene el glifo que se va a mostrar para la herramienta personalizada.
Devoluciones
Herramienta personalizada.
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)
|
Comentarios
Use esta sobrecarga de método al hacer referencia a una fuente ya instalada en el sistema. De lo contrario, use CreateFromFontGlyph(String displayText, Glifo de cadena, String fontFamily, Uri fontUri).
Las operaciones de menú RadialController, como CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems y TrySelectDefaultMenuItem, deben realizarse en el subproceso de la interfaz de usuario. Si lo hace en un subproceso de trabajo en segundo plano, puede causar problemas con los controladores de eventos en el subproceso de la interfaz de usuario.
Las directrices de experiencia de usuario para Surface Dial recomiendan lo siguiente:
- Text
- Los nombres deben ser cortos para que quepan dentro del círculo central del menú de rueda.
- Los nombres deben identificar claramente la acción principal (una acción complementaria puede estar implícita)
- El desplazamiento indica el efecto de ambas direcciones de rotación
- La acción de deshacer especifica una acción principal, sin embargo rehacer (la acción complementaria) se puede inferir y el usuario puede descubrirla fácilmente
Consulte también
- CreateFromFontGlyph(String, String, String, Uri)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Interacciones de Surface Dial
- Muestras de la Plataforma universal de Windows (C# y C++)
- Ejemplo de escritorio de Windows
Se aplica a
CreateFromFontGlyph(String, String, String, Uri)
Crea una herramienta personalizada (mediante la cadena de texto y el glifo de fuente especificados) en el menú 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 RadialControllerMenuItemParámetros
- displayText
-
String
Platform::String
winrt::hstring
Cadena de texto que se va a mostrar para la herramienta personalizada.
- glyph
-
String
Platform::String
winrt::hstring
Glifo de fuente que se va a mostrar para la herramienta personalizada.
- fontFamily
-
String
Platform::String
winrt::hstring
Familia de fuentes que contiene el glifo que se va a mostrar para la herramienta personalizada.
Identificador uniforme de recursos (URI) que identifica la ubicación de la fuente utilizada para representar el glifo.
Devoluciones
Herramienta personalizada.
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)
|
Comentarios
Al usar esta sobrecarga de método para hacer referencia a un glifo de fuente instalado con el paquete appx de la aplicación, es posible que la aplicación muestre una imagen interrumpida cuando se implemente desde Visual Studio. En este caso, primero debe crear un paquete de aplicación (Project-Store-CreateAppPackage>>) y, a continuación, implementarlo.
Las operaciones de menú RadialController, como CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems y TrySelectDefaultMenuItem, deben realizarse en el subproceso de la interfaz de usuario. Si lo hace en un subproceso de trabajo en segundo plano, puede causar problemas con los controladores de eventos en el subproceso de la interfaz de usuario.
Las directrices de experiencia de usuario para Surface Dial recomiendan lo siguiente:
- Text
- Los nombres deben ser cortos para que quepan dentro del círculo central del menú de rueda.
- Los nombres deben identificar claramente la acción principal (una acción complementaria puede estar implícita)
- El desplazamiento indica el efecto de ambas direcciones de rotación
- La acción de deshacer especifica una acción principal, sin embargo rehacer (la acción complementaria) se puede inferir y el usuario puede descubrirla fácilmente
Consulte también
- CreateFromFontGlyph(String, String, String)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Interacciones de Surface Dial
- Muestras de la Plataforma universal de Windows (C# y C++)
- Ejemplo de escritorio de Windows
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de