RadialControllerMenuItem.CreateFromKnownIcon Methode

Definition

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.

value
RadialControllerMenuKnownIcon

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.

Gilt für:

Weitere Informationen