RadialControllerMenuItem.CreateFromFontGlyph Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
CreateFromFontGlyph(String, String, String) |
Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und schriftartenglyphe) im RadialController-Menü . |
CreateFromFontGlyph(String, String, String, Uri) |
Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und schriftartenglyphe) im RadialController-Menü . |
CreateFromFontGlyph(String, String, String)
Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und schriftartenglyphe) im RadialController-Menü .
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
Parameter
- displayText
-
String
Platform::String
winrt::hstring
Die Textzeichenfolge, die für das benutzerdefinierte Tool angezeigt werden soll.
- glyph
-
String
Platform::String
winrt::hstring
Die Schriftart, die für das benutzerdefinierte Tool angezeigt werden soll.
- fontFamily
-
String
Platform::String
winrt::hstring
Die Schriftfamilie, die die Glyphe enthält, die für das benutzerdefinierte Tool angezeigt werden soll.
Gibt zurück
Das benutzerdefinierte Tool.
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)
|
Hinweise
Verwenden Sie diese Methodenüberladung, wenn Sie auf eine Schriftart verweisen, die bereits im System installiert ist. Verwenden Sie andernfalls CreateFromFontGlyph(String displayText, String glyph, String fontFamily, Uri fontUri).
RadialController-Menüvorgänge , einschließlich CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems und TrySelectDefaultMenuItem, sollten im UI-Thread ausgeführt werden. Dies in einem Hintergrundarbeitsthread kann Zu Problemen mit Ereignishandlern im UI-Thread führen.
UX-Richtlinien für Surface Dial empfehlen Folgendes:
-
Text
- Namen sollten kurz sein und in den mittleren Kreis des Radmenüs passen.
- Namen sollten die primäre Aktion eindeutig identifizieren (eine ergänzende Aktion kann impliziert werden)
- „Scrollen“ gibt an, dass beide Drehrichtungen unterstützt werden.
- „Rückgängigmachen“ gibt eine primäre Aktion an, „Wiederholen“ (die ergänzenden Aktion) kann vom Benutzer jedoch problemlos abgeleitet und identifiziert werden.
Weitere Informationen
- CreateFromFontGlyph(String, String, String, Uri)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Surface Dial-Interaktionen
- Universelle Windows-Plattform – Beispiele (C# und C++)
- Windows-Desktopbeispiel
Gilt für:
CreateFromFontGlyph(String, String, String, Uri)
Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und schriftartenglyphe) im RadialController-Menü .
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
Parameter
- displayText
-
String
Platform::String
winrt::hstring
Die Textzeichenfolge, die für das benutzerdefinierte Tool angezeigt werden soll.
- glyph
-
String
Platform::String
winrt::hstring
Die Schriftart, die für das benutzerdefinierte Tool angezeigt werden soll.
- fontFamily
-
String
Platform::String
winrt::hstring
Die Schriftfamilie, die die Glyphe enthält, die für das benutzerdefinierte Tool angezeigt werden soll.
Der URI (Uniform Resource Identifier), der den Speicherort der Schriftart angibt, die zum Rendern der Glyphe verwendet wird.
Gibt zurück
Das benutzerdefinierte Tool.
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)
|
Hinweise
Wenn Sie diese Methodenüberladung verwenden, um auf eine Schriftart zu verweisen, die mit dem appx-Paket Ihrer App installiert ist, zeigt Ihre App möglicherweise ein fehlerhaftes Bild an, wenn sie über Visual Studio bereitgestellt wird. In diesem Fall sollten Sie zunächst ein App-Paket (Project-Store-CreateAppPackage>>) erstellen und dann bereitstellen.
RadialController-Menüvorgänge , einschließlich CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems und TrySelectDefaultMenuItem, sollten im UI-Thread ausgeführt werden. Dies in einem Hintergrundarbeitsthread kann Zu Problemen mit Ereignishandlern im UI-Thread führen.
UX-Richtlinien für Surface Dial empfehlen Folgendes:
-
Text
- Namen sollten kurz sein und in den mittleren Kreis des Radmenüs passen.
- Namen sollten die primäre Aktion eindeutig identifizieren (eine ergänzende Aktion kann impliziert werden)
- „Scrollen“ gibt an, dass beide Drehrichtungen unterstützt werden.
- „Rückgängigmachen“ gibt eine primäre Aktion an, „Wiederholen“ (die ergänzenden Aktion) kann vom Benutzer jedoch problemlos abgeleitet und identifiziert werden.
Weitere Informationen
- CreateFromFontGlyph(String, String, String)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Surface Dial-Interaktionen
- Universelle Windows-Plattform – Beispiele (C# und C++)
- Windows-Desktopbeispiel