Freigeben über


RadialControllerMenuItem.CreateFromFontGlyph Methode

Definition

Ü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

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.

fontUri
Uri Uri

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

Gilt für: