RadialControllerMenuItem.CreateFromIcon Methode

Definition

Erstellt ein benutzerdefiniertes Tool (unter Verwendung der angegebenen Textzeichenfolge und des benutzerdefinierten Symbols) im RadialController-Menü .

public:
 static RadialControllerMenuItem ^ CreateFromIcon(Platform::String ^ displayText, RandomAccessStreamReference ^ icon);
 static RadialControllerMenuItem CreateFromIcon(winrt::hstring const& displayText, RandomAccessStreamReference const& icon);
public static RadialControllerMenuItem CreateFromIcon(string displayText, RandomAccessStreamReference icon);
function createFromIcon(displayText, icon)
Public Shared Function CreateFromIcon (displayText As String, icon As RandomAccessStreamReference) As RadialControllerMenuItem

Parameter

displayText
String

Platform::String

winrt::hstring

Die Textzeichenfolge, die für das benutzerdefinierte Tool angezeigt werden soll.

icon
RandomAccessStreamReference

Das benutzerdefinierte Symbol, 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 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.

Symbole

  • Stellen Sie ein hochwertiges PNG-Bild von 64 x 64 Pixeln bereit (44 x 44 ist die kleinste unterstützte Größe)
  • Stellen Sie sicher, dass der Hintergrund transparent ist.
  • Das Symbol sollte den größten Teil des Bilds ausfüllen.
  • Ein weißes Symbol sollte über eine schwarze Kontur verfügen, damit es im Modus mit hohem Kontrast sichtbar ist.

Gilt für:

Weitere Informationen