RadialControllerMenuItem.CreateFromKnownIcon 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.
Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und des Systemsymbols) im RadialController-Menü .
public:
static RadialControllerMenuItem ^ CreateFromKnownIcon(Platform::String ^ displayText, RadialControllerMenuKnownIcon value);
static RadialControllerMenuItem CreateFromKnownIcon(winrt::hstring const& displayText, RadialControllerMenuKnownIcon const& value);
public static RadialControllerMenuItem CreateFromKnownIcon(string displayText, RadialControllerMenuKnownIcon value);
function createFromKnownIcon(displayText, value)
Public Shared Function CreateFromKnownIcon (displayText As String, value As RadialControllerMenuKnownIcon) As RadialControllerMenuItem
Parameter
- displayText
-
String
Platform::String
winrt::hstring
Die Textzeichenfolge, die für das benutzerdefinierte Tool angezeigt werden soll.
Das Systemsymbol, das für das benutzerdefinierte Tool angezeigt werden soll.
Gibt zurück
Das benutzerdefinierte Tool.
Hinweise
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 Probleme mit Ereignishandlern im UI-Thread verursachen.
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 kennzeichnen (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.