RadialControllerMenuItem.CreateFromIcon 方法

定义

在 (RadialController 菜单上使用指定的文本字符串和自定义图标) 创建自定义工具。

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

参数

displayText
String

Platform::String

winrt::hstring

要为自定义工具显示的文本字符串。

icon
RandomAccessStreamReference

要为自定义工具显示的自定义图标。

返回

自定义工具。

注解

RadialController 菜单操作(包括 CreateFromKnownIcon、CreateFromIcon、 CreateFromFontGlyphCreateFromFontGlyphResetToDefaultMenuItemsSetDefaultMenuItemsTrySelectDefaultMenuItem)应在 UI 线程上执行。 在后台工作线程中执行此操作可能会导致 UI 线程上的事件处理程序出现问题。

Surface Dial 的 UX 指南建议:

文本

  • 名称应短到足以放入 Wheel 菜单的中心圆圈内
  • 名称应清楚地标识主要操作 (可以隐含补充操作)
  • “滚动”指示两个旋转方向的效果
  • “撤消”指定主要操作,但用户可以推断和轻松地发现“重做”(互补操作)

图标

  • 提供 64 x 64 像素的高质量 PNG 图像(44 x 44 为受支持的最小像素)
  • 确保背景透明
  • 图标应填满图像的大部分
  • 白色图标应具有黑色边框才能在高对比度模式下可见

适用于

另请参阅